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 포트에 도달할 수 있어야 합니다. 비공개 서비스에 연결하기를 참고하세요.
설정
- Cloud
- Self-host
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을 클릭하세요. 개인 토큰은 생성한 사용자의 권한을 그대로 가지므로, 가능하면 읽기 전용 접근 권한을 가진 사용자로 생성하세요.
3
프로덕션 환경 ID 복사
Orchestration → Environments로 이동해 프로덕션 환경을 클릭하세요. 페이지 URL에서
/environments/ 뒤의 숫자만 복사하세요.4
CloudThinker에 연결 추가
More → Workspace settings → Connections를 열고 dbt를 선택한 뒤 Connect를 클릭하세요. Cloud를 선택하고 연결 세부 정보의 필드를 입력한 뒤 Connect를 클릭하세요.성공 상태: 연결이 Connected 상태로 표시됩니다.
연결 세부 정보
필요 권한
개인 액세스 토큰은 이 권한 세트 대신 해당 사용자의 권한을 가집니다.
에이전트 기능
연결 확인
orders에 데이터를 공급하는 모델과 소스, 그리고 orders로부터 빌드되는 모델이 표시되어야 합니다. 알 수 없는 모델이라는 오류가 나오면 이름이 틀렸거나, 해당 모델이 프로덕션 환경 또는 설정한 브랜치에 없는 것입니다.
예시 프롬프트
쓰기 접근
dbt 연결은 읽기 전용입니다. 에이전트는 dbt Cloud job을 실행, 재시도, 취소할 수 없으며, dbt Core 프로젝트에서 run, build, test, seed, snapshot을 실행할 수 없습니다. CloudThinker는 저장소에 절대 푸시하지 않습니다.문제 해결
The provider rejected these credentials
The provider rejected these credentials
dbt가 토큰을 거부했습니다. Access URL이 계정의 호스트인지, 토큰이 만료되거나 취소되지 않았는지, 서비스 토큰이 Job Viewer와 Metadata Only를 보유하고 있는지 확인하세요. 새 토큰을 생성한 뒤 다시 연결하세요.
모델, 리니지, 지표 질문이 실패함
모델, 리니지, 지표 질문이 실패함
Production environment ID가 틀렸거나 숫자가 아닙니다. 프로덕션 환경 URL에서
/environments/ 뒤의 숫자만 복사하세요.지표 질문에 유용한 답이 나오지 않음
지표 질문에 유용한 답이 나오지 않음
계정에 Semantic Layer가 설정되어 있지 않거나, 토큰에 Semantic Layer Only가 없습니다. job, 모델, 리니지 질문은 이것 없이도 동작합니다.
could not clone the repository; check the URL, branch, username, and token
could not clone the repository; check the URL, branch, username, and token
CloudThinker가 저장소를 읽지 못했습니다. URL이
https://로 시작하는지, 브랜치 또는 태그가 존재하는지, 사용자 이름이 토큰과 일치하는지(GitLab deploy token 자체의 사용자 이름 또는 본인의 GitHub 사용자 이름), 토큰이 해당 저장소를 읽을 수 있는지 확인하세요. URL에 사용자 이름이나 토큰이 포함되어 있다면 제거하고 Repository username과 Repository read token 필드를 사용하세요.dbt_project.yml not found in the project folder
dbt_project.yml not found in the project folder
Project folder를 저장소 루트 기준으로
dbt_project.yml이 있는 폴더(예: analytics)로 설정하세요. 파일이 루트에 있다면 비워 두세요.The tools for this connection took too long to start
The tools for this connection took too long to start
첫 Self-host 연결은 저장소를 클론하고 패키지를 설치하므로 몇 분이 걸릴 수 있습니다. 1분 정도 기다린 뒤 다시 연결하세요.
컴파일 또는 미리보기가 데이터베이스 오류로 실패함
컴파일 또는 미리보기가 데이터베이스 오류로 실패함
CloudThinker가 PostgreSQL에 도달하지 못하거나, 사용자에게 접근 권한이 없습니다. 호스트, 포트, 데이터베이스, 비밀번호를 확인하고, 방화벽이 CloudThinker를 허용하는지, 그리고 사용자가 모델이 읽는 스키마에
USAGE와 SELECT 권한을 가지고 있는지 확인하세요.보안
- 최소 권한 — 에이전트가 사용 사례에 필요한 권한만 부여하세요. 읽기 전용으로 시작한 후 필요에 따라 확장하세요.
- 기본 읽기 전용 — 에이전트가 이 연결을 통해 변경 작업을 수행하게 할 것이 아니라면 읽기 전용 자격증명을 사용하세요.
- 자격증명 교체 — 정기 일정에 따라 키와 토큰을 교체하세요. 연결을 업데이트하면 CloudThinker가 새 값을 자동으로 반영합니다.
- 오프보딩 시 취소 — 연결을 삭제하거나 팀원이 퇴사할 때 프로바이더에서 자격증명을 제거하세요.
- 읽기 전용 웨어하우스 사용자 사용: 미리보기는 이 사용자로
SELECT쿼리를 실행하며, dbt는 컴파일할 때 프로젝트 훅을 실행합니다.USAGE와SELECT만 부여하세요. - 저장소 토큰 범위 제한: 하나의 dbt 저장소만 읽을 수 있는 GitLab deploy token 또는 GitHub fine-grained token을 사용하세요.
관련 항목
PostgreSQL
읽기 전용 사용자로 웨어하우스를 직접 연결합니다.
연결 개요
모든 연결과 CloudThinker가 비공개 서비스에 도달하는 방식을 확인합니다.