Vista FAILOVER_HISTORY

Para solicitar comentarios o asistencia para esta función, envía un correo electrónico a bigquery-wlm-feedback@google.com.

La vista INFORMATION_SCHEMA.FAILOVER_HISTORY contiene una lista casi en tiempo real de los eventos de conmutación por error de las reservas del proyecto de administración que usan la recuperación ante desastres administrada. Cada fila representa un solo evento de conmutación por error para una sola reserva.

Roles obligatorios

Para obtener el permiso que necesitas para consultar la vista INFORMATION_SCHEMA.FAILOVER_HISTORY, 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.

Este rol predefinido contiene el permiso bigquery.reservations.list que se requiere para consultar la vista INFORMATION_SCHEMA.FAILOVER_HISTORY.

También puedes obtener este permiso con roles personalizados o con otros roles predefinidos.

Esquema

La vista INFORMATION_SCHEMA.FAILOVER_HISTORY tiene el siguiente esquema:

Nombre de la columna Tipo de datos Valor
project_id STRING ID del proyecto de administración que contiene la reserva.
project_number INTEGER Número del proyecto de administración.
reservation_name STRING Es el nombre de la reserva que proporcionó el usuario. Por ejemplo, si el URI de la reserva es projects/my-project/locations/US/reservations/my-reservation, el nombre de la reserva es my-reservation.
start_time TIMESTAMP Fecha y hora en que se inició la conmutación por error.
original_primary_location STRING Es la ubicación en la que se creó originalmente la reserva.
from_location STRING Es la ubicación principal antes de la conmutación por error. Esta ubicación se convierte en la secundaria después de la conmutación por error.
to_location STRING Ubicación secundaria antes de la conmutación por error, donde se inició la conmutación por error. Esta ubicación se convierte en la principal después de la conmutación por error.
end_time TIMESTAMP Fecha y hora en que se completó la conmutación por error manual. NULL mientras la conmutación por error parcial está en curso y siempre NULL para la conmutación por error total.
failover_mode STRING Es el tipo de conmutación por error. Puede ser SOFT o HARD. Para obtener más información, consulta Recuperación ante desastres administrada.
state STRING Es el estado de la conmutación por error. Puede ser STARTED (mientras se realiza una conmutación por error manual o para una conmutación por error completa) o COMPLETED (después de que finaliza una conmutación por error manual). Para obtener más información sobre el estado STARTED en una conmutación por error grave, consulta Limitaciones.

Para mayor estabilidad, te recomendamos que enumeres de forma explícita las columnas en tus consultas de esquema de información en lugar de usar un comodín (SELECT *). Enumerar las columnas de forma explícita evita que las consultas se interrumpan si cambia el esquema subyacente.

Retención de datos

En esta vista, se conservan los eventos de conmutación por error durante 180 días, después de los cuales se quitan de la vista.

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
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.FAILOVER_HISTORY[_BY_PROJECT] Nivel de proyecto REGION
Reemplaza lo siguiente:
  • Opcional: PROJECT_ID: el ID de tu proyecto de Cloud de Confiance . Si no se especifica, se usa el proyecto predeterminado.
  • REGION: Cualquier nombre de región del conjunto de datos. Por ejemplo, `region-us`.

Limitaciones

Se aplican las siguientes limitaciones a la vista de INFORMATION_SCHEMA.FAILOVER_HISTORY:

  • Esta vista solo contiene eventos de conmutación por error para las reservas. No contiene eventos de conmutación por error para conjuntos de datos individuales.

  • Cada evento de conmutación por error se registra en la región que se convierte en la nueva ubicación principal (to_location). Por ejemplo, si conmutas por error una reserva de US a EU, el evento se registra en region-eu. Para ver los eventos de conmutación por error en ambas direcciones entre una ubicación principal y una secundaria, consulta la vista por separado en cada región.

  • Una conmutación por error forzada no espera a que se confirme la operación en la ubicación secundaria, por lo que un evento de conmutación por error forzada no tiene un indicador de finalización. La columna state para un evento de conmutación por error grave permanece como STARTED, y la columna end_time permanece como NULL, incluso después de que la conmutación por error haya entrado en vigencia.

Ejemplo

En el siguiente ejemplo, se recuperan los eventos de conmutación por error en region-us (donde US era la ubicación de destino to_location de la conmutación por error) para una reserva y un proyecto específicos, ordenados por el evento más reciente:

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;

El resultado es similar a lo siguiente:

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