Visualização SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION

A visualização INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION contém informações sobre réplicas de esquema associadas a uma reserva de failover. A visualização INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION é restrita ao projeto da reserva de failover, em vez da visualização INFORMATION_SCHEMA.SCHEMATA_REPLICAS, que é restrita ao projeto que contém o conjunto de dados.

Papel necessário

Para receber as permissões necessárias para consultar a visualização INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION, peça ao administrador para conceder a você o papel do IAM de Leitor de recursos do BigQuery (roles/bigquery.resourceViewer) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.

Esquema

A visualização INFORMATION_SCHEMA.SCHEMATA_REPLICAS contém informações sobre réplicas de conjuntos de dados. A visualização INFORMATION_SCHEMA.SCHEMATA_REPLICAS tem o seguinte esquema:
Coluna Tipo Descrição
failover_reservation_project_id STRING O ID do projeto de administrador da reserva de failover, se ele estiver associado à réplica.
failover_reservation_name STRING O nome da reserva de failover, se ela estiver associada à réplica.
catalog_name STRING O ID do projeto que contém o conjunto de dados.
schema_name STRING O ID do conjunto de dados.
replica_name STRING O nome da réplica.
location STRING A região ou a multirregião em que a réplica foi criada.
replica_primary_assigned BOOL Se o valor for TRUE, a réplica terá a atribuição principal.
replica_primary_assignment_complete BOOL Se o valor for TRUE, a atribuição principal foi concluída. Se o valor for FALSE, a réplica (ainda) não é a principal, mesmo que replica_primary_assigned seja igual a TRUE.
creation_time TIMESTAMP O horário de criação da réplica. Quando a réplica é criada pela primeira vez, ela não é totalmente sincronizada com a réplica principal até creation_complete ser igual a TRUE. O valor de creation_time é definido antes de creation_complete ser TRUE.
creation_complete BOOL Se o valor for TRUE, a sincronização completa inicial da réplica principal para a secundária será concluída.
replication_time TIMESTAMP

O valor de replication_time indica a inatividade do conjunto de dados.

Algumas tabelas na réplica podem estar à frente desse carimbo de data/hora. Esse valor só é visível na região secundária.

Se o conjunto de dados contiver uma tabela com dados de streaming, o valor de replication_time não será preciso.
sync_status JSON O status da sincronização entre a réplica principal e a secundária. Retorna NULL se a réplica for principal.

Escopo e sintaxe

As consultas nessa visualização precisam incluir um qualificador de região. A tabela a seguir explica o escopo da região dessa visualização:

Nome da visualização Escopo do recurso Escopo da região
[RESERVATION_PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION[_BY_PROJECT] Nível do projeto REGION
Substitua:

  • Opcional: RESERVATION_PROJECT_ID: o ID do projeto de administração da reserva. Se não for especificado, o projeto padrão será usado.

  • REGION: qualquer nome da região do conjunto de dados. Por exemplo, `region-us`.

Examples

Nesta seção, listamos exemplos de consultas da visualização INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION.

Exemplo: listar todos os conjuntos de dados replicados em uma região

O exemplo a seguir lista todos os conjuntos de dados replicados na região US:

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

O resultado será semelhante ao seguinte:

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