DESCRIBE SNAPSHOT

注釈

この操作は現在、 Snowflake’s Support Policy and Service Level Agreement に規定されたService Levelセットの対象外です。

スナップショット のプロパティについて説明します。

DESCRIBE は DESC に短縮できます。

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

CREATE SNAPSHOT、 ALTER SNAPSHOT、 DROP SNAPSHOT、 SHOW SNAPSHOTS

構文

{ DESC | DESCRIBE } SNAPSHOT <name>
Copy

パラメーター

name

説明するスナップショットの識別子を指定します。

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

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

出力

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

列

説明

name

スナップショットの名前。

state

スナップショットの現在のステータスを示す以下の値のいずれか：

  • INITIALIZED: スナップショット作成中です。

  • CREATED: スナップショットが作成され、ボリュームの作成に使用できます。

  • ERROR: スナップショットの作成に失敗しました。

database_name

スナップショットが作成されるデータベース。

schema_name

スナップショットが作成されるスキーマ。

service_name

スナップショットの作成元となる完全修飾サービス名。

volume_name

スナップショットが作成される指定されたサービスインスタンスのボリューム。

instance

サービスインスタンスの ID。

size

スナップショットのサイズ（単位: GB）。

comment

スナップショットについての一般コメント。

owner

スナップショットを所有するロール。

owner_role_type

オブジェクトを所有するロールの型（ROLE または DATABASE_ROLE）。

created_on

スナップショットが作成された日時。

アクセス制御の要件

この SQL コマンドの実行に使用される ロール には、少なくとも次の 権限 が必要です。

権限

オブジェクト

メモ

OWNERSHIP または USAGE

スナップショット

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 権限も必要であることに注意してください。

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

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

使用上の注意

  • このコマンドの出力を後処理するには、 RESULT_SCAN 関数を使用できます。この関数は、出力をクエリ可能なテーブルとして扱います。

例

次の例では、 my_snapshot という名前のスナップショットについて説明します。

DESC SNAPSHOT my_snapshot;
Copy

出力：

+-------------+---------+---------------+-------------+------------------------------------+-------------+----------+------+-----------------+-----------+-----------------+-------------------------------+-------------------------------+
| name        | state   | database_name | schema_name | service_name                       | volume_name | instance | size | comment         | owner     | owner_role_type | created_on                    | updated_on                    |
|-------------+---------+---------------+-------------+------------------------------------+-------------+----------+------+-----------------+-----------+-----------------+-------------------------------+-------------------------------|
| MY_SNAPSHOT | CREATED | TUTORIAL_DB   | DATA_SCHEMA | TUTORIAL_DB.DATA_SCHEMA.MY_SERVICE | block-vol1  | 0        |   10 | updated comment | TEST_ROLE | ROLE            | 2023-12-13 17:06:04.162 -0800 | 2023-12-13 17:06:56.303 -0800 |
+-------------+---------+---------------+-------------+------------------------------------+-------------+----------+------+-----------------+-----------+-----------------+-------------------------------+-------------------------------+
言語: 日本語