DESCRIBE APPLICATION

애플리케이션 오브젝트에 대한 정보를 표시합니다.

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

애플리케이션 오브젝트의 마지막 업그레이드의 타임스탬프입니다.

share_events_with_provider

로깅 및 이벤트 공유 가 애플리케이션 오브젝트에 대해 활성화되는지 여부를 나타냅니다.

authorize_telemetry_event_sharing

AUTHORIZE_TELEMETRY_EVENT_SHARING 플래그의 상태입니다.

log_level

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

trace_level

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

effective_log_level

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

effective_trace_level

앱에 대해 활성화된 추적 수준입니다.

debug_mode

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

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

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

previous_version

애플리케이션 오브젝트의 이전 버전 식별자입니다.

previous_patch

설치된 애플리케이션 오브젝트의 이전 패치 번호입니다.

previous_version_state

애플리케이션 오브젝트의 이전 버전 상태입니다.

comment

애플리케이션 오브젝트에 대한 정보를 제공하는 텍스트입니다.

사용법 노트

  • 이 명령의 출력을 사후 처리하려면 출력을 쿼리할 수 있는 테이블로 처리하는 RESULT_SCAN 함수를 사용하면 됩니다.

애플리케이션 오브젝트의 속성을 설명합니다.

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