SHOW RELEASE DIRECTIVES¶
アプリケーションパッケージに対して定義されたリリースディレクティブをリストします。
出力は、アプリケーションパッケージ内のリリースディレクティブのメタデータとプロパティを、名前の辞書順に返します。提供されたフィルターを使用して結果をフィルターする場合には、これに注意することが重要です。
- こちらもご参照ください。
ALTER APPLICATION PACKAGE、 CREATE APPLICATION PACKAGE、 DROP APPLICATION PACKAGE、 SHOW APPLICATION PACKAGES
構文¶
SHOW RELEASE DIRECTIVES [ LIKE '<pattern>' ]
IN APPLICATION PACKAGE <name>
[ FOR RELEASE CHANNEL <release_channel> ]
パラメーター¶
nameアプリケーションパッケージの識別子を指定します。
LIKE 'pattern'必要に応じて、アプリケーションパッケージで指定されたバージョン名でコマンド出力をフィルターします。フィルターは、 SQL ワイルドカード文字（
%および_）をサポートする、 大文字と小文字を区別しない パターンマッチングを使用します。たとえば、次のパターンは 同じ 結果を返します。
... LIKE '%v1%' ...... LIKE '%V1%' .... デフォルト: 値なし（フィルタリングは出力に非適用）。
FOR RELEASE CHANNEL release_channel指定されたリリースチャネルに定義されたリリースディレクティブのみを返します。
出力¶
コマンド出力では、次の列にリリースディレクティブのプロパティとメタデータが提供されます。
列 |
説明 |
|---|---|
|
リリースディレクティブの名前を指定します。デフォルトのリリースディレクティブの場合、名前は |
|
ディレクティブのターゲットの型を指定します。可能な値は次のとおりです。
|
|
組織またはアカウントの名前を指定します。デフォルトのリリースディレクティブの値は常に |
|
リリースディレクティブが作成されたタイムスタンプを指定します。 |
|
該当する場合は、アプリケーションのバージョンリテラルを指定します。該当しない場合の値は NULL です。 |
|
該当する場合はアプリケーションバージョンのパッチ番号を指定します。該当しない場合の値は NULL です。 |
|
リリースディレクティブが最後に変更されたときのタイムスタンプを指定します。変更されていない場合は NULL です。 |
|
リリースディレクティブがアップグレードに影響を与えることを許可するSnowflakeリージョンのリストを指定します。この値は、 |
|
今後リリースディレクティブが適用されるSnowflakeリージョンのリストを指定します。アクティブなリージョンでのアップグレードの進捗は、新しいリージョンがアクティベートされる前の一定期間モニターされます。 |
|
現在のリリース・ステータスを指定します。可能な値は次のとおりです。
|
|
リリースディレクティブがデプロイされた日時を指定します。デプロイ中に、あまりにも多くのターゲットリージョンが不健康であると特定された場合、リリースディレクティブは一時的に |
|
リリースディレクティブが属するリリースチャネルを指定します。 |
使用上の注意¶
このコマンドを実行するには、アプリケーションパッケージに対する OWNERSHIP 権限、MANAGE RELEASES 権限、または MANAGE VERSIONS 権限のいずれかが必要です。
このコマンドは、このコマンドを実行するロールに付与された権限に一致するリリースディレクティブの結果を返します。
このコマンドの実行には、稼働中のウェアハウスは必要ありません。
このコマンドは、現在のユーザーの現在のロールに少なくとも1つのアクセス権限が付与されているオブジェクトのみを返します。
MANAGE GRANTS アクセス権限により、所有者はアカウント内のすべてのオブジェクトを暗黙的に参照できます。デフォルトでは、アカウント管理者（ ACCOUNTADMIN ロールを持つユーザー）とセキュリティ管理者（ SECURITYADMIN ロールを持つユーザー）のみが MANAGE GRANTS 権限を持っています。
このコマンドの出力を後処理するには、 パイプ演算子 （
->>）または RESULT_SCAN 関数。どちらのコンストラクトも、出力を クエリできる結果セットとして扱います。For example, you can use the pipe operator or RESULT_SCAN function to select specific columns from the SHOW command output or filter the rows.
When you refer to the output columns, use double-quoted identifiers for the column names. For example, to select the output column
type, specifySELECT "type".You must use double-quoted identifiers because the output column names for SHOW commands are in lowercase. The double quotes ensure that the column names in the SELECT list or WHERE clause match the column names in the SHOW command output that was scanned.
例¶
SHOW RELEASE DIRECTIVES IN APPLICATION PACKAGE hello_snowflake_package;
+---------+-------------+---------------------------------+-------------------------------+---------+-------+-------------------------------+------------------------+--------------------------+----------------+-------------------------------+
| name | target_type | target_name | created_on | version | patch | modified_on | active_regions | pending_regions | release_status | deployed_on |
|---------+-------------+---------------------------------+-------------------------------+---------+-------+-------------------------------+------------------------+--------------------------+----------------+-------------------------------+
| DEFAULT | DEFAULT | NULL | 2023-04-02 14:55:17.304 -0700 | V2 | 0 | 2023-04-02 15:47:08.673 -0700 | PUBLIC.AWS_AP_SOUTH_1 | PUBLIC.AWS_AP_SOUTH_1 | IN PROGRESS | |
| NEW_RD | ACCOUNT | [PROVIDER_DEV.PROVIDER_AWS] | 2023-04-02 16:30:44.443 -0700 | V1 | 1 | 2023-04-03 07:10:42.428 -0700 | ALL | | DEPLOYED | 2023-04-03 07:10:42.428 -0700 | |
+---------+-------------+---------------------------------+-------------------------------+---------+-------+-------------------------------+------------------------+--------------------------+----------------+-------------------------------+