SHOW VERSIONS IN LISTING

모든 목록 버전을 나열하고 세부 정보를 제공합니다.

참고 항목:

CREATE LISTING, ALTER LISTING, DESCRIBE LISTING, DROP LISTING

구문

SHOW VERSIONS IN LISTING <name>
  [ LIMIT <rows> ]
Copy

매개 변수

name

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

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

LIMIT rows

반환되는 최대 행 수를 선택적으로 제한하는 동시에, 결과의 “페이지 매김”도 활성화합니다. 반환되는 실제 행 수는 지정된 제한보다 적을 수 있습니다. 예를 들어 기존 오브젝트 수가 지정된 제한보다 적습니다.

출력

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

설명

created_on

버전이 생성된 날짜 및 시간입니다.

name

시스템에서 생성된 버전 이름입니다.

alias

사용자가 지정한 버전의 별칭입니다.

location_url

스테이지 작업을 수행할 수 있는 버전 전체 URL 입니다.

is_default

게시된 목록 버전을 식별합니다.

is_live

해당 버전이 목록의 라이브 버전인지 식별합니다.

is_first

해당 버전이 첫 번째 목록 버전인지 식별합니다.

is_last

해당 버전이 마지막 목록 버전인지 식별합니다.

comment

목록 버전에 대한 선택적 설명입니다.

source_location_url

이 버전이 생성된 원본 위치 URL 입니다.

git_commit_hash

버전이 git 원본에서 생성된 경우 git 커밋 해시입니다.

액세스 제어 요구 사항

  • 목록 버전을 표시하려면 목록에 대해 USAGE 또는 OWNERSHIP 권한이 있는 역할을 사용 중이어야 합니다.

사용법 노트

  • LIMIT rows 의 값은 10000 을 초과할 수 없습니다. LIMIT rows 가 생략된 경우 결과 세트의 행 수가 10,000개를 넘는 경우 이 명령을 실행하면 오류가 발생합니다.

    10,000개 이상의 레코드가 있는 결과를 보려면 LIMIT rows 를 포함하거나 Snowflake Information Schema 에서 해당 뷰를 쿼리하십시오.

  • 이 명령의 출력을 사후 처리하려면 출력을 쿼리할 수 있는 테이블로 처리하는 RESULT_SCAN 함수를 사용하면 됩니다. 파이프 연산자 를 사용하여 이 명령의 출력을 쿼리할 수도 있습니다.

MYLISTING 목록의 모든 버전을 표시합니다.

SHOW VERSIONS IN LISTING MYLISTING
Copy
+-----------------------------------+------------------------------+------------------------------+-----------------------------------------------+--------------------+--------------------+--------------------+--------------------+---------------------------------------------+---------------------------------------+---------------------------------------+
|             created_on            |             name             |             alias            |                  location_uri                 |     is_default     |       is_live      |      is_first      |       is_last      |                   comment                   |          source_location_uri          |             git_commit_hash           |
+-----------------------------------+------------------------------+------------------------------+-----------------------------------------------+--------------------+--------------------+--------------------+--------------------+---------------------------------------------+---------------------------------------+---------------------------------------+
|   2025-01-08 11:18:39.921 -0800   |                              |                              |  snow://listing/MYLISTING/versions/live/      |        FALSE       |        TRUE        |        FALSE       |       FALSE        |                                             |            @listingstage              |                                       |
|   2025-01-08 11:18:24.550 -0800   |        VERSION$2             |                              |  snow://listing/MYLISTING/versions/version$2/ |        TRUE        |        FALSE       |        FALSE       |       TRUE         |                                             |            @listingstage              |                                       |
|   2025-01-08 11:17:32.894 -0800   |        VERSION$1             |                              |  snow://listing/MYLISTING/versions/version$1/ |        FALSE       |        FALSE       |        TRUE        |       FALSE        |                                             |            @listingstage              |                                       |
+-----------------------------------+------------------------------+------------------------------+-----------------------------------------------+--------------------+--------------------+--------------------+--------------------+---------------------------------------------+---------------------------------------+---------------------------------------+