SHOW VERSIONS IN DBT PROJECT

SHOW VERSIONS IN DBT PROJECT

dbt 프로젝트 객체의 라이브(live) 버전을 표시하는 명령이에요.

출처: 문서

본문

참고: 변경 가능한 라이브 버전으로 마이그레이션되지 않은 객체는 여전히 번호가 매겨진 버전을 나열해요. 라이브 버전 모델과 기존 객체를 마이그레이션하는 방법에 대한 자세한 내용은 Snowflake의 dbt 프로젝트: dbt 프로젝트 객체가 단일 변경 가능한 라이브 버전으로 마이그레이션됨(보류)(dbt project objects migrate to a single mutable live version)과 SYSTEM$MIGRATE_DBT_PROJECT을 참고해요.

dbt 프로젝트 객체의 라이브 버전을 표시해요.

구문

SHOW VERSIONS IN DBT PROJECT <name>
  [ LIMIT <number> ]

매개변수

name

Snowflake 내에서 dbt 프로젝트 객체의 식별자(즉 이름)를 지정하는 문자열이에요. dbt 프로젝트가 생성되는 스키마 내에서 고유해야 해요. 또한 식별자는 알파벳 문자로 시작해야 하고, 전체 식별자 문자열이 큰따옴표로 묶이지 않는 한 공백이나 특수 문자를 포함할 수 없어요(예: "My object"). 큰따옴표로 묶은 식별자는 대소문자를 구분해요. 자세한 내용은 식별자 요건(Identifier requirements)을 참고해요.

LIMIT

선택적으로 반환되는 최대 행 수를 제한해요. 반환되는 실제 행 수는 지정된 제한보다 적을 수 있어요(예: 기존 객체 수가 제한보다 적은 경우). 기본값: 값 없음(출력에 제한이 적용되지 않음).

액세스 제어 요구 사항

이 작업을 실행하는 데 사용되는 역할은 최소한 다음 권한을 가져야 해요:

권한 객체
USAGE dbt 프로젝트 객체
MONITOR dbt 프로젝트 객체
OWNERSHIP dbt 프로젝트 객체

사용 메모

  • 이 명령은 실행에 웨어하우스가 필요하지 않아요.
  • 이 명령은 현재 사용자의 현재 역할에 액세스 권한이 하나 이상 부여된 객체만 반환해요.
  • MANAGE GRANTS 액세스 권한은 보유자에게 계정의 모든 객체를 볼 수 있는 권한을 암묵적으로 부여해요. 기본적으로 계정 관리자(ACCOUNTADMIN 역할)와 보안 관리자(SECURITYADMIN 역할)만 MANAGE GRANTS 권한을 가져요.
  • 이 명령의 출력을 후처리하려면 파이프 연산자(->>)나 RESULT_SCAN 함수를 사용할 수 있어요. 두 구성 모두 출력을 쿼리할 수 있는 결과 집합으로 취급해요. 예를 들어 SHOW 명령 출력에서 특정 컬럼을 선택하거나 행을 필터링할 수 있어요.
  • 출력 컬럼을 참조할 때는 큰따옴표로 묶은 식별자를 사용해요. 예를 들어 type 출력 컬럼을 선택하려면 SELECT "type"이라고 지정해요. SHOW 명령의 출력 컬럼 이름은 소문자이므로 큰따옴표로 묶은 식별자를 사용해야 해요.

출력

명령 출력은 dbt 프로젝트 객체에 대한 테이블 속성과 메타데이터를 다음 컬럼으로 제공해요:

컬럼 설명
created_on dbt 프로젝트 객체가 생성된 날짜와 시각이에요.
name 사용되지 않는(deprecated) 컬럼이에요. 라이브 버전에는 번호가 매겨진 버전 이름이 없으므로 NULL을 반환해요.
alias 사용되지 않는 컬럼이에요. 라이브 버전에는 버전 별칭이 없으므로 NULL을 반환해요.
location_uri dbt 프로젝트 버전의 전체 URL이에요.
is_default 사용되지 않는 컬럼이에요. 라이브 버전에 대해 FALSE를 반환해요.
is_live 이 행이 라이브 버전을 나타냄을 의미하는 TRUE를 반환해요.
is_first 사용되지 않는 컬럼이에요. dbt 프로젝트 객체에는 순서가 있는 번호 매겨진 버전이 없으므로 FALSE를 반환해요.
is_last 사용되지 않는 컬럼이에요. dbt 프로젝트 객체에는 순서가 있는 번호 매겨진 버전이 없으므로 FALSE를 반환해요.
comment dbt 프로젝트에 설정된 주석이에요.
source_location_uri 이 dbt 프로젝트 버전이 생성된 소스 위치 URI예요.
git_commit_hash dbt 프로젝트 버전이 git 소스에서 생성된 경우 git 커밋 해시예요.

예제

my_dbt_project의 라이브 버전 표시:

SHOW VERSIONS IN DBT PROJECT my_dbt_project;

+----------------------------------+------+-------+----------------------------------------------------------------+------------+---------+----------+---------+---------+---------------------+-----------------+
| created_on                       | name | alias | location_uri                                                   | is_default | is_live | is_first | is_last | comment | source_location_uri | git_commit_hash |
+----------------------------------+------+-------+----------------------------------------------------------------+------------+---------+----------+---------+---------+---------------------+-----------------+
| 2026-08-26 10:46:26.349 -0700    | null | null  | snow://dbt/mydb.my_schema.my_dbt_project/versions/live/        | FALSE      | TRUE    | FALSE    | FALSE   | null    | null                | null            |
+----------------------------------+------+-------+----------------------------------------------------------------+------------+---------+----------+---------+---------+---------------------+-----------------+

더 알아보기 (Learn more)