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
- Cloud
- Self-host
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.
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.
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.
Khả năng của agent
Xác minh kết nối
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ố
The provider rejected these credentials
The provider rejected these credentials
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.
Câu hỏi về model, lineage hoặc metric thất bại
Câu hỏi về model, lineage hoặc metric thất bạ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.Câu hỏi về metric không trả về kết quả hữu ích
Câu hỏi về metric không trả về kết quả hữu ích
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ó.
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 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.dbt_project.yml not found in the project folder
dbt_project.yml not found in the project folder
Đặ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.The tools for this connection took too long to start
The tools for this connection took too long to start
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.
Compile hoặc xem trước thất bại với lỗi database
Compile hoặc xem trước thất bại với lỗi database
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
SELECTbằng user này, và dbt chạy hook của project khi compile. Chỉ cấpUSAGEvà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ộ.