메인 콘텐츠로 건너뛰기
dbt를 연결하면 CloudThinker 에이전트가 아무것도 실행하지 않고 실패한 job 실행을 설명하고, 모델 리니지를 추적하며, 모델 상태를 점검하고, 컴파일된 SQL을 읽을 수 있습니다. Cloud 탭은 액세스 토큰으로 dbt Cloud 계정을 연결하고, Self-host 탭은 Git 저장소와 읽기 전용 웨어하우스 사용자로 dbt Core 프로젝트를 연결합니다.
dbt는 아직 정식 출시되지 않았습니다. 사용하려면 CloudThinker에 문의하세요. Self-host는 CloudThinker의 자체 호스팅 배포가 아니라 dbt Core를 의미합니다.

사전 요구사항

  • Cloud: Starter, Enterprise 또는 Enterprise+ 플랜의 dbt 계정과 프로덕션 환경. 지표 관련 질문에는 dbt Semantic Layer 설정도 필요합니다.
  • Self-host: GitLab 또는 GitHub 저장소에 있고 HTTPS로 제공되며 PostgreSQL에 빌드되는 dbt Core 프로젝트. Self-host 탭이 지원하는 웨어하우스는 PostgreSQL뿐입니다.
  • Self-host 네트워크 접근: CloudThinker가 인터넷에서 Git 호스트와 PostgreSQL 포트에 도달할 수 있어야 합니다. 비공개 서비스에 연결하기를 참고하세요.

설정

1

Access URL 복사

dbt에서 Account settings를 열고 Access URLs를 찾으세요. 계정 URL의 호스트를 https:// 없이 복사하세요. 예: cloud.getdbt.com 또는 ab123.us1.dbt.com.CloudThinker는 getdbt.com 및 dbt.com 호스트로만 토큰을 전송합니다. 계정이 다른 도메인을 사용한다면 CloudThinker에 문의하세요.
2

액세스 토큰 생성

생성할 수 있는 토큰은 dbt 플랜에 따라 다릅니다:
  • Enterprise 또는 Enterprise+: Account settings → Service Tokens를 열고 + Create service token을 클릭하세요. Job Viewer와 Metadata Only 권한 세트를 추가하고, 에이전트가 지표 질문에 답해야 한다면 Semantic Layer Only도 추가하세요. Save를 클릭하고 토큰을 복사하세요. dbt는 토큰을 한 번만 보여줍니다.
  • Starter: Account settings → API tokens → Personal tokens를 열고 Create personal access token을 클릭하세요. 개인 토큰은 생성한 사용자의 권한을 그대로 가지므로, 가능하면 읽기 전용 접근 권한을 가진 사용자로 생성하세요.
dbt의 서비스 토큰 및 개인 액세스 토큰 가이드를 참고하세요.
3

프로덕션 환경 ID 복사

Orchestration → Environments로 이동해 프로덕션 환경을 클릭하세요. 페이지 URL에서 /environments/ 뒤의 숫자만 복사하세요.
4

CloudThinker에 연결 추가

More → Workspace settings → Connections를 열고 dbt를 선택한 뒤 Connect를 클릭하세요. Cloud를 선택하고 연결 세부 정보의 필드를 입력한 뒤 Connect를 클릭하세요.성공 상태: 연결이 Connected 상태로 표시됩니다.
저장된 연결을 편집해도 원래 유형은 유지됩니다. 다른 탭을 사용하려면 두 번째 연결을 추가하세요.

연결 세부 정보

필요 권한

개인 액세스 토큰은 이 권한 세트 대신 해당 사용자의 권한을 가집니다.
서비스 토큰에는 위의 권한 세트만, 웨어하우스 사용자에게는 USAGE와 SELECT만 부여하세요. 둘 다 쓰기 권한이나 관리자 권한이 필요 없습니다.

에이전트 기능

연결 확인

orders에 데이터를 공급하는 모델과 소스, 그리고 orders로부터 빌드되는 모델이 표시되어야 합니다. 알 수 없는 모델이라는 오류가 나오면 이름이 틀렸거나, 해당 모델이 프로덕션 환경 또는 설정한 브랜치에 없는 것입니다.

예시 프롬프트

쓰기 접근

dbt 연결은 읽기 전용입니다. 에이전트는 dbt Cloud job을 실행, 재시도, 취소할 수 없으며, dbt Core 프로젝트에서 run, build, test, seed, snapshot을 실행할 수 없습니다. CloudThinker는 저장소에 절대 푸시하지 않습니다.

문제 해결

dbt가 토큰을 거부했습니다. Access URL이 계정의 호스트인지, 토큰이 만료되거나 취소되지 않았는지, 서비스 토큰이 Job Viewer와 Metadata Only를 보유하고 있는지 확인하세요. 새 토큰을 생성한 뒤 다시 연결하세요.
Production environment ID가 틀렸거나 숫자가 아닙니다. 프로덕션 환경 URL에서 /environments/ 뒤의 숫자만 복사하세요.
계정에 Semantic Layer가 설정되어 있지 않거나, 토큰에 Semantic Layer Only가 없습니다. job, 모델, 리니지 질문은 이것 없이도 동작합니다.
CloudThinker가 저장소를 읽지 못했습니다. URL이 https://로 시작하는지, 브랜치 또는 태그가 존재하는지, 사용자 이름이 토큰과 일치하는지(GitLab deploy token 자체의 사용자 이름 또는 본인의 GitHub 사용자 이름), 토큰이 해당 저장소를 읽을 수 있는지 확인하세요. URL에 사용자 이름이나 토큰이 포함되어 있다면 제거하고 Repository username과 Repository read token 필드를 사용하세요.
Project folder를 저장소 루트 기준으로 dbt_project.yml이 있는 폴더(예: analytics)로 설정하세요. 파일이 루트에 있다면 비워 두세요.
첫 Self-host 연결은 저장소를 클론하고 패키지를 설치하므로 몇 분이 걸릴 수 있습니다. 1분 정도 기다린 뒤 다시 연결하세요.
CloudThinker가 PostgreSQL에 도달하지 못하거나, 사용자에게 접근 권한이 없습니다. 호스트, 포트, 데이터베이스, 비밀번호를 확인하고, 방화벽이 CloudThinker를 허용하는지, 그리고 사용자가 모델이 읽는 스키마에 USAGE와 SELECT 권한을 가지고 있는지 확인하세요.

보안

  • 최소 권한 — 에이전트가 사용 사례에 필요한 권한만 부여하세요. 읽기 전용으로 시작한 후 필요에 따라 확장하세요.
  • 기본 읽기 전용 — 에이전트가 이 연결을 통해 변경 작업을 수행하게 할 것이 아니라면 읽기 전용 자격증명을 사용하세요.
  • 자격증명 교체 — 정기 일정에 따라 키와 토큰을 교체하세요. 연결을 업데이트하면 CloudThinker가 새 값을 자동으로 반영합니다.
  • 오프보딩 시 취소 — 연결을 삭제하거나 팀원이 퇴사할 때 프로바이더에서 자격증명을 제거하세요.
  • 읽기 전용 웨어하우스 사용자 사용: 미리보기는 이 사용자로 SELECT 쿼리를 실행하며, dbt는 컴파일할 때 프로젝트 훅을 실행합니다. USAGE와 SELECT만 부여하세요.
  • 저장소 토큰 범위 제한: 하나의 dbt 저장소만 읽을 수 있는 GitLab deploy token 또는 GitHub fine-grained token을 사용하세요.

관련 항목

PostgreSQL

읽기 전용 사용자로 웨어하우스를 직접 연결합니다.

연결 개요

모든 연결과 CloudThinker가 비공개 서비스에 도달하는 방식을 확인합니다.