SHOW SNAPSHOT SETS

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

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

CREATE SNAPSHOT SET、 ALTER SNAPSHOT SET、 DROP SNAPSHOT SET

構文

SHOW SNAPSHOT SETS
   [ LIKE '<pattern>' ]
   [ IN { ACCOUNT | DATABASE | DATABASE <db_name> | SCHEMA | SCHEMA <schema_name> } ]
Copy

パラメーター

LIKE 'pattern'

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

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

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

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

[ IN { ACCOUNT | DATABASE | DATABASE db_name | SCHEMA | SCHEMA schema_name } ]

キーワード 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}`を指定しない場合、以下のようになります：

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

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

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

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

使用上の注意

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

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

出力

列

説明

created_on

スナップショットセットが作成されたときのタイムスタンプ。

name

スナップショットの名前。

database_name

シークレットを含むデータベースの名前。

schema_name

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

object_kind

スナップショットセットがスナップショットするオブジェクトの型。

object_name

スナップショットセットがスナップショットしているオブジェクトの名前。

object_database_name

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

object_schema_name

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

snapshot_policy_name

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

snapshot_policy_database_name

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

snapshot_policy_schema_name

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

comment

スナップショットセットのコメント。

owner

フェールオーバーグループに対する OWNERSHIP 権限を持つロールの名前。

owner_role_type

スナップショットセットに対する OWNERSHIP 権限を持つロールのタイプ。

例

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

SHOW SNAPSHOT SETS IN ACCOUNT;
Copy

名前に T1 を含むスナップショットセットをリストする。

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