SHOW APPLICATION PACKAGES
SHOW APPLICATION PACKAGES
Native Apps Framework에서 전체 계정에 걸쳐 접근 권한이 있는 애플리케이션 패키지(application packages)를 나열하는 명령이에요. 출력은 이름별로 사전식(lexicographic) 순서로 정렬된 애플리케이션 패키지 메타데이터와 속성을 반환해요.
출처: 문서
본문
구문 (Syntax)
SHOW APPLICATION PACKAGES [ 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'하위 절은 "커서" 역할을 해요. 지정된 문자열과 일치하는 객체 이름을 가진 첫 행 다음의 지정된 행 수를 가져올 수 있어요. 문자열은 작은따옴표로 묶어야 하며 대소문자를 구분하고, 전체 객체 이름을 포함할 필요는 없어요(부분 이름 지원). 기본값: 없음.참고:
FROM 'name_string'과STARTS WITH 'name_string'절을 모두 지원하는 SHOW 명령의 경우 같은 문장에서 두 절을 결합할 수 있어요. 그러나 두 조건이 모두 충족되어야 하며, 그렇지 않으면 상쇄되어 결과가 반환되지 않아요. 또한 객체는 이름별 사전식 순서로 반환되므로FROM 'name_string'은STARTS WITH 'name_string'이 반환하는 행보다 사전식 값이 높은 행만 반환해요.
사용 메모 (Usage notes)
- 이 명령은 실행하는 데 실행 중인 웨어하우스가 필요하지 않아요.
- 이 명령은 현재 사용자의 현재 역할에 접근 권한이 하나 이상 부여된 객체만 반환해요.
- MANAGE GRANTS 접근 권한은 보유자가 계정의 모든 객체를 볼 수 있게 암시적으로 허용해요. 기본적으로 계정 관리자(ACCOUNTADMIN)와 보안 관리자(SECURITYADMIN)만 이 권한을 가져요.
- 출력 열 이름은 소문자이므로 출력 열을 참조할 때 큰따옴표로 묶은 식별자를 사용해요(예:
SELECT "type").
출력 (Output)
명령 출력은 다음 열에 애플리케이션 패키지 속성과 메타데이터를 제공해요:
| Column | Description |
|---|---|
| created_on | 애플리케이션 패키지가 생성된 날짜와 시간. |
| name | 애플리케이션 패키지의 이름. |
| is_default | 애플리케이션 패키지가 현재 사용자의 기본 네임스페이스에 있는지 여부. |
| is_current | 애플리케이션 패키지가 현재 세션 컨텍스트에 있는지 여부. |
| distribution | 애플리케이션 패키지의 배포 유형. 유효한 값은 INTERNAL과 EXTERNAL. |
| owner | 애플리케이션 패키지를 소유한 역할. |
| comment | 애플리케이션 패키지에 대한 정보를 제공하는 텍스트. |
| options | 향후 사용을 위해 예약됨. 이 필드는 항상 비어 있음. |
| retention_time | 애플리케이션 패키지의 Time Travel 보존 기간(일). |
| dropped_on | 애플리케이션 패키지가 삭제된 날짜와 시간. 삭제되지 않았으면 NULL. |
| application_class | 내부 사용을 위해 예약됨. |
| multiple_instances | 제공자가 소비자가 앱의 여러 인스턴스를 설치할 수 있게 애플리케이션 패키지를 구성했는지 여부. 유효한 값은 TRUE와 FALSE. |
| type | 애플리케이션 패키지의 유형. 이 값은 항상 NATIVE. |
예시 (Examples)
SHOW APPLICATION PACKAGES;
+-------------------------------+-------------------------+------------+------------+--------------+----------------+----------+---------+----------------+------------+-------------------+-----------+
| created_on | name | is_default | is_current | distribution | owner | comment | options | retention_time | dropped_on | application_class | type |
| 2023-06-02 16:28:31.371 -0700 | hello_snowflake_package | N | N | INTERNAL | ACCOUNTADMIN | | | 1 | NULL | NULL | NATIVE |
+-------------------------------+-------------------------+------------+------------+--------------+----------------+----------+---------+----------------+------------+-------------------+-----------+