snapshot-paths

snapshot-paths

스냅샷이 위치한 디렉터리 목록을 지정하는 설정이에요. 기본값은 snapshots 디렉터리예요.

출처: 문서

본문

dbt_project.yml:

snapshot-paths: [directorypath]

정의 (Definition)

스냅샷이 위치한 디렉터리 목록을 선택 사항으로 지정해요.

(dbt v1.9 이상에 적용) dbt v1.9+에서는 최신 YAML 문법으로 정의한다면 스냅샷을 모델과 함께 둘 수 있어요.

기본값 (Default)

기본적으로 dbt는 snapshots 디렉터리에서 스냅샷을 검색해요. 예를 들어 snapshot-paths: ["snapshots"]처럼요.

snapshot-paths에 지정하는 경로는 반드시 dbt_project.yml 파일의 위치를 기준으로 한 상대 경로여야 해요. /Users/username/project/snapshots 같은 절대 경로는 피하세요. 예상치 못한 동작과 결과를 초래할 수 있어요.

  • ✅ Do · 상대 경로 사용: snapshot-paths: ["snapshots"]
  • ❌ Don't · 절대 경로 피하기: snapshot-paths: ["/Users/username/project/snapshots"]

예시 (Examples)

snapshots 대신 archives라는 하위 디렉터리 사용

dbt_project.yml:

snapshot-paths: ["archives"]

더 알아보기 (Learn more)

  • 프로젝트 설정(dbt_project.yml)의 전체 목록은 Project configurations 문서를 참고하세요.
  • 스냅샷은 시간에 따른 레코드 변경 이력을 기록해 점진적으로 타입 2 스타일의 변경 추적을 가능하게 해요.