SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION ビュー

INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION ビューには、フェイルオーバー予約に関連付けられているスキーマ レプリカに関する情報が含まれます。INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION ビューは、データセットを含むプロジェクトにスコープが設定されている INFORMATION_SCHEMA.SCHEMATA_REPLICAS ビューとは異なり、フェイルオーバー予約のプロジェクトにスコープが設定されています。

必要なロール

INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION ビューに対するクエリの実行に必要な権限を取得するには、プロジェクトに対する BigQuery リソース閲覧者 （roles/bigquery.resourceViewer）IAM ロールの付与を管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

スキーマ

INFORMATION_SCHEMA.SCHEMATA_REPLICAS ビューには、データセットのレプリカに関する情報が含まれています。INFORMATION_SCHEMA.SCHEMATA_REPLICAS ビューのスキーマは次のとおりです。
列 タイプ 説明
failover_reservation_project_id STRING レプリカに関連付けられている場合、フェイルオーバー予約管理プロジェクトのプロジェクト ID。
failover_reservation_name STRING レプリカに関連付けられている場合のフェイルオーバー予約の名前。
catalog_name STRING データセットを含むプロジェクトの ID。
schema_name STRING データセットのデータセット ID。
replica_name STRING レプリカの名前。
location STRING レプリカが作成されたリージョンまたはマルチリージョン。
replica_primary_assigned BOOL 値が TRUE の場合、レプリカにはプライマリの割り当てがあります。
replica_primary_assignment_complete BOOL 値が TRUE の場合、プライマリの割り当ては完了しています。 値が FALSE の場合、replica_primary_assigned が TRUE であっても、レプリカはプライマリ レプリカではありません。
creation_time TIMESTAMP レプリカの作成時刻。レプリカが最初に作成された場合、creation_complete が TRUE と等しくなるまで、レプリカはプライマリ レプリカと完全に同期されません。creation_time の値は、creation_complete が TRUE と等しくなる前に設定されます。
creation_complete BOOL 値が TRUE の場合、プライマリ レプリカからセカンダリ レプリカへの最初の完全同期は完了しています。
replication_time TIMESTAMP

replication_time の値はデータセットの未更新を示しています。

レプリカ内の一部のテーブルがこのタイムスタンプより新しい可能性があります。この値は、セカンダリ リージョンにのみ表示されます。

データセットにストリーミング データを含むテーブルが含まれている場合、replication_time の値は正確ではありません。
sync_status JSON プライマリ レプリカとセカンダリ レプリカ間の同期のステータス。レプリカがプライマリ レプリカの場合は NULL を返します。

スコープと構文

このビューに対するクエリでは、リージョン修飾子を指定する必要があります。次の表で、このビューのリージョン スコープを説明します。

ビュー名 リソース スコープ リージョン スコープ
[RESERVATION_PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION[_BY_PROJECT] プロジェクト レベル REGION
次のように置き換えます。

  • 省略可: RESERVATION_PROJECT_ID: 予約の管理プロジェクトの ID。指定しない場合は、デフォルトのプロジェクトが使用されます。

  • REGION: 任意のデータセット リージョン名。例: `region-us`

例

このセクションでは、INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION ビューのクエリ例を示します。

例: リージョン内のレプリケートされたすべてのデータセットを一覧表示する

次の例では、US リージョン内のレプリケートされたすべてのデータセットを一覧表示します。

SELECT *
FROM `region-us`.INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION
WHERE failover_reservation_name = "failover_reservation";

次のような結果になります。

+--------------+--------------+--------------+----------+--------------------------+-------------------------------------+---------------------+-------------------+---------------------+---------------------------------+---------------------------+-------------------------------------------------------------------------------+
| catalog_name | schema_name  | replica_name | location | replica_primary_assigned | replica_primary_assignment_complete |    creation_time    | creation_complete |  replication_time   | failover_reservation_project_id | failover_reservation_name |                                  sync_status                                  |
+--------------+--------------+--------------+----------+--------------------------+-------------------------------------+---------------------+-------------------+---------------------+---------------------------------+---------------------------+-------------------------------------------------------------------------------+
| project2     | test_dataset | us-east4     | us-east4 |                     true |                                true | 2024-05-09 20:34:06 |              true |                NULL | project1                        | failover_reservation      |                                                                          NULL |
| project2     | test_dataset | us           | US       |                    false |                               false | 2024-05-09 20:34:05 |              true | 2024-05-10 18:31:06 | project1                        | failover_reservation      | {"last_completion_time":"2024-06-06 18:31:06","error_time":null,"error":null} |
+--------------+--------------+--------------+----------+--------------------------+-------------------------------------+---------------------+-------------------+---------------------+---------------------------------+---------------------------+-------------------------------------------------------------------------------+