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

Operating on an object in a schema requires at least one privilege on the parent database and at least one privilege on the parent schema.

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

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

使用上の注意

  • このコマンドの出力を後処理するには、 パイプ演算子 （->>）または 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, specify SELECT "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.

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