Vista de SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION

Vista previa

Este producto o función está sujeto a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones específicas del Servicio. Los productos y las funciones que se encuentran en la fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

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

Función requerida

Para obtener los permisos 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.

También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

Esquema

La vista INFORMATION_SCHEMA.SCHEMATA_REPLICAS contiene información sobre las réplicas de conjuntos de datos. La vista INFORMATION_SCHEMA.SCHEMATA_REPLICAS 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á asociada con la réplica.
catalog_name	STRING	El ID del proyecto que contiene el conjunto de datos.
schema_name	STRING	Es 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.
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.
creation_time	TIMESTAMP	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 el estado inactivo del conjunto de datos. Es posible que algunas tablas de la réplica estén por delante de 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 transmisión, el valor de replication_time no será preciso.
sync_status	JSON	El estado de la sincronización entre la réplica principal y la secundaria Muestra NULL si la réplica es una réplica principal.

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: RESERVATION_PROJECT_ID es el ID del proyecto de administración de la reserva. 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 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 ejemplos de consultas 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} |
+--------------+--------------+--------------+----------+--------------------------+-------------------------------------+---------------------+-------------------+---------------------+---------------------------------+---------------------------+-------------------------------------------------------------------------------+