TABLE_SNAPSHOTS ビュー
INFORMATION_SCHEMA.TABLE_SNAPSHOTS
ビューには、テーブル スナップショットに関するメタデータが含まれます。さらに詳しい内容については、テーブル スナップショットの概要をご覧ください。
必要な権限
INFORMATION_SCHEMA.TABLE_SNAPSHOTS
ビューをクエリするには、データセットの bigquery.tables.list
Identity and Access Management(IAM)権限が必要です。事前定義されたロール roles/bigquery.metadataViewer
には、必要な権限が含まれています。
BigQuery の権限の詳細については、IAM でのアクセス制御をご覧ください。
スキーマ
INFORMATION_SCHEMA.TABLE_SNAPSHOTS
テーブルに対してクエリを実行すると、指定したデータセットまたはリージョンのテーブル スナップショットごとに 1 行が表示されます。
INFORMATION_SCHEMA.TABLE_SNAPSHOTS
テーブルは、次のスキーマを持っています。テーブル スナップショットが取得された標準テーブルは、ベーステーブルと呼ばれます。
列名 | データ型 | 値 |
---|---|---|
table_catalog |
STRING |
テーブル スナップショットを含むプロジェクトの名前 |
table_schema |
STRING |
テーブル スナップショットを含むデータセットの名前 |
table_name |
STRING |
テーブル スナップショットの名前 |
base_table_catalog |
STRING |
ベーステーブルを含むプロジェクトの名前 |
base_table_schema |
STRING |
ベーステーブルを含むデータセットの名前 |
base_table_name |
STRING |
ベーステーブルの名前 |
snapshot_time |
TIMESTAMP |
テーブルのスナップショットが作成された時刻 |
スコープと構文
このビューに対するクエリでは、データセット修飾子またはリージョン修飾子を指定する必要があります。データセット修飾子が指定されたクエリの場合は、データセットに対する権限が必要です。リージョン修飾子が指定されたクエリの場合は、プロジェクトに対する権限が必要です。詳細については、構文をご覧ください。次の表に、このビューのリージョン スコープとリソース スコープを示します。
ビュー名 | リソース スコープ | リージョン スコープ |
---|---|---|
[`PROJECT_ID`.]`region-REGION`.INFORMATION_SCHEMA.TABLE_SNAPSHOTS |
プロジェクト レベル | REGION |
[`PROJECT_ID`.]DATASET_ID.INFORMATION_SCHEMA.TABLE_SNAPSHOTS |
データセット レベル | データセットのロケーション |
省略可: PROJECT_ID
: Google Cloud プロジェクトの ID。指定しない場合は、デフォルトのプロジェクトが使用されます。
REGION
: 任意のデータセット リージョン名。例:`region-us`
DATASET_ID
: データセットの ID詳しくは、データセット修飾子をご覧ください。
例
-- Returns metadata for the table snapshots in the specified dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.TABLE_SNAPSHOTS;
-- Returns metadata for the table snapshots in the specified region.
SELECT * FROM `region-us`.INFORMATION_SCHEMA.TABLE_SNAPSHOTS;
例
次のクエリは、mydataset
データセット内のテーブル スナップショットのメタデータを取得します。この例では、2021 年 5 月 14 日午後 12 時(UTC)にベーステーブル myproject.mydataset.mytable
から取得した、テーブル スナップショット myproject.mydataset.mytablesnapshot
を表示します。
SELECT * FROM `myproject`.mydataset.INFORMATION_SCHEMA.TABLE_SNAPSHOTS;
次のような結果になります。
+----------------+---------------+-----------------+--------------------+-------------------+-----------------+-----------------------------+ | table_catalog | table_schema | table_name | base_table_catalog | base_table_schema | base_table_name | snapshot_time | +----------------+---------------+-----------------+----------------------------------------------------------------------------------------+ | myproject | mydataset | mytablesnapshot | myProject | mydataset | mytable | 2021-05-14 12:00:00.000 UTC | +----------------+---------------+-----------------+--------------------+-------------------+-----------------+-----------------------------+