SHOW APPLICATIONS

Snowflake Native App Framework のアカウント全体でアクセス権限を持っているアプリケーションオブジェクトをリストします。

出力は、アプリケーションオブジェクトのメタデータとプロパティを、名前の辞書順に返します。これは、提供されたフィルターを使用して結果をフィルターする場合に注意することが重要です。

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

ALTER APPLICATION、 CREATE APPLICATION、 DESCRIBE APPLICATION、 DROP APPLICATION

構文

SHOW APPLICATIONS [ LIKE '<pattern>' ]
  [ STARTS WITH '<name_string>' ]
  [ LIMIT <rows> [ FROM '<name_string>' ] ];
Copy

パラメーター

LIKE 'pattern'

オプションで、オブジェクト名でコマンド出力をフィルタリングします。フィルターは、 SQL ワイルドカード文字（% および _）をサポートする、 大文字と小文字を区別しない パターンマッチングを使用します。

たとえば、次のパターンは 同じ 結果を返します。

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...

. デフォルト: 値なし（フィルタリングは出力に非適用）。

STARTS WITH 'name_string'

オプションで、オブジェクト名の先頭に表示される文字に基づいてコマンド出力をフィルタリングします。文字列は一重引用符で囲む必要があり、 大文字と小文字を区別します。

たとえば、次の文字列は 異なる 結果を返します。

... STARTS WITH 'B' ...
... STARTS WITH 'b' ...

. デフォルト: 値なし（フィルターは出力に適用されない）

LIMIT rows [ FROM 'name_string' ]

オプションで、返される行の最大数を制限すると同時に、結果の「ページネーション」を有効にします。実際に返される行数は、指定された制限より少ない場合があります。例えば、既存のオブジェクトの数が指定された制限より少ないなどです。

オプションの FROM 'name_string' サブ句は、結果の「カーソル」として効果的に機能します。これにより、指定された文字列と一致するオブジェクト名を持つ最初の行に続く指定された行数を取得できます。

  • 文字列は一重引用符で囲む必要があり、 大文字と小文字を区別します。

  • 文字列に完全なオブジェクト名を含める必要はありません。部分的な名前がサポートされています。

デフォルト：値なし（出力に制限は適用されない）

注釈

FROM 'name_string' 句と STARTS WITH 'name_string' 句の両方をサポートする SHOW コマンドの場合、同じステートメントでこれらの両方の句を組み合わせることができます。ただし、両方の条件を満たしている必要があります。そうでない場合、互いにキャンセルされ、結果が返されません。

さらに、オブジェクトは名前の辞書式順序で返されるため、 FROM 'name_string' は、 STARTS WITH 'name_string' によって返される行よりも辞書式の値が大きい行のみを返します。

例:

  • ... STARTS WITH 'A' LIMIT ... FROM 'B' は結果を返しません。

  • ... STARTS WITH 'B' LIMIT ... FROM 'A' は結果を返しません。

  • ... STARTS WITH 'A' LIMIT ... FROM 'AB' は結果を返します（入力文字列に一致する行がある場合）。

出力

コマンド出力では、アプリケーションオブジェクトのプロパティとメタデータが次の列に表示されます。

列

説明

created_on

アプリケーションオブジェクトが作成された日時。

name

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

is_default

アプリケーションオブジェクトがユーザーのデフォルト名前空間にあるかどうかを指定します。

is_current

アプリケーションオブジェクトが現在のセッションコンテキストにあるかどうかを指定します。

source_type

アプリケーションオブジェクトのソースを指定します。有効な値:

  • APPLICATION PACKAGE

  • LISTING

source

アプリケーションオブジェクトの作成に使用したアプリケーションパッケージまたはリストの名前。

owner

アプリケーションオブジェクトの作成に使用したロール。

comment

アプリケーションオブジェクトに関する情報を提供するテキスト。

version

アプリケーションオブジェクトの作成に使用したバージョン識別子。

label

アプリケーションオブジェクトのバージョンラベル。このラベルは、コンシューマーが Snowflake Native App をインストールしたときに表示されます。

patch

アプリケーションオブジェクトの作成に使用したパッチ番号。

options

アプリケーションオブジェクトの場合、このフィールドは常に空白です。

retention_time

アプリケーションオブジェクトの保持時間。

upgrade_status

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

  • 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 列にリストされます。

例

SHOW APPLICATIONS;
Copy
+-------------------------------+------------------------+------------+------------+---------------------+----------------------------+---------------+---------+---------------------+-----------------+-------+---------+----------------+
| created_on                    | name                   | is_default | is_current | source_type         | source                     | owner         | comment | version             | label           | patch | options | retention_time |
|-------------------------------+------------------------+------------+------------+---------------------+----------------------------+---------------+---------+---------------------+-----------------+-------+---------+----------------|
| 2023-02-03 10:14:09.828 -0800 | hello_snowflake_app    | N          | Y          | APPLICATION PACKAGE | hello_snowflake_package    | PROVIDER_ROLE |         | v1                  | Version v1      |     0 |         | 1              |
| 2023-03-22 16:12:40.373 -0700 | PRODUCTION_APP         | Y          | Y          | APPLICATION PACKAGE | hello_snowflake_package    | PROVIDER_ROLE |         | v2                  | Version v2      |     0 |         | 1              |
+-------------------------------+------------------------+------------+------------+---------------------+----------------------------+---------------+---------+---------------------+-----------------+-------+---------+----------------+
言語: 日本語