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"}]

Set the account-level default version¶

Account administrators can set a default dbt version for all future dbt project objects created in the account using the DEFAULT_DBT_VERSION account parameter. This lets you opt in to newer versions without requiring users to specify DBT_VERSION in every CREATE DBT PROJECT statement.

ALTER ACCOUNT SET DEFAULT_DBT_VERSION = '1.10.15';

This default version is also used by workspaces to set the initial dbt workspace runtime version.

Individual dbt project objects can still override the account default by specifying DBT_VERSION at creation time, by using ALTER DBT PROJECT, or during each execution with EXECUTE DBT PROJECT.

dbt Core 실행 버전 변경¶

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

ALTER DBT PROJECT my_dbt_project SET DBT_VERSION = '1.10.15';

Create a dbt project object pinned to a version¶

The following example creates a dbt project object pinned to the 1.10.15 dbt version:

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

참고

You can also override the dbt version for a single execution by specifying DBT_VERSION in the EXECUTE DBT PROJECT statement.

자세한 내용과 예제는 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에서는 계속 지원됩니다. 즉, 즉시 업그레이드할 필요가 없으며 선택한 기간 동안 기존 환경을 유지할 수 있습니다.