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詳しくは、データセット修飾子をご覧ください。

注: INFORMATION_SCHEMA ビューにクエリを実行するロケーションを指定する必要があります。クエリ実行のロケーションは、INFORMATION_SCHEMA ビューのリージョンと一致する必要があります。

例

-- 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 |
+----------------+---------------+-----------------+--------------------+-------------------+-----------------+-----------------------------+