dbt Projects on Snowflake 에 지원되는 dbt Core 버전¶

Snowflake는 안전하고 예측 가능한 실행 환경을 보장하기 위해 dbt 프로젝트를 위한 관리형 런타임을 제공합니다. dbt Core 릴리스에는 주요 변경 사항이나 보안 취약점이 포함될 수 있으므로 Snowflake는 각 버전에 대해 체계적인 수명 주기를 따릅니다. 이 정책을 통해 사용자는 거버넌스 및 재현성을 위해 특정 버전을 고정하는 동시에 필요한 마이그레이션에 대한 명확한 일정을 제공할 수 있습니다.

dbt 프로젝트에 지원되는 버전¶
지원되는 dbt Core 버전	Snowflake 지원 레벨	dbt Labs 지원
1.10.15	활성 지원	Critical support until Jun 15, 2026
1.9.4	활성 지원	Deprecated

DBT_VERSION 매개 변수는 아래 테이블과 같이 버전을 기반으로 실행 엔진을 암시적으로 정의합니다.

버전 기반 엔진 매핑¶
사용자 입력(DBT_VERSION)	조건	결과 엔진
‘1.x’(예: `1.9.4`)	버전 `< 2.0`	dbt Core(Python 기반)

지원되는 dbt Core 버전 보기¶

지원되는 dbt Core 버전을 보려면 다음 예제에서와 같이 SYSTEM$SUPPORTED_DBT_VERSIONS 시스템 함수를 실행합니다.

SELECT SYSTEM$SUPPORTED_DBT_VERSIONS();

[{"dbt_version":"1.9.4","type":"dbt Core"},{"dbt_version":"1.10.15","type":"dbt Core"}]

dbt Core 실행 버전 변경¶

dbt 프로젝트 오브젝트가 실행할 dbt Core 버전을 변경하려면 다음 예제에서와 같이 ALTER DBT PROJECT 명령을 실행합니다.

ALTER DBT PROJECT my_dbt_project SET DBT_VERSION = '1.10.15';

버전에 고정된 dbt 프로젝트 생성¶

다음 예제에서는 1.10.15 dbt 버전에 고정된 dbt 프로젝트를 생성합니다.

CREATE OR REPLACE DBT PROJECT my_dbt_project
  FROM '@my_stage/dbt_files'
  DBT_VERSION = '1.10.15';

자세한 내용과 예제는 CREATE DBT PROJECT 및 ALTER DBT PROJECT 섹션을 참조하세요.

사용 중단 및 폐기 절차¶

Snowflake 지원 버전: 해당 버전은 모든 신규 및 기존 프로젝트에 사용할 수 있습니다. Snowflake는 보안 패치를 포함한 전체 기술 지원을 제공합니다.
Snowflake에서 사용 중단된 버전: 해당 버전은 활성 개발 주기가 종료되었습니다. 기존 프로젝트에서는 완전히 작동하지만, 사용자는 더 이상 사용되지 않는 버전에서 새 프로젝트를 시작하지 않는 것이 좋습니다.
Snowflake에서 폐기된 버전: 해당 버전은 Snowflake 환경에서 공식적으로 제거되었습니다. 이 단계에서는 폐기된 버전에 고정된 모든 프로젝트가 현재 지원되는 버전으로 업데이트될 때까지 실행되지 않습니다.
dbt Core 지원 레벨: `dbt Labs <https://docs.getdbt.com/docs/dbt-versions/core#latest-releases>`_에 따라 버전이 중요 지원, 사용 중단됨 또는 수명 종료 상태에 도달하더라도 Snowflake에서는 계속 지원됩니다. 즉, 즉시 업그레이드할 필요가 없으며 선택한 기간 동안 기존 환경을 유지할 수 있습니다.