Vista SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION

A vista INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION contém informações sobre réplicas de esquemas associadas a uma reserva de comutação por falha. A INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION vista tem âmbito no projeto da reserva de comutação por falha, ao contrário da INFORMATION_SCHEMA.SCHEMATA_REPLICAS vista que tem âmbito no projeto que contém o conjunto de dados.

Função necessária

Para obter as autorizações de que precisa para consultar a vista INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION, peça ao seu administrador para lhe conceder a função de IAM de visualizador de recursos do BigQuery (roles/bigquery.resourceViewer) no projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Esquema

A vista INFORMATION_SCHEMA.SCHEMATA_REPLICAS contém informações sobre as réplicas do conjunto de dados. A vista INFORMATION_SCHEMA.SCHEMATA_REPLICAS tem o seguinte esquema:
Coluna Tipo Descrição
failover_reservation_project_id STRING O ID do projeto do administrador da reserva de alternativa em caso de falha se estiver associado à réplica.
failover_reservation_name STRING O nome da reserva de alternativa se 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 as várias regiões em que a réplica foi criada.
replica_primary_assigned BOOL Se o valor for TRUE, a réplica tem a atribuição principal.
replica_primary_assignment_complete BOOL Se o valor for TRUE, a atribuição principal está concluída. Se o valor for FALSE, a réplica não é (ainda) a réplica primária, mesmo que replica_primary_assigned seja igual a TRUE.
creation_time TIMESTAMP A hora de criação da réplica. Quando a réplica é criada pela primeira vez, não está totalmente sincronizada com a réplica principal até que creation_complete seja igual a TRUE. O valor de creation_time é definido antes de creation_complete ser igual a TRUE.
creation_complete BOOL Se o valor for TRUE, a sincronização completa inicial da réplica principal com a réplica secundária está concluída.
replication_time TIMESTAMP

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

Algumas tabelas na réplica podem estar à frente desta data/hora. Este 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 é preciso.
sync_status JSON O estado da sincronização entre a réplica principal e a secundária. Devolve NULL se a réplica for uma réplica principal.

Âmbito e sintaxe

As consultas nesta vista têm de incluir um qualificador de região. A tabela seguinte explica o âmbito da região para esta vista:

Nome da visualização de propriedade Âmbito do recurso Âmbito da região
[RESERVATION_PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION[_BY_PROJECT] Nível do projeto REGION
Substitua o seguinte:
  • Opcional: RESERVATION_PROJECT_ID: o ID do projeto de administração da reserva. Se não for especificado, é usado o projeto predefinido.
  • REGION: qualquer nome da região do conjunto de dados. Por exemplo, `region-us`.

Exemplos

Esta secção apresenta exemplos de consultas da vista INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION.

Exemplo: liste todos os conjuntos de dados replicados numa região

O exemplo seguinte apresenta 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 é 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} |
+--------------+--------------+--------------+----------+--------------------------+-------------------------------------+---------------------+-------------------+---------------------+---------------------------------+---------------------------+-------------------------------------------------------------------------------+