dbt system 명령어

dbt system 명령어

dbt system은 dbt 설치를 관리하기 위한 명령어를 제공해요. v2는 다른 라이브러리에 의존하지 않는 단일 컴파일 바이너리예요. 설치 후엔 pip, brew, Python 환경 없이도 dbt system으로 드라이버를 업데이트·삭제·관리할 수 있어요.

출처: 문서

본문

dbt system update와 dbt system uninstall은 dbt v2의 CDN 설치에서만 지원돼요. Pip, Homebrew 또는 Winget으로 dbt v2를 설치했다면 해당 도구들에서 dbt를 업데이트하거나 삭제해야 해요. dbt v1에는 이에 상응하는 기능이 없어요.

사용법 (Usage)

dbt system <subcommand> [flags]

하위 명령어 (Subcommands)

지원되는 모든 ADBC adapter driver를 미리 설치:

  • dbt system update: CLI 바이너리를 제자리에서 업데이트해요. 기본적으로 최신 안정(stable) 릴리스로 업데이트하며, 명명된 채널이나 특정 버전 번호도 지정할 수 있어요.
dbt system update [flags]

(개발 빌드는 불안정할 수 있어요)

예시

최신 안정 릴리스로 업데이트:

dbt system update

특정 버전으로 업데이트:

dbt system update --version 2.0.1

canary 채널로 업데이트:

dbt system update --version canary
  • dbt system uninstall: 시스템에서 CLI 바이너리를 제거해요. macOS와 Linux에서는 공식 uninstall.sh 스크립트를 다운로드해 실행하고, Windows에서는 현재 프로세스가 종료된 후(실행 중인 실행 파일의 파일 잠금을 해제하기 위해) PowerShell 스크립트가 제거를 처리해요.
dbt system uninstall

이 명령어는 추가 플래그를 받지 않아요.

  • dbt system install-drivers: 지원되는 모든 데이터 플랫폼의 ADBC adapter 드라이버 라이브러리(.dylib, .so, .dll)를 한 번에 내려받아 캐시해요. 보통 dbt는 새 데이터 플랫폼에 대해 명령을 실행할 때 첫 사용 시 드라이버를 다운로드해요. dbt system install-drivers는 오프라인으로 전환하기 전이나 서로 다른 웨어하우스를 대상으로 하는 프로젝트 사이를 오갈 때처럼 캐시를 미리 채우는 데 사용해요.
dbt system install-drivers

이 명령어는 추가 플래그를 받지 않아요.

네트워킹 참고사항: dbt system install-drivers는 https://public.cdn.getdbt.com에서 파일을 내려받아요. 환경에서 아웃바운드 네트워크 접근을 제한한다면 이 엔드포인트를 allowlist에 추가해야 해요. 전체 엔드포인트 목록은 dbt v2 네트워킹 요구사항(dbt v2 networking requirements)을 참고하세요.

  • dbt debug — dbt 프로젝트와 연결 구성을 테스트해요.
  • dbt v2 networking requirements — dbt v2가 요구하는 아웃바운드 엔드포인트를 검토해요.

더 알아보기 (Learn more)