DESCRIBE APPLICATION

Snowflake Native App Framework を使用して作成されたアプリケーションオブジェクトに関する情報を表示します。

DESCRIBE は DESC に短縮できます。

こちらもご参照ください。

ALTER APPLICATION PACKAGECREATE APPLICATION PACKAGEDROP APPLICATION PACKAGESHOW 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

ログおよびイベント共有 がアプリケーションオブジェクトで有効かどうかを示します。

log_level

アプリケーションオブジェクトに設定されているログレベル。

trace_level

アプリケーションオブジェクトに設定されているトレースレベル。

debug_mode

アプリケーションがデバッグモードを使用して作成されたかどうかを示します。

upgrade_state

アプリケーションオブジェクトのバックグラウンドインストールまたはアップグレードの現在の状態。有効な値:

  • INSTALLING: アプリケーションオブジェクトは作成中です。

  • INSTALL_FAILED: アプリケーションオブジェクトの作成に失敗しました。アプリケーションオブジェクトは、ドロップされるまで INSTALL_FAILED の状態を維持します。失敗の理由(ある場合)が 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_reason

アップグレードが失敗した理由(該当する場合)。

previous_version

アプリケーションオブジェクトの前バージョンの識別子。

previous_patch

インストールされているアプリケーションオブジェクトの前パッチ番号。

previous_version_state

アプリケーションオブジェクトの前バージョンの状態。

使用上の注意

  • このコマンドの出力を後処理するには、 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                 | 2023-05-25 08:30:41.520 -0700 |
| last_upgraded_on           |                               |
| share_events_with_provider | 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_reason     | NULL                          |
| previous_version           | NULL                          |
| previous_patch             | 0                             |
| previous_version_state     | COMPLETE                      |
+----------------------------+-------------------------------+