Es posible que parte de la información de esta página (o toda) no se aplique a Cloud de Confiance de S3NS. Consulta Diferencias con Google Cloud para obtener más información.

Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Vista de SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION

La vista INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION contiene información sobre las réplicas de esquemas asociadas con una reserva de conmutación por error. El alcance de la INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION vista se limita a el proyecto de la reserva de conmutación por error, a diferencia de la INFORMATION_SCHEMA.SCHEMATA_REPLICAS vista cuyo alcance se limita al proyecto que contiene el conjunto de datos.

Roles obligatorios

Para obtener el permiso que necesitas para consultar la vista INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION, pídele a tu administrador que te otorgue el rol de IAM Visualizador de recursos de BigQuery (roles/bigquery.resourceViewer) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene el bigquery.reservations.listFailoverDatasets permiso, que se requiere para consultar la vista INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION

También puedes obtener este permiso con roles personalizados o otros roles predefinidos.

Esquema

La vista INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION tiene el siguiente esquema:

Columna	Tipo	Descripción
`failover_reservation_project_id`	`STRING`	Es el ID del proyecto de administrador de reservas de conmutación por error si está asociado con la réplica.
`failover_reservation_name`	`STRING`	Es el nombre de la reserva de conmutación por error si está asociado con la réplica.
`catalog_name`	`STRING`	El ID del proyecto que contiene el conjunto de datos.
`schema_name`	`STRING`	El ID del conjunto de datos.
`replica_name`	`STRING`	El nombre de la réplica.
`location`	`STRING`	La región o multirregión en la que se creó la réplica.
`replica_primary_assigned`	`BOOL`	Si el valor es `TRUE`, la réplica tiene la asignación principal. Cuando cambias a una réplica secundaria a una principal, este estado entra en vigencia de inmediato.
`replica_primary_assignment_complete`	`BOOL`	Si el valor es `TRUE`, la asignación principal está completa. Si el valor es `FALSE`, la réplica no es (aún) la réplica principal, incluso si `replica_primary_assigned` es igual a `TRUE`. Para obtener información sobre cuánto tiempo tarda una réplica secundaria en convertirse en principal, consulta Asciende la réplica secundaria.
`creation_time`	`TIMESTAMP`	Es la hora de creación de la réplica. Cuando se crea la réplica por primera vez, no se sincroniza por completo con la réplica principal hasta que `creation_complete` sea igual a `TRUE`. El valor de `creation_time` se establece antes de que `creation_complete` sea igual a `TRUE`.
`creation_complete`	`BOOL`	Si el valor es `TRUE`, la sincronización completa inicial de la réplica principal con la réplica secundaria está completa.
`replication_time`	`TIMESTAMP`	El valor de `replication_time` indica la antigüedad del conjunto de datos. Es posible que algunas tablas de la réplica estén más avanzadas que esta marca de tiempo. Este valor solo es visible en la región secundaria. Si el conjunto de datos contiene una tabla con datos de transmisión, el valor de `replication_time` no será preciso.
`sync_status`	`JSON`	Es el estado de la sincronización entre las réplicas principal y secundaria para los conjuntos de datos de replicación entre regiones y recuperación ante desastres. Muestra `NULL` si la réplica es una réplica principal o si el conjunto de datos no usa la replicación.
`replica_primary_assignment_time`	`TIMESTAMP`	Es la hora en la que se activó el cambio principal a la réplica.
`replica_primary_assignment_completion_time`	`TIMESTAMP`	Es la hora en la que se completó el cambio principal a la réplica.

Para lograr estabilidad, te recomendamos que enumeres las columnas de forma explícita en las consultas de esquema de información en lugar de usar un comodín (SELECT *). Si enumeras las columnas de forma explícita, se evita que las consultas se interrumpan si cambia el esquema subyacente.

Permiso y sintaxis

Las consultas realizadas a esta vista deben incluir un calificador de región. En la siguiente tabla, se explica el permiso de la región para esta vista:

Nombre de la vista	Permiso del recurso	Permiso de la región
[RESERVATION_PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION[_BY_PROJECT]	Nivel de proyecto	`REGION`

Reemplaza lo siguiente:

Opcional: PROJECT_ID: Es el ID de tu Cloud de Confiance proyecto. Si no se especifica, se usa el proyecto predeterminado.
REGION: Cualquier nombre de región del conjunto de datos. Por ejemplo, `region-us`.

Nota: Debes usar un calificador de región para consultar las vistas de INFORMATION_SCHEMA. La ubicación de la ejecución de la consulta debe coincidir con la región de la vista INFORMATION_SCHEMA.

Ejemplos

En esta sección, se enumeran las consultas de ejemplo de la vista INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION.

Ejemplo: Enumera todos los conjuntos de datos replicados en una región

En el siguiente ejemplo, se enumeran todos los conjuntos de datos replicados en la región US:

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

El resultado es similar al siguiente:

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