Vista FAILOVER_HISTORY

Vista previa

Este producto o función está sujeto a las "Condiciones de la Oferta de la Fase Previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Los productos y las funciones de la fase previa a la DG están disponibles “tal como están” y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Para solicitar comentarios o asistencia para esta función, envía un correo electrónico a [e-mail].

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.

Nota: Los nombres de las vistas INFORMATION_SCHEMA.FAILOVER_HISTORY y INFORMATION_SCHEMA.FAILOVER_HISTORY_BY_PROJECT son sinónimos y se pueden usar indistintamente.

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

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