SHOW VERSIONS IN LISTING¶
모든 목록 버전을 나열하고 세부 정보를 제공합니다.
구문¶
SHOW VERSIONS IN LISTING <name>
[ LIMIT <rows> ]
매개 변수¶
name
목록 식별자(이름)를 지정합니다. 식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.
자세한 내용은 식별자 요구 사항 을 참조하십시오.
LIMIT rows
반환되는 최대 행 수를 선택적으로 제한하는 동시에, 결과의 “페이지 매김”도 활성화합니다. 반환되는 실제 행 수는 지정된 제한보다 적을 수 있습니다. 예를 들어 기존 오브젝트 수가 지정된 제한보다 적습니다.
출력¶
명령의 출력에는 오브젝트의 속성과 메타데이터를 설명하는 다음 열이 포함됩니다.
열 |
설명 |
---|---|
|
버전이 생성된 날짜 및 시간입니다. |
|
시스템에서 생성된 버전 이름입니다. |
|
사용자가 지정한 버전의 별칭입니다. |
|
스테이지 작업을 수행할 수 있는 버전 전체 URL 입니다. |
|
게시된 목록 버전을 식별합니다. |
|
해당 버전이 목록의 라이브 버전인지 식별합니다. |
|
해당 버전이 첫 번째 목록 버전인지 식별합니다. |
|
해당 버전이 마지막 목록 버전인지 식별합니다. |
|
목록 버전에 대한 선택적 설명입니다. |
|
이 버전이 생성된 원본 위치 URL 입니다. |
|
버전이 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
+-----------------------------------+------------------------------+------------------------------+-----------------------------------------------+--------------------+--------------------+--------------------+--------------------+---------------------------------------------+---------------------------------------+---------------------------------------+
| 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 | |
+-----------------------------------+------------------------------+------------------------------+-----------------------------------------------+--------------------+--------------------+--------------------+--------------------+---------------------------------------------+---------------------------------------+---------------------------------------+