SHOW APPLICATIONS

Lists the Snowflake Native Apps that you have access privileges for across your entire account.

The output returns metadata and properties for the app, ordered lexicographically by name. This is important to note if you want to filter the results using the provided filters.

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

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' は結果を返します（入力文字列に一致する行がある場合）。

出力

The command output provides app properties and metadata in the following columns:

列

説明

created_on

Date and time when the app was created.

name

The name of the app.

is_default

Specifies whether the app is in the default namespace for the user.

is_current

Specifies whether the app is in the current session context.

source_type

Specifies the source of the app. The following values are valid:

  • APPLICATION PACKAGE

  • LISTING

source

The name of the application package or listing used to create the app.

owner

The role used to create the app.

comment

Text that provides information about the app.

version

The version identifier used to create the app.

label

The version label of the app. This label is visible to consumers when they install an app.

patch

The patch number used to create the app.

options

For an app, this field is always empty.

retention_time

The retention time of the app.

upgrade_state

The current state of the background installation or upgrade of the app. The following values are valid:

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

disablement_reasons

アプリが無効になった理由。詳細については、 無効化されたアプリ をご参照ください。

last_upgraded_on

The timestamp when the app was last upgraded.

release_channel_name

アプリの作成に使用したリリースチャネルの名前。アプリがリリースチャネルから作成されていない場合、このプロパティの値は default です。

使用上の注意

  • このコマンドの実行には、稼働中のウェアハウスは必要ありません。

  • このコマンドは、現在のユーザーの現在のロールに少なくとも1つのアクセス権限が付与されているオブジェクトのみを返します。

  • MANAGE GRANTS アクセス権限により、所有者はアカウント内のすべてのオブジェクトを暗黙的に参照できます。デフォルトでは、アカウント管理者（ ACCOUNTADMIN ロールを持つユーザー）とセキュリティ管理者（ SECURITYADMIN ロールを持つユーザー）のみが MANAGE GRANTS 権限を持っています。

  • このコマンドの出力を後処理するには、 パイプ演算子 （->>）または RESULT_SCAN 関数。どちらのコンストラクトも、出力を クエリできる結果セットとして扱います。

    このコマンドの出力列名は小文字で生成されます。パイプ演算子または でこのコマンドの結果セットを消費する場合 RESULT_SCAN 関数の場合は、を使用します 二重引用符で囲まれた識別子 クエリの列名に を使用し、スキャンされた出力の列名と一致するようにします。たとえば、出力列の名前が次の場合 type``次に を指定します ``"type" 識別子用。

例

SHOW APPLICATIONS;
Copy
+-------------------------------+------------------------+------------+------------+---------------------+----------------------------+---------------+---------+---------------------+-----------------+-------+---------+----------------+---------------+-----------+
| created_on                    | name                   | is_default | is_current | source_type         | source                     | owner         | comment | version             | label           | patch | options | retention_time | upgrade_state | type      |
|-------------------------------+------------------------+------------+------------+---------------------+----------------------------+---------------+---------+---------------------+-----------------+-------+---------+----------------|---------------+-----------+
| 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              | COMPLETE      | NATIVE    |
| 2023-03-22 16:12:40.373 -0700 | PRODUCTION_APP         | Y          | Y          | APPLICATION PACKAGE | hello_snowflake_package    | PROVIDER_ROLE |         | v2                  | Version v2      |     0 |         | 1              | COMPLETE      | NATIVE    |
+-------------------------------+------------------------+------------+------------+---------------------+----------------------------+---------------+---------+---------------------+-----------------+-------+---------+----------------+---------------+-----------+
言語: 日本語