SHOW BACKUP POLICIES

アクセス権限があるアカウント内のすべての バックアップ ポリシーをリストします。

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

CREATE BACKUP POLICY、 ALTER BACKUP POLICY、 DROP BACKUP POLICY

構文

SHOW BACKUP POLICIES
   [ 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 で対応するビュー（存在する場合）をクエリします。

バックアップポリシーがバックアップセットに関連付けられているかどうかを確認するには、 SHOWBACKUPSETS コマンドを使用します。

注釈

バックアップポリシーは、特定のスキーマとデータベース内にあるオブジェクトです。したがって、ポリシーは、それを含むスキーマとデータベースでこれらの操作が実行されるときに、複製、削除、削除解除などになります。バックアップポリシーが任意のバックアップセットに関連付けられているため、バックアップポリシーをドロップできない場合は、ポリシーを含むスキーマまたはデータベースもドロップできません。

出力

列

説明

created_on

タイムスタンプバックアップポリシーが作成されました。

name

バックアップポリシーの名前。

database_name

バックアップポリシーを含むデータベースの名前。

schema_name

バックアップポリシーを含むスキーマの名前。

owner

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

comment

バックアップポリシーのコメント。

schedule

バックアップ作成のスケジュール。

expire_after_days

バックアップの有効期限が切れるときのバックアップ作成からの日数。

has_retention_lock

ポリシーに保持ロックが含まれているかどうかを示します。

ポリシーに保持ロックがある場合は Y、それ以外の場合は N。

詳細については、 保持ロック をご参照ください。

owner

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

owner_role_type

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

例

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

SHOW BACKUP POLICIES IN ACCOUNT;
Copy
言語: 日本語