dbt Ingest (Semantic Layer ktx)
Ánh xạ models, sources và tests trong schema.yml của dbt thành overlay semantic layer và ghi chú cột trong ktx một cách an toàn.
Dữ liệu · Phân tíchNâng cao★ 1,541⑂ 99Điểm AI 8/10Cập nhật lần cuối: 19 thg 7, 2026
Làm được gì
- Đọc dự án dbt đã upload (
dbt_project.yml,models/**,sources/**,schema.yml) và ánh xạ sang overlay semantic layer (SL) của ktx. - Phân biệt
models:vàsources:(ưu tiênidentifier), chuyểndescriptioncủa cột vàocolumn_overrides[].descriptions.user. - Chuyển các test dbt (
not_null,unique,accepted_values,relationships) thành gợi ý ngắn trong mô tả cột hoặc thànhjoins:khi xác minh được. - Trọng tâm là chống bịa đặt: chỉ dùng tên cột đã xác nhận qua
discover_data,sl_discover,entity_details,sql_execution; nếu không xác nhận được thì chỉ ghi wiki. - Sau mỗi
sl_write_sourcephải gọisl_validate; lỗi tham chiếu cột/measure không tồn tại là điểm dừng bắt buộc.
Phù hợp với ai
- Data engineer đưa dự án dbt lên nền tảng ktx.
- Analytics engineer muốn biến tài liệu/test dbt thành ngữ cảnh mà agent phân tích hiểu được.
- Đội data platform muốn có rào chắn ngăn LLM tự chế tên cột.
Ví dụ sử dụng
- Đọc model
orderstrongmodels/marts/schema.yml, gắn overlay mô tả lên bảng manifest tương ứng và thêm gợi ý "dbt: accepted_values = paid/pending/refunded" cho cộtstatus. - Dùng
identifiertrong khốisources:để tìm đúng bảng vật lý, rồi ghi overlay vào connection kho dữ liệu (postgres-warehouse) thay vì connectiondbt-main. - Khi test
relationshipstrỏ tới bảng không xác minh được bằngentity_details, không tạo join mà ghiemit_unmapped_fallbackcùng ghi chú wiki.
· · · Hướng dẫn cài đặt · · ·
Dùng thử ngay, không cần cài
Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.
Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình: https://raw.githubusercontent.com/Kaelio/ktx/HEAD/packages/cli/src/skills/dbt_ingest/SKILL.md Mình muốn: (viết việc bạn cần ở đây)
Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.
↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục packages/cli/src/skills/dbt_ingest từ repo GitHub Kaelio/ktx vào ~/.claude/skills/dbt-ingest/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/Kaelio/ktx.git /tmp/ktx && mkdir -p ~/.claude/skills/dbt_ingest && cp -r /tmp/ktx/packages/cli/src/skills/dbt_ingest/* ~/.claude/skills/dbt_ingest/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal.
- Clone repo:
git clone https://github.com/Kaelio/ktx.git - Tạo thư mục skill:
mkdir -p ~/.claude/skills/dbt_ingest - Sao chép file:
cp -r ktx/packages/cli/src/skills/dbt_ingest/* ~/.claude/skills/dbt_ingest/ - Khởi động lại Claude Code và kiểm tra
dbt_ingestxuất hiện trong danh sách skill. - Lưu ý: skill gọi các tool riêng của ktx (
sl_write_source,entity_details,discover_data...). Nếu không chạy trong môi trường ktx, các bước sẽ không thực thi được.
Xem mã nguồn trên GitHub ↗Giấy phép: Apache-2.0