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