SHOW DATASETS¶

アカウント内のデータセットに関する情報を表示します。すべてのデータセットを表示することも、 IN サブコマンドを使用してスキーマまたはデータベースレベルの結果のみを表示することもできます。

こちらもご参照ください。: CREATE DATASET、 ALTER DATASET

構文¶

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

Copy

オプションのパラメーター¶

LIKE pattern: 返されるデータセットのリストを指定したパターンに一致するものに限定します。
IN SCHEMA <schema_name> | DATABASE <db_name> | ACCOUNT: 返されるデータセットのリストを、アカウント内の指定したスキーマまたはデータベース内のものに制限します。
DATABASE db_name: 返されるデータセットのリストを、指定したデータベース内のものに制限します。db_name なしでデータベースを指定し、データベースが使用されていない場合、これらのキーワードは出力に影響しません。
SCHEMA schema_name: デフォルトでは、使用中のスキーマの記録を返します。schema_name を指定することもできます。
STARTS WITH name_string: 指定した文字列を使用して、返されるデータセットを制限します。返されるデータセットの名前は、指定された文字列と同じ文字で始まります。
LIMIT rows [ FROM name_string ]: 返されるデータセットの行数を指定した行数に制限します。オプションの FROM 句は返されるデータセットの開始点を指定します。

アクセス制御の要件¶

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

権限	オブジェクト	注意
OWNERSHIP または USAGE	データセット	アカウント内のデータセットを表示する権限を提供します。

Operating on an object in a schema requires at least one privilege on the parent database and at least one privilege on the parent schema.

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

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

例¶

次の例では、 PUBLIC スキーマの2つのデータセットを示しています。

SHOW DATASETS IN SCHEMA PUBLIC LIMIT 2;

Copy