DESCRIBE STORAGE LIFECYCLE POLICY

ストレージライフサイクルポリシー のプロパティを記述します。

DESCRIBE は DESC に短縮できます。

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

CREATE STORAGE LIFECYCLE POLICY、 ALTER STORAGE LIFECYCLE POLICY、 DROP STORAGE LIFECYCLE POLICY、 SHOW STORAGE LIFECYCLE POLICIES

構文

{ DESC | DESCRIBE } STORAGE LIFECYCLE POLICY <policy_name>
Copy

パラメーター

policy_name

記述するポリシーの識別子を指定します。

識別子にスペースまたは特殊文字が含まれる場合は、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

詳細については、 識別子の要件 をご参照ください。

出力

コマンドの出力には、オブジェクトのプロパティとメタデータを説明する以下の列が含まれます。

列

説明

name

ポリシーの名前。

signature

ポリシーが行の有効期限を評価するために使用する列。

return_type

戻り値のデータ型を含む VARCHAR 値。例えば、 BOOLEAN 、 NUMBER 、 ARRAY 、 OBJECT 。

body

行が期限切れかどうかを評価する関数の本文。

archive_tier

アーカイブストレージティア（ COOL または COLD ）。

archive_for_days

有効期限が切れるまでにテーブル行をアーカイブする日数（オプション）。このプロパティが設定されていない場合、値は NULL になります。

アクセス制御の要件

この SQL コマンドの実行に使用される ロール には、 最低 1 つ の次の 権限 が必要です。

権限

オブジェクト

メモ

APPLY STORAGE LIFECYCLE POLICY

アカウント

アカウントのすべてのストレージライフサイクルポリシーで DESC を許可します。

APPLY

ストレージライフサイクルポリシー

ストレージライフサイクルポリシーで DESC を許可します。

OWNERSHIP

ストレージライフサイクルポリシー

OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).

スキーマ内のオブジェクトを操作するには、親データベースの少なくとも1つの権限と、親スキーマの少なくとも1つの権限が必要です。

指定された権限のセットを使用してカスタムロールを作成する手順については、 カスタムロールの作成 をご参照ください。

セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 アクセス制御の概要 をご参照ください。

使用上の注意

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

    たとえば、パイプ演算子または RESULT_SCAN 関数を使用して、 SHOW コマンド出力から特定の列を選択したり、行をフィルター処理したりできます。

    出力列を参照する場合は、列名に 二重引用符で囲まれた識別子 を使用します。たとえば、出力列 type を選択するには、 SELECT "type" を指定します。

    SHOW コマンドの出力列名は小文字のため、二重引用符で囲まれた識別子を使用する必要があります。二重引用符により、 SELECT リストまたは WHERE 句内の列名が、スキャンされた SHOW コマンド出力内の列名と一致することが保証されます。

  • ポリシーのアーカイブストレージを有効にした場合は、コマンド出力の archive_tier プロパティは設定されたアーカイブティア（ COOL または COLD ）を表示します。これは、 ALTER STORAGE LIFECYCLE POLICY を使用して ARCHIVE_FOR_DAYS パラメーターの設定を解除することで、アーカイブポリシーを期限切れポリシーに移行した場合も当てはまります。設定後にアーカイブティアは変更できません。

例

次の例は、 my_storage_lifecycle_policy という名前のストレージライフサイクルポリシーについて説明しています。

DESCRIBE STORAGE LIFECYCLE POLICY example_slp;
Copy

出力:

+-----------------------------+----------------+-------------+------+------------------+
| name                        | signature      | return_type | body | archive_for_days |
|-----------------------------+----------------+-------------+------+------------------|
| MY_STORAGE_LIFECYCLE_POLICY | (ARG1 BOOLEAN) | BOOLEAN     | arg1 |              365 |
+-----------------------------+----------------+-------------+------+------------------+
言語: 日本語