การสร้างและสร้างเอกสาร dbt

dbt เบื้องต้น

Mike Metzger

Data Engineer

ทำไมต้องทำเอกสาร?

  • แบ่งปันรายละเอียดข้อมูลกับผู้ใช้รายอื่น

 

  • รวมแหล่งเอกสารไว้ในที่เดียว

 

  • บันทึกรายละเอียดการอัปเดต / เปลี่ยนแปลง / ฯลฯ

 

  • สร้างตัวอย่าง ข้อแนะนำการใช้งาน และรายละเอียด SLA

Documents

dbt เบื้องต้น

การสร้างเอกสารใน dbt

  • ระบุเอกสารพร้อมนิยามของโมเดล
  • เพิ่มเอกสารสำหรับคอลัมน์ภายในโมเดลได้
  • แสดง data lineage / DAG โดยอัตโนมัติ
  • บันทึก test / การตรวจสอบความถูกต้อง
  • ดูข้อมูล warehouse ที่สร้างขึ้น
    • ชนิดข้อมูลของคอลัมน์
    • ขนาดข้อมูล
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
    • ควรใช้เฉพาะในเครื่องหรือในสภาพแวดล้อมการพัฒนาเท่านั้น
  • คัดลอกเนื้อหาไปยังบริการ hosting อื่น
    • dbt cloud
    • Amazon S3
    • Nginx / Apache / ฯลฯ

มุมมองเอกสาร dbt

dbt เบื้องต้น

ตัวอย่างเอกสาร

  • ดู
    • โมเดล
    • ข้อมูลคำอธิบาย
    • รายละเอียดคอลัมน์
    • กราฟ lineage

มุมมองเอกสาร dbt

dbt เบื้องต้น

มาฝึกกันเถอะ!

dbt เบื้องต้น

Preparing Video For Download...