DESCRIBE DBT PROJECT

dbt 프로젝트 오브젝트 의 속성을 설명합니다.

DESCRIBE는 DESC로 축약할 수 있습니다.

참고 항목:

CREATE DBT PROJECT, ALTER DBT PROJECT, EXECUTE DBT PROJECT, DROP DBT PROJECT, SHOW DBT PROJECTS

구문

{ DESC | DESCRIBE } DBT PROJECT <name>
Copy

매개 변수

name

설명할 dbt 프로젝트 오브젝트의 식별자를 지정합니다.

식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.

자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.

출력

명령의 출력에는 오브젝트의 속성과 메타데이터를 설명하는 다음 열이 포함됩니다.

열

설명

name

dbt 프로젝트 오브젝트의 식별자(이름)입니다.

owner

dbt 프로젝트 오브젝트를 만드는 데 사용된 역할입니다.

comment

dbt 프로젝트 오브젝트와 연결된 설명입니다.

default_target

기본 실행 대상(예: prod 또는 dev)은 Snowflake를 통해 실행되는 dbt 명령에 사용됩니다.

external_access_integrations

dbt 프로젝트가 dbt 패키지 허브 또는 Github에서 원격 종속성을 가져오는 데 사용할 수 있는 외부 액세스 통합의 이름입니다.

다음 열은 더 이상 사용되지 않는 매개 변수의 값을 제공합니다.

default_version

The version of the dbt project object:

  • LAST: The most recent version of the dbt project object.

  • FIRST: The oldest version of the dbt project object.

default_version_name

VERSION$num 형식의 버전 식별자로, 여기서 num`은 양의 정수입니다(예: :code:`VERSION$1).

dbt 프로젝트 오브젝트를 생성할 때 버전 번호는 :code:`1`에서 시작하고 dbt 프로젝트 오브젝트의 새 버전이 나올 때마다 1씩 증분합니다.

Snowflake는 다음 작업을 수행할 때 버전 식별자를 증분합니다.

  • 작업 공간에서 dbt 프로젝트를 다시 배포합니다(ADD VERSION 옵션을 사용하여 ALTER 명령 실행).

  • ALTER DBT PROJECT 명령을 사용하여 프로젝트 업데이트.

  • --force 옵션 없이 Snow CLI snow dbt deploy 명령 실행.

Snowflake는 버전 식별자를 :code:`1`로 재설정하고 OR REPLACE 옵션을 사용하여 CREATE DBT PROJECT 명령을 실행할 때 모든 버전 별칭을 제거합니다.

default_version_alias

ADD VERSION 옵션을 통해 ALTER DBT PROJECT 명령을 사용하여 dbt 프로젝트 오브젝트의 특정 버전에 대해 생성한 사용자 지정 버전 이름 별칭입니다. 버전 이름 별칭은 항상 특정 버전 식별자(예: VERSION$3)에 매핑됩니다.

default_version_location_uri

기본 버전의 위치 URI입니다. 읽기 전용입니다.

default_version_source_location_uri

Git 오브젝트에 있는 기본 버전 소스 파일의 위치 URI입니다. dbt 프로젝트 오브젝트가 Git 오브젝트에 연결되지 않은 경우 null입니다.

dbt_snowflake_version

The Snowflake version the dbt project object is on.

액세스 제어 요구 사항

이 작업을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.

권한

오브젝트

MONITOR

dbt 프로젝트

스키마의 오브젝트에 대한 작업을 수행하려면 상위 데이터베이스에 대한 하나 이상의 권한과 상위 스키마에 대한 하나 이상의 권한이 필요합니다.

지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.

보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.

사용법 노트

  • 이 명령의 출력을 후처리하기 위해 파이프 연산자 (->>) 또는 RESULT_SCAN 함수를 사용할 수 있습니다. 두 구문 모두 출력을 쿼리할 수 있는 결과 세트로 간주합니다.

    예를 들어, 파이프 연산자 또는 RESULT_SCAN 함수를 사용하여 SHOW 명령 출력에서 특정 열을 선택하거나 행을 필터링할 수 있습니다.

    출력 열을 참조하는 경우 열 이름에 :ref:`큰따옴표로 묶인 식별자<label-delimited_identifier>`를 사용합니다. 예를 들어, 출력 열 ``type``을 선택하려면 ``SELECT “type”``을 지정합니다.

    SHOW 명령의 출력 열 이름은 소문자이므로 큰따옴표로 묶인 식별자를 사용해야 합니다. 큰따옴표는 SELECT 목록 또는 WHERE 절의 열 이름이 스캔된 SHOW 명령 출력과 일치하도록 보장합니다.

예

다음 예제에서는 이름이 my_dbt_project 인 dbt 프로젝트 오브젝트에 대해 설명합니다.

DESCRIBE DBT PROJECT my_dbt_project;
Copy
+----------------+--------------+------------+-------------+-----------------+----------------------+-----------------------+---------------------------------------------------------------+-------------------------------------+-----------------------+----------------+------------------------------+
|      name      |    owner     |  comment   | dbt_version | default_version | default_version_name | default_version_alias | default_version_location_uri                                  | default_version_source_location_uri | dbt_snowflake_version | default_target | external_access_integrations |
+----------------+--------------+------------+-------------+-----------------+----------------------+-----------------------+---------------------------------------------------------------+-------------------------------------+-----------------------+----------------+------------------------------+
| my_dbt_project | ACCOUNTADMIN | My comment | 1.9.4b      | LAST            | VERSION$1            | null                  | snow://dbt/MY_DB.MY_SCHEMA.my_dbt_project/versions/version$1/ | @s1                                 | null                  | dev            | null                         |
+----------------+--------------+------------+-------------+-----------------+----------------------+-----------------------+---------------------------------------------------------------+-------------------------------------+-----------------------+----------------+------------------------------+
언어: 한국어