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`	アプリの最終アップグレードのタイムスタンプ。
`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_after`	プロバイダーがこの時点でアップグレードの開始をスケジュールしていることを示します。ただし、この日時より前にアプリがアップグレードされる場合があります。詳細については、アプリの手動アップグレードをご参照ください。
`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`	アップグレードが失敗した理由（該当する場合）。
`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                            |                               |
+------------------------------------+-------------------------------+