dbt 명령어 레퍼런스

dbt 명령어 레퍼런스 (dbt Command reference)

다음 도구들을 사용해서 dbt를 실행할 수 있어요: 브라우저의 Studio IDE, 커맨드라인 인터페이스의 dbt 플랫폼 CLI, 또는 셀프 호스팅 dbt(즉 dbt v2 또는 dbt v1). 핵심 차이는 dbt 플랫폼 CLI와 Studio IDE가 dbt 플랫폼의 인프라와 포괄적인 기능을 활용해 dbt 명령의 안전한 병렬 실행을 지원하도록 설계되었다는 점이에요. 반면 dbt v1은 같은 프로세스 안에서 여러 호출(invocation)의 안전한 병렬 실행을 지원하지 않아요.

출처: 문서

본문

병렬 실행 (Parallel execution)

dbt 플랫폼은 데이터 무결성을 해치지 않으면서 효율을 높이는 명령의 동시 실행을 허용해요. 이를 통해 여러 명령을 동시에 실행할 수 있어요. 다만 어떤 명령을 병렬로 실행할 수 있고 어떤 명령은 못 하는지 이해하는 게 중요해요.

반면 dbt는 같은 프로세스 안에서 여러 호출의 안전한 병렬 실행을 지원하지 않으며, 데이터 무결성과 시스템 안정성을 보장하려면 사용자가 동시성을 수동으로 관리해야 해요.

dbt 워크플로를 효율적이면서도 안전하게 만들려면 서로 다른 유형의 dbt 명령을 병렬로 실행할 수 있어요. 예를 들어 dbt build(쓰기 작업)는 dbt parse(읽기 작업)와 안전하게 함께 실행될 수 있어요. 하지만 dbt builddbt run(둘 다 쓰기 작업)을 병렬로 실행할 수는 없어요.

dbt 명령은 읽기 또는 쓰기 명령일 수 있어요:

  • 모두 지원되는 버전에서 사용 가능. --version 플래그를 사용하여 설치된 dbt v1 또는 dbt 플랫폼 CLI 버전을 표시할 수 있어요(Studio IDE에는 해당 없음).

더 알아보기 (Learn more)

  • 각 명령어의 상세는 Command reference 문서의 개별 항목을 참고하세요.
  • Studio IDE에 대해선 dbt Studio 문서를 확인하세요.