SHOW BACKUPS IN BACKUP SET

バックアップセット内のすべての バックアップ を一覧表示します。

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

CREATE BACKUP SET、 ALTER BACKUP SET、 SHOW BACKUP SETS

構文

SHOW BACKUPS IN BACKUP SET <name>
  [ LIMIT <rows> ]
Copy

パラメーター

name

バックアップセットの識別子を指定します。

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

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

LIMIT rows

オプションで、返される行の最大数を制限すると同時に、結果の「ページネーション」を有効にします。実際に返される行数は、指定された制限より少ない場合があります。例えば、既存のオブジェクトの数が指定された制限より少ないなどです。

デフォルト：値なし（出力に制限は適用されない）

アクセス制御の要件

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

権限

メモ

OWNERSHIP

バックアップセットに含まれるバックアップを表示するには、バックアップセットに対する OWNERSHIP 権限が必要です。

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

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

使用上の注意

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

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

出力

列

説明

created_on

タイムスタンプバックアップが作成されます。

backup_id

Snowflakeが生成したバックアップの識別子。バックアップ ID は、 UUID_STRING 関数によって返される形式の UUID 値です。

backup_set_name

バックアップを含むバックアップセットの名前。

database_name

バックアップセットを含むデータベースの名前。

schema_name

バックアップセットを含むスキーマの名前。

expire_on

バックアップの有効期限が切れたときのタイムスタンプ。

例

バックアップセット t1_backups 内のすべてのバックアップを一覧表示します。

SHOW BACKUPS IN BACKUP SET t1_backups;
Copy

バックアップセット t1_backups 内の最も古いバックアップの作成日とバックアップ ID を表示します。

SHOW BACKUPS IN BACKUP SET t1_backups ->>
  SELECT "created_on", "backup_id" FROM $1
    ORDER BY "created_on" LIMIT 1;
Copy

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

SHOW BACKUPS IN BACKUP SET t1_backups ->>
  SELECT "expire_on", "backup_id" FROM $1
    ORDER BY "expire_on" DESC LIMIT 1;
Copy
言語: 日本語