Visualização FAILOVER_HISTORY

Para solicitar feedback ou suporte para esse recurso, envie um e-mail para bigquery-wlm-feedback@google.com.

A visualização INFORMATION_SCHEMA.FAILOVER_HISTORY contém uma lista quase em tempo real de eventos de failover para reservas no projeto de administração que usam recuperação de desastres gerenciada. Cada linha representa um único evento de failover para uma única reserva.

Funções exigidas

Para receber a permissão necessária para consultar a visualização INFORMATION_SCHEMA.FAILOVER_HISTORY, 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.

Esse papel predefinido contém a permissão bigquery.reservations.list , que é necessária para consultar a visualização INFORMATION_SCHEMA.FAILOVER_HISTORY.

Também é possível receber essa permissão com papéis personalizados ou outros papéis predefinidos.

Esquema

A visualização INFORMATION_SCHEMA.FAILOVER_HISTORY tem o seguinte esquema:

Nome da coluna Tipo de dados Valor
project_id STRING ID do projeto de administração que contém a reserva.
project_number INTEGER Número do projeto de administração.
reservation_name STRING Nome da reserva fornecido pelo usuário. Por exemplo, se o URI da reserva for projects/my-project/locations/US/reservations/my-reservation, o nome da reserva será my-reservation.
start_time TIMESTAMP Horário em que o failover foi iniciado.
original_primary_location STRING O local em que a reserva foi criada originalmente.
from_location STRING O local principal antes do failover. Esse local se torna o secundário após o failover.
to_location STRING O local secundário antes do failover, onde ele foi iniciado. Esse local se torna o principal após o failover.
end_time TIMESTAMP Horário em que o failover flexível foi concluído. NULL enquanto o failover suave está em andamento e sempre NULL para o failover forçado.
failover_mode STRING Tipo de failover. Pode ser SOFT ou HARD. Para mais informações, consulte Recuperação de desastres gerenciada.
state STRING Estado do failover. Pode ser STARTED (enquanto um failover flexível está em andamento ou para um failover rígido) ou COMPLETED (após a conclusão de um failover flexível). Para mais informações sobre o estado STARTED de um failover forçado, consulte Limitações.

Para garantir a estabilidade, recomendamos que você liste explicitamente as colunas nas consultas de esquema de informações em vez de usar um caractere curinga (SELECT *). Isso evita que as consultas sejam interrompidas se o esquema subjacente mudar.

Retenção de dados

Essa visualização mantém os eventos de failover por 180 dias, após os quais eles são removidos.

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
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.FAILOVER_HISTORY[_BY_PROJECT] Nível do projeto REGION
Substitua:
  • Opcional: PROJECT_ID: o ID do seu projeto do Cloud de Confiance . 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`.

Limitações

As seguintes limitações se aplicam à visualização INFORMATION_SCHEMA.FAILOVER_HISTORY:

  • Essa visualização contém apenas eventos de failover para reservas. Ele não contém eventos de failover para conjuntos de dados individuais.

  • Cada evento de failover é registrado na região que se torna o novo local principal (to_location). Por exemplo, se você fizer failover de uma reserva de US para EU, o evento será registrado em region-eu. Para conferir eventos de failover nos dois sentidos entre um local primário e um secundário, consulte a visualização separadamente em cada região.

  • Um failover forçado não espera que a operação seja confirmada no local secundário. Portanto, um evento de failover forçado não tem um indicador de conclusão. A coluna state de um evento de failover forçado permanece STARTED, e a coluna end_time permanece NULL, mesmo depois que o failover entra em vigor.

Exemplo

O exemplo a seguir recupera os eventos de failover em region-us (em que US era o local de destino to_location do failover) para uma reserva e um projeto específicos, ordenados pelo evento mais recente:

SELECT
  project_id,
  reservation_name,
  failover_mode,
  state,
  original_primary_location,
  from_location,
  to_location,
  start_time,
  end_time
FROM
  `reservation-admin-project.region-us`.INFORMATION_SCHEMA.FAILOVER_HISTORY
WHERE
  reservation_name = 'my-reservation'
ORDER BY
  start_time DESC;

O resultado será o seguinte:

+---------------+------------------+---------------+-----------+---------------------------+---------------+-------------+---------------------+---------------------+
|  project_id   | reservation_name | failover_mode |   state   | original_primary_location | from_location | to_location |     start_time      |      end_time       |
+---------------+------------------+---------------+-----------+---------------------------+---------------+-------------+---------------------+---------------------+
| my-admin-proj | my-reservation   | SOFT          | COMPLETED | US                        | EU            | US          | 2026-03-15 14:20:00 | 2026-03-15 14:31:05 |
| my-admin-proj | my-reservation   | HARD          | STARTED   | US                        | EU            | US          | 2026-02-10 08:15:30 | NULL                |
+---------------+------------------+---------------+-----------+---------------------------+---------------+-------------+---------------------+---------------------+