SHOW APPLICATIONS
SHOW APPLICATIONS
전체 계정에 걸쳐 접근 권한이 있는 Snowflake Native Apps를 나열하는 명령이에요. 출력은 이름별로 사전식(lexicographic) 순서로 정렬된 앱의 메타데이터와 속성을 반환해요.
출처: 문서
본문
구문 (Syntax)
SHOW APPLICATIONS [ LIKE '<pattern>' ]
[ STARTS WITH '<name_string>' ]
[ LIMIT <rows> [ FROM '<name_string>' ] ];
파라미터
- LIKE 'pattern' — 객체 이름으로 명령 출력을 선택적으로 필터링해요. 대소문자 무시 패턴 매칭을 사용하며 SQL 와일드카드 문자(%와 _)를 지원해요. 기본값: 없음.
- STARTS WITH 'name_string' — 객체 이름 시작 부분의 문자를 기반으로 출력을 필터링해요. 문자열은 작은따옴표로 묶어야 하며 대소문자를 구분해요. 기본값: 없음.
- LIMIT rows [ FROM 'name_string' ] — 반환되는 최대 행 수를 제한하면서 결과의 "페이지네이션"을 가능하게 해요. 선택적
FROM 'name_string'하위 절은 "커서" 역할을 해요. 기본값: 없음.
출력 (Output)
명령 출력은 다음 열에 앱 속성과 메타데이터를 제공해요:
| Column | Description |
|---|---|
| created_on | 앱이 생성된 날짜와 시간. |
| name | 앱의 이름. |
| is_default | 앱이 사용자의 기본 네임스페이스에 있는지 여부. |
| is_current | 앱이 현재 세션 컨텍스트에 있는지 여부. |
| source_type | 앱의 소스를 지정해요. 유효한 값: APPLICATION PACKAGE, LISTING. |
| source | 앱을 만드는 데 사용된 애플리케이션 패키지 또는 리스팅의 이름. |
| owner | 앱을 만드는 데 사용된 역할. |
| comment | 앱에 대한 정보를 제공하는 텍스트. |
| version | 앱을 만드는 데 사용된 버전 식별자. |
| label | 앱의 버전 레이블. 이 레이블은 소비자가 앱을 설치할 때 보여요. |
| patch | 앱을 만드는 데 사용된 패치 번호. |
| options | 앱의 경우 이 필드는 항상 비어 있음. |
| retention_time | 앱의 보존 시간. |
| upgrade_state | 앱의 백그라운드 설치 또는 업그레이드의 현재 상태. |
| disablement_reasons | 앱이 비활성화된 이유. |
| last_upgraded_on | 앱이 마지막으로 업그레이드된 타임스탬프. |
| release_channel_name | 앱을 만드는 데 사용된 릴리스 채널의 이름. 앱이 릴리스 채널에서 만들어지지 않았으면 이 속성의 값은 default. |
| type | 애플리케이션의 유형. 이 값은 항상 NATIVE. |
사용 메모 (Usage notes)
- 이 명령은 실행하는 데 실행 중인 웨어하우스가 필요하지 않아요.
- 이 명령은 현재 사용자의 현재 역할에 접근 권한이 하나 이상 부여된 객체만 반환해요.
- MANAGE GRANTS 접근 권한은 보유자가 계정의 모든 객체를 볼 수 있게 암시적으로 허용해요.
- 출력 열 이름은 소문자이므로 출력 열을 참조할 때 큰따옴표로 묶은 식별자를 사용해요(예:
SELECT "type").
예시 (Examples)
SHOW APPLICATIONS;
+-------------------------------+------------------------+------------+------------+---------------------+----------------------------+---------------+---------+---------------------+-----------------+-------+---------+----------------+---------------+-----------+
| created_on | name | is_default | is_current | source_type | source | owner | comment | version | label | patch | options | retention_time | upgrade_state | type |
|-------------------------------+------------------------+------------+------------+---------------------+----------------------------+---------------+---------+---------------------+-----------------+-------+---------+----------------|---------------+-----------|
| 2023-02-03 10:14:09.828 -0800 | hello_snowflake_app | N | Y | APPLICATION PACKAGE | hello_snowflake_package | PROVIDER_ROLE | | v1 | Version v1 | 0 | | 1 | COMPLETE | NATIVE |
| 2023-03-22 16:12:40.373 -0700 | PRODUCTION_APP | Y | Y | APPLICATION PACKAGE | hello_snowflake_package | PROVIDER_ROLE | | v2 | Version v2 | 0 | | 1 | COMPLETE | NATIVE |
+-------------------------------+------------------------+------------+------------+---------------------+----------------------------+---------------+---------+---------------------+-----------------+-------+---------+----------------+---------------+-----------+