SHOW BACKUP SETS

アクセス権限を持っているすべての バックアップ セットをリストします。このコマンドのスコープは、アカウント全体または指定されたデータベースまたはスキーマです。

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

CREATE BACKUP SET、 ALTER BACKUP SET、 DROP BACKUP SET

構文

SHOW BACKUP SETS
   [ LIKE '<pattern>' ]
   [ IN { ACCOUNT | DATABASE | DATABASE <db_name> | SCHEMA | SCHEMA <schema_name> }
     [ STARTS WITH '<name_string>' ]
     [ LIMIT <rows> ]
   ]
Copy

パラメーター

LIKE 'pattern'

オプションで、オブジェクト名でコマンド出力をフィルタリングします。フィルターは、 SQL ワイルドカード文字（% および _）をサポートする、 大文字と小文字を区別しない パターンマッチングを使用します。

たとえば、次のパターンは 同じ 結果を返します。

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...

. デフォルト: 値なし（フィルタリングは出力に非適用）。

[ IN ... ]

オプションで、コマンドのスコープを指定します。次のいずれかを指定します。

キーワード ACCOUNT を指定すると、コマンドは、現在のアカウントのデータベースすべてにあるすべてのスキーマの記録を取得します。

キーワード DATABASE を指定すると、次のようになります。

  • db_name を指定すると、コマンドは、指定されたデータベースのスキーマすべての記録を取得します。

  • :samp:`{db_name}`を指定しない場合、以下のようになります：

    • 現在のデータベースがある場合、コマンドは、現在のデータベースにあるスキーマすべての記録を取得します。

    • 現在のデータベースがない場合、コマンドは、アカウントにあるすべてのデータベースとスキーマの記録を取得します。

キーワード SCHEMA を指定すると、次のようになります。

  • 修飾されたスキーマ名（例: my_database.my_schema）を指定すると、コマンドは、指定されたデータベースとスキーマの記録を取得します。

  • 修飾されていない schema_name を指定すると、次のようになります。

    • 現在のデータベースがある場合、コマンドは、現在のデータベースにある指定されたスキーマの記録を取得します。

    • 現在のデータベースがない場合、コマンドは、エラー SQL compilation error: Object does not exist, or operation cannot be performed を表示します。

  • :samp:`{schema_name}`を指定しない場合、以下のようになります：

    • 現在のデータベースがある場合は、次のようになります。

      • 現在のスキーマがある場合、コマンドは、現在のデータベースにある現在のスキーマの記録を取得します。

      • 現在のスキーマがない場合、コマンドは、現在のデータベースにあるスキーマすべての記録を取得します。

    • 現在のデータベースがない場合、コマンドは、アカウントにあるすべてのデータベースとすべてのスキーマの記録を取得します。

STARTS WITH 'name_string'

オプションで、オブジェクト名の先頭に表示される文字に基づいてコマンド出力をフィルタリングします。文字列は一重引用符で囲む必要があり、 大文字と小文字を区別します。

たとえば、次の文字列は 異なる 結果を返します。

... STARTS WITH 'B' ...
... STARTS WITH 'b' ...

. デフォルト: 値なし（フィルターは出力に適用されない）

LIMIT rows

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

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

使用上の注意

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

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

出力

列

説明

created_on

バックアップセットが作成されたときのタイムスタンプ。

name

バックアップセットの名前。

database_name

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

schema_name

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

object_kind

バックアップセットがバックアップするオブジェクトの型。

object_name

バックアップセットがバックアップするオブジェクトの名前。

object_database_name

このバックアップセットによってバックアップされるオブジェクトを含むデータベースの名前。

object_schema_name

このバックアップセットによってバックアップされるオブジェクトを含むスキーマの名前。

backup_policy_name

このバックアップセットにアタッチされているバックアップポリシーの名前。

backup_policy_database_name

バックアップポリシーが含まれるデータベースの名前。

backup_policy_schema_name

バックアップポリシーが含まれるスキーマの名前。

backup_policy_state

バックアップポリシーの現在の状態。

owner_role

バックアップセットに対する OWNERSHIP 権限を持つロールの名前。

owner_role_type

バックアップセットに対する OWNERSHIP 権限を持つロールのタイプ。

comment

バックアップセットのコメント。

例

現在のアカウントで権限を持つすべてのバックアップセットをリストします。

SHOW BACKUP SETS IN ACCOUNT;
Copy

名前に T1 を含むバックアップセットを一覧表示します。

SHOW BACKUP SETS LIKE '%T1%';
Copy
言語: 日本語