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

더 알아보기 (Learn more)