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 Resource Viewer (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} |
+--------------+--------------+--------------+----------+--------------------------+-------------------------------------+---------------------+-------------------+---------------------+---------------------------------+---------------------------+-------------------------------------------------------------------------------+