dbt login 명령어

dbt login은 한 번 인증해 dbt 도구 전반의 고급 기능을 잠금 해제해요. 브라우저 기반 인증 흐름을 열어 기존 dbt platform 계정으로 로그인하거나 무료 계정을 만들 수 있어요 (신용카드 불필요).

출처: 문서

본문

info dbt v2.0 이상에서 사용할 수 있어요.

커맨드라인에서 dbt login을 실행해 dbt 고급 기능을 잠금 해제하세요. 브라우저 기반 인증이 열리며, 기존 dbt platform 계정으로 로그인하거나 신용카드 없이 무료 계정을 만들 수 있어요! 현재 인증 상태를 보려면 dbt login status를 실행하세요.

dbt login을 언제 쓸까

dbt login은 macOS·Linux·Windows 개발용 인터랙티브 브라우저 기반 로그인 흐름이에요. dbt login으로 잠금 해제할 수 있는 고급 기능:

dbt VS Code 확장의 dbt platform 기능(예: Catalog 탭)
지원되는 버전의 dbt State
v2.0 CLI의 고급 기능

전체 기능과 가용성 목록은 VS Code extension features를 참고하세요.

dbt login은 비인터랙티브 인증을 지원하지 않아요. CI/CD 작업, 예약 작업, 외부 오케스트레이터 같은 비인터랙티브 환경에서는 대신 서비스 토큰을 사용하세요.

로그인 전에

무료 dbt platform 계정은 CLI, VS Code 확장, dbt State 등 모든 dbt 도구에 걸쳐 접근 권한을 전달하므로 한 번만 로그인하면 돼요. 신용카드가 필요 없어요. dbt login을 실행해 무료 계정을 만들거나 기존 계정으로 로그인하세요.

로그인은 단순히 dbt가 로컬 개발 환경에서 고급 기능에 대한 접근을 확인하는 방식이에요. 이는 dbt platform 내에서 무엇을 할 수 있는지 제어하는 dbt platform 사용자 라이선스 유형(예: Developer, Analyst)과는 별개라는 점을 기억하세요.

(dbt v1.13 이상 적용)

dbt State와 함께하는 `dbt login`

dbt login은 dbt State 인증에도 사용돼요. 이 명령어를 실행하면 브라우저 창이 열려 다음을 할 수 있어요: dbt platform 계정으로 로그인. dbt platform 계정 만들기: 이메일 주소를 입력하고 Continue를 클릭. 이름·비밀번호를 입력하고 Terms of Service에 동의. Continue 클릭. 이메일 주소 확인.

dbt v2에서는 플랫폼 인증 후 CLI가 설정을 확인하고 그에 따라 응답해요:

dbt platform에서 dbt State 활성화?	로컬에서 dbt State 활성화?	동작
✅	✅	dbt State를 사용할 준비가 됐어요.
✅	❌	CLI가 로컬에서 dbt State를 활성화하라고 프롬프트해요. 확인하면 `user_settings.yml`이 자동으로 업데이트돼요.
❌	✅	CLI가 플랫폼 계정에서 dbt State를 활성화하라고 프롬프트해요.

인증 방법

dbt login은 인터랙티브 전용이에요. 브라우저 기반 로그인 흐름을 열고 세션을 로컬에 저장해요. 인터랙티브 또는 비인터랙티브 방법으로 dbt에 로그인할 수 있어요.

인터랙티브 인증

로컬의 터미널이나 IDE에서 개발 중이고 브라우저에서 로그인을 완료할 수 있을 때 dbt login을 사용하세요. dbt login을 실행하면 dbt가 브라우저 기반 인증 흐름을 열어요. 인증을 완료하면 dbt는 로그인 상태를 로컬에 저장하고 로그인됐음을 확인해요.

로그인 후 dbt는 로그인 상태로 dbt CLI, VS Code 확장, dbt State 전반의 고급 기능을 잠금 해제할 수 있어요. 세션은 터미널 세션을 걸쳐 활성 상태로 유지되고, dbt는 활성 중에 자동으로 갱신해요. 7일마다 적어도 한 번 dbt를 사용하는 한 로그인 상태를 유지해요. 더 오래 비활성이면 dbt가 dbt login을 다시 실행하라고 프롬프트해요. Staying signed in에서 자세히 알아보세요.

로컬 터미널(dbt platform UI 아님)에서 dbt login을 실행하세요. 예(인터랙티브): dbt login, dbt login status. 브라우저 프롬프트를 완료해 dbt platform 계정으로 로그인하거나 등록하세요.

비인터랙티브 환경

비인터랙티브란 dbt가 브라우저를 열 사람 없이 실행된다는 뜻이에요 — 예: GitHub Actions 워크플로우, cron 작업, 예약된 dbt platform 작업. 별도의 "비인터랙티브 로그인" 명령어는 없어요. 이런 환경에서는 dbt login을 실행하지 마세요. dbt를 처음 쓴다면 인터랙티브 인증부터 시작하세요. dbt 실행을 자동화할 때만 이 섹션의 지침이 필요해요.

서비스 토큰으로 인증

비인터랙티브 환경(예: CI/CD 작업, 예약 작업, Airflow 같은 외부 오케스트레이터)에서는 dbt login 대신 서비스 토큰을 사용하세요. 서비스 토큰은 두 가지 역할을 해요: 실행을 인증하고, 고급 기능에 대한 접근을 잠금 해제해서 로컬에서처럼 파이프라인에서도 동작하게 해요. 인터랙티브 dbt login과 달리 서비스 토큰은 만료되지 않아서 갱신할 게 없어요. 필요하면 dbt platform에서 직접 회전(rotate)하세요.

dbt가 인증하고 접근을 잠금 해제하도록 다음 환경 변수를 설정하세요:

환경 변수	설명
`DBT_CLOUD_ACCOUNT_HOST`	dbt platform 접근 URL(예: `abc123.us1.dbt.com`).
`DBT_CLOUD_ACCOUNT_ID`	dbt platform 계정 ID.
`DBT_CLOUD_TOKEN`	서비스 토큰 값. `Job Runner`, `Job Creator`, `Job Admin`, `Developer`, `Account Admin` 같은 기능 라이선스 접근을 포함한 권한 집합으로 토큰을 만드세요.
`DBT_CLOUD_PROJECT_ID`	dbt platform 프로젝트 ID.

export DBT_CLOUD_ACCOUNT_HOST=abc123.us1.dbt.com
export DBT_CLOUD_ACCOUNT_ID=12345
export DBT_CLOUD_TOKEN=dbtc_xxxxxxxx
export DBT_CLOUD_PROJECT_ID=67890

dbt 도구 간 공유 로그인 방식

dbt login으로 dbt State를 인증하세요. 로그인 흐름은 dbt VS Code 확장에서 시작할 수 있어요:

CLI에서 dbt login을 실행하면 dbt VS Code 확장이 다음 확장 세션에서 그 로그인을 사용해요.
dbt VS Code 확장에서 로그인하면 다음에 인증이 필요한 명령어를 실행할 때 그 로그인을 사용할 수 있어요.

인증이 필요한 명령어·기능을 실행할 때 dbt는 현재 로그인 상태를 확인해요. 로그인되어 있으면 기능이 실행되고, 아니면 dbt가 어떤 기능이 인증을 필요로 하는지 알려주고 dbt login을 실행하라고 프롬프트해요. VS Code 확장 로그인 흐름은 Sign in을 참고하세요.

로그인 유지하기

로그인하면 dbt가 자동으로 로그인 상태를 유지해줘요 — 보통 전혀 신경 쓸 필요가 없어요. 7일마다 적어도 한 번 dbt를 사용하는 한 로그인 상태를 유지해요. 그보다 오래 비활성이면 보안을 위해 다음 세션에서 다시 로그인하라고 할 수 있어요. 접근이 만료되면 dbt login을 실행해 다시 로그인하세요.

아직 dbt 계정이 없나요? dbt login으로 무료 계정을 만드세요 — 전체 기능 세트를 쓰고 확장을 최대한 활용하는 최고의 방법이에요. dbt login을 실행할 준비가 안 됐나요? 문제없어요 — 대부분의 기능은 계속 쓸 수 있어요. 상태가 궁금하면 dbt license info를 실행해 확인하세요.

사용법

dbt login과 함께 사용할 수 있는 명령어와 출력: dbt login, dbt login --help, dbt login status, dbt license info.

터미널에서 dbt login을 실행해 브라우저 기반 인증을 열어요:

dbt login

CLI가 기본 브라우저를 열고 인증 URL을 보여줘요:

Opening your browser to complete login...
→ https://us1.dbt.com/register

If you need to reset your password, complete the reset, then re-run dbt login to finish authenticating.

Waiting for authentication…

로그인·등록 후 dbt는 자격 증명을 로컬 dbt 설정 디렉터리에 저장해요:

macOS와 Linux: ~/.dbt/
Windows: C:\Users\[username]\.dbt\

얼마나 오래 로그인 상태가 유지되는지는 Staying signed in에서 알아보세요. 인증이 성공적으로 완료되면 CLI는 다음을 보여줘요:

Congratulations! You are now signed in.

인증이 실패하면 CLI는 다음을 보여줘요:

Authentication failed. Re-run dbt login to try again.
[Placeholder for user-facing error message on failure reason]

dbt platform 계정이 있다면 같은 계정으로 dbt State를 인증할 수 있어요 — 별도 로그인이 필요 없어요. 전체 dbt State 설정은 Setting up dbt State를 참고하세요.

Usage: dbt login [OPTIONS] <COMMAND>

Commands:
  status   Show dbt authentication status

dbt login status를 실행해 dbt가 인증되었는지 확인하세요:

dbt login status

dbt가 인증되어 있으면 CLI가 인증 방법을 보여줘요:

Status: authenticated (via METHOD)

인증되지 않았으면 CLI가 다음을 보여줘요:

Status: unauthenticated

dbt license info

dbt는 로컬 라이선스로 로그인 상태를 캐시하고 고급 기능에 대한 접근을 제공해요. dbt login status가 인증됐다고 말하는데 고급 기능이 동작하지 않을 때, dbt license info를 추가 검사로 실행해 dbt v2가 사용하는 라이선스 상태를 확인하세요:

dbt license info

출력은 이렇게 생겨야 해요:

dbtf license info
...
status: valid
licensing_enabled: true
license_type: developer
features: compare, state-aware-orchestration, strict-static-analysis
issued_at: June 17, 2026 10:55 UTC
expires_at: June 18, 2026 10:55 UTC

머신 읽기 가능한 출력은 --json을 추가하세요:

dbt license info --json

각 상태 해석 방법은 Troubleshooting을 참고하세요.

문제 해결

고급 기능이 동작하지 않거나 로그인 상태가 확실하지 않으면 dbt license info를 실행해 접근을 확인하세요:

dbt license info

머신 읽기 가능한 출력은 --json을 추가하세요:

dbt license info --json

출력은 현재 상태를 보여줘요. 다음 표로 해석하세요:

상태	의미	해야 할 일
`valid`	로그인되어 있고 기능을 사용할 수 있어요.	없음 — 준비 완료.
`expired`	접근이 만료됐어요.	`dbt login`을 실행해 다시 로그인하세요.
`not_found`	dbt가 로그인을 찾을 수 없어요.	`dbt login`을 실행하거나, 오케스트레이션 실행용 서비스 토큰을 설정하세요.
`invalid`	접근 검증에 실패했어요.	`dbt login`을 실행해 갱신하세요.
`transient_error`	일시적인 네트워크·서버 문제예요.	다시 시도하세요 — 그동안 캐시된 접근은 활성 상태예요.

방금 새 계정을 등록했다면

새 dbt platform 계정을 만들었지만 아직 이메일을 확인하지 않았다면, 짧은 유예 기간 동안 dbt가 매 실행마다 경고해요. 유예 기간이 끝나면 확인할 때까지 고급 기능이 중지돼요. 코드 오류 진단, Jinja LSP go-to ref 정의 등 대부분의 기능은 계속 쓸 수 있어요. 인증 이메일은 받은 편지함을 확인하고, 재전송이 필요하면 dbt Support에 문의하세요.

더 알아보기 (Learn more)

dbt login status — 현재 dbt 인증 상태 표시.
dbt license info — 현재 접근 상태 표시 및 기능 가용성 진단.
dbt init — 첫 프로젝트 설정에 사용; 인증된 기능을 잠금 해제하도록 dbt login 실행을 안내.
dbt deps — dbt 프로젝트용 패키지 설치.
dbt debug — dbt 프로젝트와 연결 설정 테스트.

dbt login 명령어