DESCRIBE APPLICATION

Snowflake Native App 에 대한 정보를 표시합니다.

DESCRIBE는 DESC로 축약할 수 있습니다.

참고 항목:

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

구문

DESC[RIBE] APPLICATION <name>
Copy

매개 변수

name

설명할 앱의 식별자 를 지정합니다.

출력

이 명령은 다음 열에 앱의 속성을 표시합니다.

설명

property

앱의 속성 이름입니다. 이 열에는 다음 표에 나열된 속성이 포함될 수 있습니다.

value

앱의 속성에 할당된 값입니다.

property 열에는 앱의 다음 속성이 포함될 수 있습니다.

속성

설명

name

앱의 이름입니다.

source_organization

앱을 만드는 데 사용된 애플리케이션 패키지가 포함된 계정의 조직 이름입니다.

source_account

앱을 만드는 데 사용된 애플리케이션 패키지의 계정입니다.

source_type

앱을 만드는 데 사용되는 소스입니다. 유효한 값은 APP_PACKAGELISTING 입니다.

source

앱을 만드는 데 사용된 애플리케이션 패키지 또는 목록의 이름입니다.

version

앱의 버전 식별자입니다.

version_label

앱의 버전 레이블입니다. 이 레이블은 컨슈머가 Snowflake Native App 을 설치할 때 컨슈머에게 표시됩니다.

patch

앱의 패치 번호입니다.

created_on

앱이 생성된 타임스탬프입니다.

last_upgraded_on

앱의 마지막 업그레이드 타임스탬프입니다.

restricted_callers_rights

앱에 대해 제한된 호출자의 권한이 활성화되었음을 나타냅니다. 자세한 내용은 앱의 실행 파일에 대한 제한된 호출자 권한 부여하기 섹션을 참조하십시오.

share_events_with_provider

앱에 대해 로깅 및 이벤트 공유 가 활성화되어 있는지 여부를 나타냅니다.

authorize_telemetry_event_sharing

AUTHORIZE_TELEMETRY_EVENT_SHARING 플래그의 상태입니다.

log_level

공급자가 매니페스트 파일에 정의한 로그 수준입니다.

trace_level

공급자가 매니페스트 파일에 정의한 추적 수준입니다.

metric_level

공급자가 매니페스트 파일에 정의한 메트릭 수준입니다.

auditlog_level

공급자가 매니페스트 파일에 정의한 감사 로그 수준입니다.

effective_log_level

앱에 대해 활성화된 로그 수준입니다.

effective_trace_level

앱에 대해 구성된 현재 추적 수준입니다.

effective_metric_level

앱에 대해 구성된 현재 메트릭 수준입니다.

effective_auditlog_level

앱에 대해 구성된 현재 감사 로그 수준입니다.

debug_mode

앱이 디버그 모드를 사용하여 생성되었는지 여부를 나타냅니다.

disable_application_redaction

공급자 데이터 수정이 비활성화되었는지 여부를 나타냅니다.

upgrade_state

앱의 백그라운드 설치 또는 업그레이드의 현재 상태입니다. 유효한 값은 다음과 같습니다.

  • INSTALLING: 애플리케이션 오브젝트가 생성되는 중입니다.

  • INSTALL_FAILED: 애플리케이션 오브젝트 생성에 실패했습니다. 애플리케이션 오브젝트는 삭제될 때까지 INSTALL_FAILED 상태로 유지됩니다. 설치 또는 업그레이드가 실패한 이유에 대한 정보는 DESCRIBE APPLICATION 명령의 UPGRADE_FAILURE_REASON 열을 참조하십시오.

  • COMPLETE: 설정 스크립트가 성공적으로 완료되었으며 애플리케이션 오브젝트가 생성되거나 업그레이드되었습니다.

  • QUEUED: 애플리케이션 오브젝트가 업그레이드를 위해 큐에 대기 중입니다.

  • UPGRADING: 애플리케이션 오브젝트가 업그레이드되는 중입니다.

  • FAILED: 모든 업그레이드 시도가 실패했습니다. 실패 이유는 UPGRADE_FAILURE_REASON 열(있는 경우)에 나열됩니다. 인스턴스는 TARGET_UPGRADE_VERSION 열에 정의된 대로 업그레이드 대상 버전이 아닌 다른 버전을 가리키도록 릴리스 지시어가 업데이트될 때까지 FAILED 상태로 유지됩니다.

  • QUEUED_RETRY: 인스턴스가 하나 이상의 업그레이드 시도에 실패했습니다. 실패 이유는 UPGRADE_FAILURE_REASON 에 표시됨: 인스턴스가 다른 업그레이드 시도를 수행하기 위해 큐에 대기 중입니다.

  • DISABLED: 애플리케이션 오브젝트와 해당 업그레이드가 비활성화되었습니다. 이 상태에서는 컨슈머가 인스턴스에 액세스할 수 없으며 인스턴스의 업그레이드는 고려되지 않으며 애플리케이션 패키지 버전 삭제가 차단되지 않습니다. 실패 이유는 UPGRADE_FAILURE_REASON 열(있는 경우)에 나열됩니다.

upgrade_target_version

앱을 업그레이드할 버전 식별자입니다.

upgrade_target_patch

앱이 업그레이드되는 패치입니다.

upgrade_attempt

앱에 대한 업그레이드가 시도되었는지 여부를 나타냅니다.

upgrade_task_id

업그레이드 시도에 대한 내부 작업 식별자입니다.

upgrade_started_on

업그레이드가 시작된 시점의 타임스탬프입니다.

upgrade_attempted_on

마지막 앱 설치 또는 재시도에 대한 타임스탬프입니다.

upgrade_failure_type

업그레이드 실패 이유. 가능한 값은 다음과 같습니다.

  • VERSION_SETUP: 앱의 설치 스크립트를 실행하는 동안 오류가 발생했음을 나타냅니다. 이는 설치 스크립트에 구문 오류가 있거나 비어 있는 경우 발생할 수 있습니다. 이 오류가 발생하면 공급자에 이메일 알림이 전송됩니다.

  • INTERNAL: 필요한 오브젝트가 응답하지 않거나 찾을 수 없는 경우와 같이 내부 Snowflake 오류를 나타냅니다(예: 필수 오브젝트가 응답하지 않거나 찾을 수 없는 경우).

upgrade_failure_reason

업그레이드가 실패한 이유(해당하는 경우).

upgrade_after

공급자가 현재 업그레이드를 시작하도록 예약했음을 나타냅니다. 그러나 이 날짜 및 시간 이전에 앱을 업그레이드할 수 있습니다. 자세한 내용은 Manually upgrade an app 섹션을 참조하십시오.

upgrade_in_maintenance_window

TRUE 인 경우 Snowpark Container Services 유지 관리 기간 동안 공급자가 앱 업그레이드를 예약했음을 나타냅니다.

이 기능은 현재 미리 보기로 제공됩니다.

previous_version

이전 버전의 앱 식별자입니다.

previous_patch

설치된 앱의 이전 패치 번호입니다.

previous_version_state

이전 버전의 앱 상태입니다.

comment

앱에 대한 정보를 제공하는 텍스트입니다.

disablement_reasons

앱이 비활성화된 이유를 포함하는 배열입니다. 자세한 내용은 앱이 비활성화될 수 있는 이유 섹션을 참조하십시오.

release_channel_name

릴리스 채널의 유형입니다. 유효한 값은 QA, ALPHA, DEFAULT 입니다. 자세한 내용은 릴리스 채널을 사용하여 앱 게시하기 섹션을 참조하십시오.

사용법 노트

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

앱의 속성을 설명합니다.

DESC APPLICATION hello_snowflake_app;
Copy
+------------------------------------+-------------------------------+
| property                           | value                         |
|------------------------------------+-------------------------------|
| name                               | hello_snowflake_app           |
| source_organization                | my_organization               |
| source_account                     | provider_account              |
| source_type                        | APPLICATION PACKAGE           |
| source                             | hello_snowflake_package       |
| version                            | v1_0                          |
| version_label                      | NULL                          |
| patch                              | 0                             |
| created_on                         | 2024-05-25 08:30:41.520 -0700 |
| last_upgraded_on                   |                               |
| share_events_with_provider         | FALSE                         |
| authorize_telemetry_event_sharing  | FALSE                         |
| log_level                          | OFF                           |
| trace_level                        | OFF                           |
| debug_mode                         | FALSE                         |
| upgrade_state                      | COMPLETE                      |
| upgrade_target_version             | NULL                          |
| upgrade_target_patch               | 0                             |
| upgrade_attempt                    | NULL                          |
| upgrade_task_id                    | NULL                          |
| upgrade_started_on                 |                               |
| upgrade_attempted_on               |                               |
| upgrade_failure_type               | NULL                          |
| upgrade_failure_reason             | NULL                          |
| previous_version                   | NULL                          |
| previous_patch                     | 0                             |
| previous_version_state             | COMPLETE                      |
| comment                            |                               |
+------------------------------------+-------------------------------+