SYSTEM$MIGRATE_DBT_PROJECT

SYSTEM$MIGRATE_DBT_PROJECT 함수는 dbt 프로젝트 객체를 변경 가능한(mutable) 라이브 버전 모델로 마이그레이션해요.

출처: SYSTEM$MIGRATE_DBT_PROJECT

본문

SYSTEM$MIGRATE_DBT_PROJECT 함수는 dbt 프로젝트 객체를 변경 가능한 라이브 버전 모델로 마이그레이션해요.

SYSTEM$MIGRATE_DBT_PROJECT ( '<object_name>' )

이 함수를 호출하는 데 사용되는 역할은 dbt 프로젝트 객체에 대한 OWNERSHIP 권한이 있어야 해요.

스키마의 객체를 운영하려면 부모 데이터베이스에 대한 권한이 하나 이상, 부모 스키마에 대한 권한이 하나 이상 필요해요.

지정된 권한 집합으로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기(Creating custom roles)를 참조해요.

보안 가능한 객체에 대해 SQL 작업을 수행하기 위한 역할 및 권한 부여에 대한 일반적인 정보는 접근 제어 개요(Overview of Access Control)를 참조해요.

이 함수는 계정이 2026_06 동작 변경 번들(behavior change bundle)에 옵트인되었거나 Snowflake 계정 담당자가 별도의 단일 라이브 버전 기능을 활성화한 경우에만 사용할 수 있어요. 옵트인 절차와 객체 생성/교체와 기존 객체 마이그레이션의 차이에 대해 알아보려면 dbt 프로젝트 객체가 단일 변경 가능한 라이브 버전으로 마이그레이션되는 방법을 참조해요.
마이그레이션된 객체는 live라는 단일 변경 가능한 버전을 가져요.
마이그레이션은 dbt 프로젝트 객체의 ID(identity), 권한 부여(grants), 태스크 참조(task references) 및 실행 기록(execution history)을 보존해요.

dbt 프로젝트 객체 analytics_db.dbt_projects.finance_project를 라이브 버전 모델로 마이그레이션해요:

SELECT SYSTEM$MIGRATE_DBT_PROJECT(
  'analytics_db.dbt_projects.finance_project'
);