SHOW RELEASE DIRECTIVES
SHOW RELEASE DIRECTIVES
애플리케이션 패키지에 정의된 릴리스 지시문(release directive)을 보여 주는 명령이에요. 출력은 이름 기준 사전순으로 정렬된 릴리스 지시문의 메타데이터와 속성을 반환해요. 제공된 필터로 결과를 필터링하려면 이 점을 유의해야 해요.
출처: 문서
본문
기능 — 일반 사용 가능(Generally Available): Snowflake Native App Framework는 지원되는 클라우드 플랫폼에서 일반 사용 가능해요. 자세한 내용은 프라이빗 연결, VPS, 정부 리전 지원을 참고해요.
애플리케이션 패키지에 정의된 릴리스 지시문을 나열해요. 출력은 애플리케이션 패키지 내 릴리스 지시문의 메타데이터와 속성을 이름 기준 사전순으로 반환해요.
구문
SHOW RELEASE DIRECTIVES [ LIKE '<pattern>' ]
IN APPLICATION PACKAGE <name>
[ FOR RELEASE CHANNEL <release_channel> ]
매개변수
- 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_STATUS가 HOLDING이면 무시돼요. |
| pending_regions | 릴리스 지시문이 향후 적용될 Snowflake 리전 목록을 지정해요. 새 리전이 활성화되기 전에 활성 리전의 업그레이드 진행 상황을 일정 기간 모니터링해요. |
| release_status | 현재 릴리스 상태를 지정해요. 가능한 값: IN_PROGRESS(나열된 ACTIVE_REGIONS에서 업그레이드가 진행 중), HOLDING(업그레이드가 일시적으로 중단됨), DEPLOYED(앱이 설치된 모든 리전에서 업그레이드가 허용됨). |
| deployed_on | 릴리스 지시문이 배포된 시각과 날짜를 지정해요. 배포 중 너무 많은 대상 리전이 비정상으로 식별되면 릴리스 지시문이 일시적으로 HOLDING으로 이동해요. |
| release_channel | 릴리스 지시문이 속한 릴리스 채널을 지정해요. |
| upgrade_in_maintenance_window | 업그레이드가 컨슈머 유지 관리 창을 존중하도록 구성되었으면 TRUE, 그렇지 않으면 FALSE예요. |
| upgrade_deadline | 업그레이드를 완료해야 하는 기한이에요. 이 시각 이후에는 컨슈머의 유지 관리 정책과 관계없이 시스템이 자동으로 애플리케이션을 업그레이드해요. |
사용 메모
- 이 명령은 애플리케이션 패키지에 대한 OWNERSHIP 권한, MANAGE RELEASES 권한 또는 MANAGE VERSIONS 권한을 요구해요.
- 명령은 이 명령을 실행하는 역할에 부여된 권한과 일치하는 릴리스 지시문의 결과를 반환해요.
- 이 명령은 실행에 웨어하우스가 필요하지 않아요.
- 이 명령은 현재 사용자의 현재 역할에 액세스 권한이 하나 이상 부여된 객체만 반환해요.
MANAGE GRANTS액세스 권한은 보유자에게 계정의 모든 객체를 볼 수 있는 권한을 암묵적으로 부여해요. 기본적으로 계정 관리자(ACCOUNTADMIN 역할)와 보안 관리자(SECURITYADMIN 역할)만MANAGE GRANTS권한을 가져요.- 이 명령의 출력을 후처리하려면 파이프 연산자(
->>)나RESULT_SCAN함수를 사용할 수 있어요. 두 구성 모두 출력을 쿼리할 수 있는 결과 집합으로 취급해요. 예를 들어 SHOW 명령 출력에서 특정 컬럼을 선택하거나 행을 필터링할 수 있어요. - 출력 컬럼을 참조할 때는 큰따옴표로 묶은 식별자를 사용해요. 예를 들어
type출력 컬럼을 선택하려면SELECT "type"이라고 지정해요. SHOW 명령의 출력 컬럼 이름은 소문자이므로 큰따옴표로 묶은 식별자를 사용해야 해요.
예제
SHOW RELEASE DIRECTIVES IN APPLICATION PACKAGE hello_snowflake_package;
+---------+-------------+---------------------------------+-------------------------------+---------+-------+-------------------------------+------------------------+--------------------------+----------------+-------------------------------+
| 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 | |
+---------+-------------+---------------------------------+-------------------------------+---------+-------+-------------------------------+------------------------+--------------------------+----------------+-------------------------------+