SHOW SNAPSHOTS IN SNAPSHOT SET

スナップショットセット内のすべての スナップショット をリストします。

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

CREATE SNAPSHOT SET、 ALTER SNAPSHOT SET、 SHOW SNAPSHOT SETS

構文

SHOW SNAPSHOTS IN SNAPSHOT SET <name>
Copy

パラメーター

name

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

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

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

アクセス制御の要件

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

権限

メモ

OWNERSHIP

スナップショットセットに対するOWNERSHIP 権限で、その中に含まれるスナップショットを表示します。

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

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

使用上の注意

  • コマンドは、コマンドを実行するために使用されるロールのアクセス権限によって決定された通り、指定されたオブジェクトタイプに対して 最大 1万件の記録を返します。1万件を超える記録は、フィルターを適用しても返されません。

    1万件を超える記録が存在する結果を表示するには、 Snowflake Information Schema で対応するビュー（存在する場合）をクエリします。

出力

列

説明

created_on

タイムスタンプスナップショットが作成されます。

snapshot_id

Snowflakeが生成したスナップショットの識別子。スナップショット ID は です UUID によって返される形式の値。 UUID_STRING 関数。

snapshot_set_name

スナップショットショットを含むスナップスナップショットセットの名前。

database_name

スナップショットセットを含むデータベースの名前。

schema_name

スナップショットセットを含むスキーマの名前。

expire_on

スナップショットの有効期限が切れたときのタイムスタンプ。

例

スナップショットセット``t1_snapshots`` 内のすべてのスナップショットをリスト:

SHOW SNAPSHOTS IN SNAPSHOT SET t1_snapshots;
Copy

スナップショットセット t1_snapshots の最も古いスナップショットの場合、作成日とスナップショット ID を表示します :

SHOW SNAPSHOTS IN SNAPSHOT SET t1_snapshots ->>
  SELECT "created_on", "snapshot_id" FROM $1
    ORDER BY "created_on" LIMIT 1;
Copy

スナップショット ID を表示して、およびスナップショットセット 内の最終的なスナップショット t1_snapshots が期限切れになる日時を表示します。この例では、スナップショットポリシーにスケジュールが含まれていないか、スナップショットポリシーがスナップショットセットに対して中断されているため、新しいスナップショットがスナップショットセットに追加されていないことを前提としています。スナップショットセットをドロップできるように、既存のスナップショットすべての有効期限が切れるのを待っています。

SHOW SNAPSHOTS IN SNAPSHOT SET t1_snapshots ->>
  SELECT "expire_on", "snapshot_id" FROM $1
    ORDER BY "expire_on" DESC LIMIT 1;
Copy
言語: 日本語