Es posible que parte o toda la información de esta página no se aplique a Trusted Cloud by S3NS. Para obtener más información, consulta las diferencias con Google Cloud.

Esta página se ha traducido con Cloud Translation API.

Vista SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION

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

Rol necesario

Para obtener los permisos que necesitas para consultar la vista INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION, pide a tu administrador que te asigne el rol de gestión de identidades y accesos Lector de recursos de BigQuery (roles/bigquery.resourceViewer) en el proyecto. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u 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`	El ID de proyecto del proyecto de administrador de la reserva de conmutación por error si está asociado a la réplica.
`failover_reservation_name`	`STRING`	Nombre de la reserva de conmutación por error si está asociada a la réplica.
`catalog_name`	`STRING`	El ID del proyecto que contiene el conjunto de datos.
`schema_name`	`STRING`	ID del conjunto de datos.
`replica_name`	`STRING`	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.
`replica_primary_assignment_complete`	`BOOL`	Si el valor es `TRUE`, la asignación principal se ha completado. Si el valor es `FALSE`, la réplica no es (todavía) la réplica principal, aunque `replica_primary_assigned` sea igual a `TRUE`.
`creation_time`	`TIMESTAMP`	Hora de creación de la réplica. Cuando se crea la réplica por primera vez, no se sincroniza completamente con la réplica principal hasta que `creation_complete` es igual a `TRUE`. El valor de `creation_time` se define 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 secundaria se ha completado.
`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 adelantadas que esta marca de tiempo. Este valor solo se puede ver en la región secundaria. Si el conjunto de datos contiene una tabla con datos de streaming, el valor de `replication_time` no será preciso.
`sync_status`	`JSON`	El estado de la sincronización entre las réplicas primarias y secundarias de los conjuntos de datos de replicación entre regiones y recuperación tras desastres. Devuelve `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`	La hora a la que se activó el cambio de la principal a la réplica.
`replica_primary_assignment_completion_time`	`TIMESTAMP`	Hora a la que se completó el cambio principal a la réplica.

Ámbito y sintaxis

Las consultas en esta vista deben incluir un calificador de región. En la siguiente tabla se explica el ámbito de la región de esta vista:

Nombre de la vista	Ámbito de los recursos	Ámbito de la región
[RESERVATION_PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION[_BY_PROJECT]	Nivel de proyecto	`REGION`

Sustituye lo siguiente:

Opcional: PROJECT_ID: el ID de tu proyecto. Trusted Cloud 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 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 incluyen ejemplos de consultas de la vista INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION.

Ejemplo: enumerar todos los conjuntos de datos replicados de 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} |
+--------------+--------------+--------------+----------+--------------------------+-------------------------------------+---------------------+-------------------+---------------------+---------------------------------+---------------------------+-------------------------------------------------------------------------------+