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).

スキーマ内のオブジェクトに対して操作を実行するには、親データベースとスキーマに対する USAGE 権限が必要です。スキーマに対する 任意の権限を付与されたロールは、そのロールがスキーマを解決できることに注意してください。たとえば、スキーマに対するCREATE権限を付与されたロールは、そのスキーマにオブジェクトを作成できますが、そのスキーマに対するUSAGE*も*付与されている必要はありません。

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

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

使用上の注意

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

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

  • ポリシーのアーカイブストレージを有効にした場合は、コマンド出力の 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 |
+-----------------------------+----------------+-------------+------+------------------+
言語: 日本語