dbt 프로젝트 객체와 파일의 번호 버전

⚠️ 이 페이지에서 설명하는 번호 버전(numbered-version) 기능은 2026_06 동작 변경 번들(behavior change bundle)이 완전히 활성화될 때까지만 사용할 수 있어요. 변경 후에는 dbt 프로젝트 객체가 단일 가변 live 버전을 사용하며, 남아 있는 버전 객체는 자동으로 마이그레이션돼요. 자세한 내용은 dbt 프로젝트 객체의 단일 가변 live 버전으로의 마이그레이션 문서를 참조하세요.

Snowflake는 dbt 프로젝트 객체와 그 소스 파일의 불변(immutable) 버전을 유지해요. 이 버전 관리를 통해 개발 수명 주기 전반에 걸쳐 변경 사항을 추적하고 관리할 수 있어요.

📌 dbt 프로젝트 객체 버전은 실행에 사용되는 dbt Core 또는 dbt Fusion 버전과는 별개예요. 자세한 내용은 dbt Projects on Snowflake 지원 dbt 버전 문서를 참조하세요.

Snowflake는 다음 예시처럼 dbt 프로젝트 스테이지에서 dbt 프로젝트 객체 버전을 식별해요.

snow://dbt/my_db.my_schema.my_dbt_project_object/versions/<version_id>

<version_id>는 다음 식별자 중 하나가 될 수 있어요:

식별자	설명
`VERSION$<num>`	`VERSION$<num>` 형태의 버전 식별자를 지정해요. 여기서 `<num>`은 양의 정수예요. 예: `VERSION$1`. dbt 프로젝트 객체를 생성하면 버전 번호가 1부터 시작하며, dbt 프로젝트 객체의 새 버전이 생길 때마다 1씩 증가해요. Snowflake는 다음 작업을 수행할 때 버전 식별자를 증가시켜요: 워크스페이스에서 dbt 프로젝트 재배포(`ADD VERSION` 옵션과 함께 `ALTER` 명령 실행), `ALTER DBT PROJECT` 명령으로 프로젝트 업데이트, Snow CLI의 `snow dbt deploy` 명령 실행. `CREATE DBT PROJECT` 명령을 `OR REPLACE` 옵션과 함께 실행하면 Snowflake는 버전 식별자를 1로 재설정하고 모든 버전 별칭을 제거해요. ⚠️ 새 버전을 만들기 위해 `snow dbt deploy --force`를 사용하지 마세요. `--force`는 `CREATE OR REPLACE DBT PROJECT`를 실행하며, 이는 기존 버전과 실행 기록을 모두 제거해요.
`LAST`	dbt 프로젝트 객체의 가장 최근 버전을 나타내요.
`FIRST`	dbt 프로젝트 객체의 가장 오래된 버전을 나타내요.
`<version_name_alias>`	`ALTER DBT PROJECT` 명령을 `ADD VERSION` 옵션과 함께 실행해 특정 버전에 대해 만든 커스텀 버전 이름 별칭을 나타내요. 버전 이름 별칭은 항상 `VERSION$3` 같은 특정 버전 식별자에 매핑돼요.

dbt 프로젝트 스테이지에 저장된 프로젝트 파일은 버전별로 구성되며, 각 버전은 고유한 하위 디렉터리를 가져요. 예를 들어 버전 식별자가 VERSION$3인 my_dbt_project_object라는 dbt 프로젝트 객체와 dbt_project.yml이라는 dbt 프로젝트 파일은 snow://dbt/my_db.my_schema.my_dbt_project_object/versions/VERSION$3/dbt_project.yml로 참조할 수 있어요.