Chuyển đến nội dung chính
Kết nối dbt để các agent CloudThinker giải thích job run thất bại, truy vết lineage của model, kiểm tra sức khỏe model và đọc SQL đã compile, mà không chạy bất cứ thứ gì. Tab Cloud kết nối một tài khoản dbt Cloud bằng access token, còn tab Self-host kết nối một project dbt Core từ Git repository của project cùng một user warehouse chỉ đọc.
dbt chưa được phát hành rộng rãi. Để sử dụng, hãy liên hệ CloudThinker. Self-host ở đây là dbt Core, không phải bản triển khai tự host của CloudThinker.

Điều kiện tiên quyết

  • Cloud: tài khoản dbt dùng gói Starter, Enterprise hoặc Enterprise+, và một production environment. Câu hỏi về metric còn cần thiết lập dbt Semantic Layer.
  • Self-host: một project dbt Core trong repository GitLab hoặc GitHub, truy cập qua HTTPS, build vào PostgreSQL. PostgreSQL là warehouse duy nhất mà tab Self-host hỗ trợ.
  • Truy cập mạng cho Self-host: CloudThinker phải truy cập được Git host và cổng PostgreSQL của bạn từ internet. Xem Truy cập dịch vụ nội bộ.

Thiết lập

1

Sao chép Access URL

Trong dbt, mở Account settings và tìm Access URLs. Sao chép host trong URL của tài khoản, ví dụ cloud.getdbt.com hoặc ab123.us1.dbt.com, không kèm https://.CloudThinker chỉ gửi token đến các host getdbt.com và dbt.com. Nếu tài khoản của bạn dùng tên miền khác, hãy liên hệ CloudThinker.
2

Tạo access token

Loại token bạn tạo được tùy thuộc vào gói dbt:
  • Enterprise hoặc Enterprise+: mở Account settings → Service Tokens và nhấn + Create service token. Thêm các permission set Job Viewer và Metadata Only, cùng Semantic Layer Only nếu agent cần trả lời câu hỏi về metric. Nhấn Save và sao chép token, vì dbt chỉ hiển thị token một lần.
  • Starter: mở Account settings → API tokens → Personal tokens và nhấn Create personal access token. Personal token mang quyền của người dùng tạo ra nó, nên nếu có thể, hãy tạo token bằng một người dùng chỉ có quyền đọc.
Xem hướng dẫn của dbt về service token và personal access token.
3

Sao chép production environment ID

Vào Orchestration → Environments và nhấn vào production environment của bạn. Chỉ sao chép con số sau /environments/ trong URL của trang.
4

Thêm kết nối trong CloudThinker

Mở More → Workspace settings → Connections, chọn dbt và nhấn Connect. Chọn Cloud, điền các trường trong Chi tiết kết nối, rồi nhấn Connect.Trạng thái thành công: kết nối hiển thị trạng thái Connected.
Khi chỉnh sửa một kết nối đã lưu, loại kết nối ban đầu được giữ nguyên. Để dùng tab còn lại, hãy thêm một kết nối thứ hai.

Chi tiết kết nối

Quyền yêu cầu

Personal access token mang quyền của người dùng tạo ra nó thay cho các permission set này.
Chỉ cấp cho service token các permission set ở trên, và chỉ cấp cho user warehouse USAGE và SELECT. Không bên nào cần quyền ghi hay quyền admin.

Khả năng của agent

Xác minh kết nối

Kết quả mong đợi là các model và source cấp dữ liệu cho orders, cùng các model được build từ nó. Lỗi model không xác định nghĩa là tên sai, hoặc model không nằm trong production environment hay branch bạn đã đặt.

Ví dụ prompt

Quyền ghi

Kết nối dbt chỉ đọc. Agent không thể chạy, chạy lại hoặc hủy job dbt Cloud, và không thể run, build, test, seed hay snapshot một project dbt Core. CloudThinker không bao giờ push vào repository của bạn.

Khắc phục sự cố

dbt từ chối token. Kiểm tra Access URL là host của tài khoản bạn, token chưa hết hạn hoặc bị thu hồi, và service token có Job Viewer và Metadata Only. Tạo token mới và kết nối lại.
Production environment ID sai hoặc không phải là số. Chỉ sao chép con số sau /environments/ trong URL của production environment.
Tài khoản chưa thiết lập Semantic Layer, hoặc token thiếu Semantic Layer Only. Câu hỏi về job, model và lineage vẫn hoạt động khi không có nó.
CloudThinker không đọc được repository. Kiểm tra URL bắt đầu bằng https://, branch hoặc tag tồn tại, username khớp với token (username riêng của GitLab deploy token, hoặc GitHub username của bạn), và token đọc được repository đó. Nếu URL chứa username hoặc token, hãy xóa chúng và dùng các trường Repository username và Repository read token.
Đặt Project folder thành thư mục chứa dbt_project.yml, tính từ thư mục gốc của repository, ví dụ analytics. Để trống khi tệp nằm ở thư mục gốc.
Lần kết nối Self-host đầu tiên clone repository và cài đặt package, việc này có thể mất vài phút. Đợi một phút, rồi kết nối lại.
CloudThinker không truy cập được PostgreSQL, hoặc user thiếu quyền. Kiểm tra host, port, database và mật khẩu, firewall của bạn cho phép CloudThinker, và user có USAGE và SELECT trên các schema mà model của bạn đọc.

Bảo mật

  • Quyền tối thiểu — chỉ cấp các quyền mà agent cần cho trường hợp sử dụng của bạn; bắt đầu với quyền chỉ đọc và mở rộng sau.
  • Chỉ đọc theo mặc định — sử dụng thông tin xác thực chỉ đọc trừ khi bạn muốn agent thực hiện thay đổi qua kết nối này.
  • Xoay vòng thông tin xác thực — xoay vòng khóa và token theo lịch trình thông thường của bạn; CloudThinker sẽ lấy giá trị mới khi bạn cập nhật kết nối.
  • Thu hồi khi bàn giao — xóa thông tin xác thực tại nhà cung cấp khi bạn xóa một kết nối hoặc khi đồng nghiệp rời nhóm.
  • Dùng user warehouse chỉ đọc: bản xem trước chạy truy vấn SELECT bằng user này, và dbt chạy hook của project khi compile. Chỉ cấp USAGE và SELECT.
  • Giới hạn phạm vi token repository: dùng GitLab deploy token hoặc GitHub fine-grained token chỉ đọc được đúng một repository dbt.

Liên quan

PostgreSQL

Kết nối trực tiếp warehouse bằng user chỉ đọc.

Tổng quan kết nối

Xem mọi kết nối và cách CloudThinker truy cập dịch vụ nội bộ.