建立與產生 dbt 文件

dbt 入門

Mike Metzger

Data Engineer

為何要寫文件？

  • 與其他使用者分享資料細節

 

  • 集中管理文件來源

 

  • 提供更新／變更等細節

 

  • 建立範例、使用建議、SLA 詳細資訊

文件

dbt 入門

在 dbt 中建立文件

  • 可在模型定義中提供文件
  • 可為模型內的欄位撰寫說明
  • 自動顯示資料血緣／DAG
  • 紀錄任何測試／驗證
  • 檢視產生的倉儲資訊
    • 欄位資料型別
    • 資料大小
version: 2

models:
  - name: taxi_rides_raw
    description: Yellow Taxi raw data
    access: public
  - name: avg_fare_per_day
    description: Average ride per day
    access: public
dbt 入門

在 dbt 中產生文件

  • dbt docs
    • dbt docs -h
    • dbt docs generate
  • 依專案建立文件網站
  • 應在 dbt run 之後執行
dbt 入門

存取文件

  • 網頁瀏覽器
  • dbt docs serve
    • 僅供本機／開發使用
  • 複製內容到其他託管服務
    • dbt cloud
    • Amazon S3
    • Nginx／Apache／等

dbt 文件檢視

dbt 入門

文件範例

  • 檢視
    • 模型
    • 說明資訊
    • 欄位細節
    • 血緣圖

dbt 文件檢視

dbt 入門

一起來練習吧！

dbt 入門

Preparing Video For Download...