SHOW RELEASE DIRECTIVES

애플리케이션 패키지에 대해 정의된 릴리스 지시문을 나열합니다.

출력은 애플리케이션 패키지의 릴리스 지시문에 대한 메타데이터와 속성을 이름을 기준으로 사전순으로 정렬하여 반환합니다. 제공된 필터를 사용해 결과를 필터링하려는 경우 이 점에 유의해야 합니다.

참고 항목:

ALTER APPLICATION PACKAGE, CREATE APPLICATION PACKAGE, DROP APPLICATION PACKAGE, SHOW APPLICATION PACKAGES

구문

SHOW RELEASE DIRECTIVES [ LIKE '<pattern>' ]
  IN APPLICATION PACKAGE <name>
  [ FOR RELEASE CHANNEL <release_channel> ]
Copy

매개 변수

name

애플리케이션 패키지의 식별자를 지정합니다.

LIKE 'pattern'

선택적으로, 애플리케이션 패키지에 지정된 버전 이름으로 명령 출력을 필터링합니다. 이 필터는 SQL 와일드카드 문자(%_) 지원과 함께 대/소문자를 구분하지 않는 패턴 일치를 사용합니다.

예를 들어, 다음 패턴은 같은 결과를 반환합니다.

... LIKE '%v1%' ...
... LIKE '%V1%' ...

. 기본값: 값 없음(출력에 필터링이 적용되지 않음).

FOR RELEASE CHANNEL release_channel

지정된 릴리스 채널에 대해 정의된 릴리스 지시문만 반환합니다.

출력

명령 출력은 다음 열에 릴리스 지시문 속성 및 메타데이터를 제공합니다.

설명

name

릴리스 지시문의 이름을 지정합니다. 기본 릴리스 지시문의 경우 이름은 DEFAULT 입니다.

target_type

지시문의 대상 유형을 지정합니다. 다음 값을 사용할 수 있습니다.

  • DEFAULT

  • ACCOUNT

target_name

조직 또는 계정의 이름을 지정합니다. 기본 릴리스 지시문의 값은 항상 NULL 입니다.

created_on

릴리스 지시문이 생성된 타임스탬프를 지정합니다.

version

해당되는 경우 애플리케이션 버전 리터럴을 지정합니다. 그렇지 않은 경우 값은 NULL입니다.

patch

해당되는 경우 애플리케이션 버전의 패치 번호를 지정합니다. 그렇지 않은 경우 값은 NULL입니다.

modified_on

릴리스 지시문이 마지막으로 수정된 타임스탬프를 지정하거나 수정되지 않은 경우에는 NULL을 지정합니다.

active_regions

릴리스 지침이 업그레이드에 영향을 미칠 수 있는 Snowflake 리전 목록을 지정합니다. RELEASE_STATUSHOLDING 인 경우 이 값은 무시됩니다.

pending_regions

향후에 릴리스 지시문이 적용될 Snowflake 리전의 목록을 지정합니다. 새 리전이 활성화되기 전 활성 리전의 업그레이드 진행률이 일정 기간 동안 모니터링됩니다.

release_status

현재 릴리스 상태를 지정합니다. 다음 값을 사용할 수 있습니다.

  • IN_PROGRESS: 나열된 ACTIVE_REGIONS 에서 업그레이드가 진행 중입니다.

  • HOLDING: 업그레이드가 일시적으로 중단되었습니다.

  • DEPLOYED: 앱이 설치된 모든 리전에서 업그레이드가 허용됩니다.

deployed_on

릴리스 지침이 배포된 시간과 날짜를 지정합니다. 배포 중에 너무 많은 대상 리전이 비정상 상태로 식별되면 릴리스 지침이 일시적으로 HOLDING 으로 이동합니다.

release_channel

릴리스 지시문이 속한 릴리스 채널을 지정합니다.

사용법 노트

  • 이 명령에는 애플리케이션 패키지에 대한 OWNERSHIP 권한, MANAGE RELEASES 권한 또는 MANAGE VERSIONS 권한이 필요합니다.

  • 이 명령은 이 명령을 실행하는 역할에 부여된 권한과 일치하는 릴리스 지시문의 결과를 반환합니다.

  • 이 명령을 실행하기 위해 실행 중인 웨어하우스가 꼭 필요하지는 않습니다.

  • 이 명령은 현재 사용자의 현재 역할에 하나 이상의 액세스 권한이 부여된 오브젝트만 반환합니다.

  • MANAGE GRANTS 액세스 권한은 그 권한을 보유한 자가 계정에 있는 모든 오브젝트를 볼 수 있도록 암시적으로 허용합니다. 기본적으로, 계정 관리자(ACCOUNTADMIN 역할 이 있는 사용자)와 보안 관리자(SECURITYADMIN 역할이 있는 사용자)만 MANAGE GRANTS 권한을 가집니다.

  • 이 명령의 출력을 후처리하기 위해 파이프 연산자 (->>) 또는 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.

SHOW RELEASE DIRECTIVES IN APPLICATION PACKAGE hello_snowflake_package;
Copy
+---------+-------------+---------------------------------+-------------------------------+---------+-------+-------------------------------+------------------------+--------------------------+----------------+-------------------------------+
| name    | target_type | target_name                     | created_on                    | version | patch | modified_on                   | active_regions         | pending_regions          | release_status | deployed_on                   |
|---------+-------------+---------------------------------+-------------------------------+---------+-------+-------------------------------+------------------------+--------------------------+----------------+-------------------------------+
| DEFAULT | DEFAULT     | NULL                            | 2023-04-02 14:55:17.304 -0700 | V2      |     0 | 2023-04-02 15:47:08.673 -0700 | PUBLIC.AWS_AP_SOUTH_1  | PUBLIC.AWS_AP_SOUTH_1    | IN PROGRESS    |                               |
| NEW_RD  | ACCOUNT     | [PROVIDER_DEV.PROVIDER_AWS]     | 2023-04-02 16:30:44.443 -0700 | V1      |     1 | 2023-04-03 07:10:42.428 -0700 | ALL                    |                          | DEPLOYED       | 2023-04-03 07:10:42.428 -0700 |         |
+---------+-------------+---------------------------------+-------------------------------+---------+-------+-------------------------------+------------------------+--------------------------+----------------+-------------------------------+