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...