dbt belgeleri oluşturma ve üretme

dbt'ye Giriş

Mike Metzger

Data Engineer

Neden belgelendirilmeli?

  • Diğer kullanıcılarla veri ayrıntılarını paylaşma

 

  • Belge kaynaklarını merkezileştirme

 

  • Güncellemeler/değişiklikler vb. için ayrıntı sağlama

 

  • Örnekler, kullanım önerileri, SLA ayrıntıları oluşturma

Belgeler

dbt'ye Giriş

dbt'de belge oluşturma

  • Model tanımlarıyla birlikte belge eklenebilir
  • Modeller içindeki sütunlar hakkında belge eklenebilir
  • Veri soy ağacı/DAG otomatik gösterilir
  • Her test/doğrulama belgelenir
  • Üretilen ambar bilgilerini görüntüleme
    • Sütun veri türleri
    • Veri boyutları
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'ye Giriş

dbt'de belge üretme

  • dbt docs
    • dbt docs -h
    • dbt docs generate
  • Projeye göre belge sitesi oluşturur
  • dbt run sonrasında çalıştırılmalıdır
dbt'ye Giriş

Belgelere erişim

  • Web tarayıcısı
  • dbt docs serve
    • Yalnızca yerelde/geliştirme için kullanılmalıdır
  • İçeriği başka bir barındırma servisine kopyalayın
    • dbt Cloud
    • Amazon S3
    • Nginx / Apache / vb.

dbt belge görünümü

dbt'ye Giriş

Belge örneği

  • Görünüm
    • Modeller
    • Açıklama bilgileri
    • Sütun ayrıntıları
    • Soy ağacı grafikleri

dbt belge görünümü

dbt'ye Giriş

Haydi pratik yapalım!

dbt'ye Giriş

Preparing Video For Download...