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。指定しない場合は、デフォルトのプロジェクトが使用されます。

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