SHOW VERSIONS IN LISTING

SHOW VERSIONS IN LISTING

모든 리스팅(listing) 버전을 나열하고 세부 정보를 제공하는 명령이에요.

출처: 문서

본문

모든 리스팅 버전을 나열하고 세부 정보를 제공해요.

구문

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

매개변수

name

리스팅 식별자(이름)를 지정해요. 식별자에 공백이나 특수 문자가 포함되면 전체 문자열을 큰따옴표로 묶어야 해요. 큰따옴표로 묶은 식별자는 대소문자를 구분해요. 자세한 내용은 식별자 요건(Identifier Requirements)을 참고해요.

LIMIT

선택적으로 반환되는 최대 행 수를 제한하면서 결과의 "페이지 매김"도 가능하게 해요. 반환되는 실제 행 수는 지정된 제한보다 적을 수 있어요. 기본값: 값 없음(출력에 제한이 적용되지 않음).

출력

명령 출력은 객체의 속성과 메타데이터를 설명하는 다음 컬럼을 포함해요:

컬럼 설명
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를 생략하면 결과 집합이 1만 행보다 크면 명령이 오류를 일으켜요. 1만 개를 초과하는 결과를 보려면 LIMIT rows를 포함하거나 Snowflake 정보 스키마의 해당 뷰를 쿼리해요.
  • 이 명령의 출력을 후처리하려면 파이프 연산자(->>)나 RESULT_SCAN 함수를 사용할 수 있어요. 두 구성 모두 출력을 쿼리할 수 있는 결과 집합으로 취급해요. 예를 들어 SHOW 명령 출력에서 특정 컬럼을 선택하거나 행을 필터링할 수 있어요.
  • 출력 컬럼을 참조할 때는 큰따옴표로 묶은 식별자를 사용해요. 예를 들어 type 출력 컬럼을 선택하려면 SELECT "type"이라고 지정해요. SHOW 명령의 출력 컬럼 이름은 소문자이므로 큰따옴표로 묶은 식별자를 사용해야 해요.

예제

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              |                                       |
+-----------------------------------+------------------------------+------------------------------+-----------------------------------------------+--------------------+--------------------+--------------------+--------------------+---------------------------------------------+---------------------------------------+---------------------------------------+

더 알아보기 (Learn more)