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 함수를 사용할 수 있습니다. 두 구문 모두 출력을 쿼리할 수 있는 결과 세트로 간주합니다.

    For example, you can use the pipe operator or RESULT_SCAN function to select specific columns from the SHOW command output or filter the rows.

    When you refer to the output columns, use double-quoted identifiers for the column names. For example, to select the output column type, specify SELECT "type".

    You must use double-quoted identifiers because the output column names for SHOW commands are in lowercase. The double quotes ensure that the column names in the SELECT list or WHERE clause match the column names in the SHOW command output that was scanned.

예

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              |                                       |
+-----------------------------------+------------------------------+------------------------------+-----------------------------------------------+--------------------+--------------------+--------------------+--------------------+---------------------------------------------+---------------------------------------+---------------------------------------+
언어: 한국어