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`: インスタンスは1つ以上のアップグレード試行に失敗しました。失敗の理由は `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                            |                               |
+------------------------------------+-------------------------------+