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_PACKAGE 및 LISTING 입니다.

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

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

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 함수를 사용할 수 있습니다. 두 구문 모두 출력을 쿼리할 수 있는 결과 세트로 간주합니다.

    이 명령의 출력 열 이름은 소문자로 생성됩니다. 파이프 연산자 또는 RESULT_SCAN 함수와 함께 이 명령의 결과 세트를 사용하는 경우 쿼리의 열 이름에 큰따옴표로 묶인 식별자 를 사용하여 스캔된 출력의 열 이름과 일치하도록 합니다. 예를 들어, 출력 열의 이름이 type 인 경우 식별자에 대해 "type" 을 지정합니다.

예

앱의 속성을 설명합니다.

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                            |                               |
+------------------------------------+-------------------------------+
언어: 한국어