SHOW SNAPSHOT POLICIES --- Deprecated¶

Lists all the snapshot policies in your account for which you have access privileges.

こちらもご参照ください。: CREATE SNAPSHOT POLICY --- Deprecated、 ALTER SNAPSHOT POLICY --- Deprecated、 DROP SNAPSHOT POLICY --- Deprecated

構文¶

SHOW SNAPSHOT POLICIES
   [ LIKE '<pattern>' ]
   [ IN { ACCOUNT | DATABASE | DATABASE <db_name> | SCHEMA | SCHEMA <schema_name> }
     [ STARTS WITH '<name_string>' ]
     [ LIMIT <rows> [ FROM '<name_string>' ]
   ]

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'

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

For example, the following strings return different results:

... STARTS WITH 'B' ...

... STARTS WITH 'b' ...

. Default: No value (no filtering is applied to the output)

LIMIT rows [ FROM 'name_string' ]

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

オプションの FROM 'name_string' サブ句は、結果の「カーソル」として効果的に機能します。これにより、指定された文字列と一致するオブジェクト名を持つ最初の行に続く指定された行数を取得できます。

文字列は一重引用符で囲む必要があり、大文字と小文字を区別します。
文字列に完全なオブジェクト名を含める必要はありません。部分的な名前がサポートされています。

Default: No value (no limit is applied to the output)

注釈

FROM 'name_string' 句と STARTS WITH 'name_string' 句の両方をサポートする SHOW コマンドの場合、同じステートメントでこれらの両方の句を組み合わせることができます。ただし、両方の条件を満たしている必要があります。そうでない場合、互いにキャンセルされ、結果が返されません。

さらに、オブジェクトは名前の辞書式順序で返されるため、 FROM 'name_string' は、 STARTS WITH 'name_string' によって返される行よりも辞書式の値が大きい行のみを返します。

For example:

... STARTS WITH 'A' LIMIT ... FROM 'B' は結果を返しません。
... STARTS WITH 'B' LIMIT ... FROM 'A' は結果を返しません。
... STARTS WITH 'A' LIMIT ... FROM 'AB' は結果を返します（入力文字列に一致する行がある場合）。

使用上の注意¶

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

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

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

注釈

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

出力¶

列	説明
`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 SNAPSHOT POLICIES IN ACCOUNT;

Copy