FAILOVER_HISTORY 뷰

이 기능에 대한 의견이나 지원을 요청하려면 bigquery-wlm-feedback@google.com으로 이메일을 보내세요.

INFORMATION_SCHEMA.FAILOVER_HISTORY 뷰에는 관리형 재해 복구를 사용하는 관리 프로젝트 내 예약의 장애 조치 이벤트에 대한 거의 실시간 목록이 포함됩니다. 각 행은 단일 예약에 대한 단일 장애 조치 이벤트를 나타냅니다.

필요한 역할

INFORMATION_SCHEMA.FAILOVER_HISTORY 뷰를 쿼리하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 BigQuery 리소스 뷰어 (roles/bigquery.resourceViewer) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 INFORMATION_SCHEMA.FAILOVER_HISTORY 뷰를 쿼리하는 데 필요한 bigquery.reservations.list 권한이 포함되어 있습니다.

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

스키마

INFORMATION_SCHEMA.FAILOVER_HISTORY 뷰에는 다음과 같은 스키마가 있습니다.

열 이름 데이터 유형 값
project_id STRING 예약이 포함된 관리 프로젝트의 ID입니다.
project_number INTEGER 관리 프로젝트의 번호입니다.
reservation_name STRING 사용자가 제공한 예약 이름입니다. 예를 들어 예약 URI가 projects/my-project/locations/US/reservations/my-reservation이면 예약 이름은 my-reservation입니다.
start_time TIMESTAMP 장애 조치가 시작된 시간입니다.
original_primary_location STRING 예약이 원래 생성된 위치입니다.
from_location STRING 장애 조치 전의 기본 위치입니다. 이 위치는 장애 조치 후 보조가 됩니다.
to_location STRING 장애 조치 전의 보조 위치로, 장애 조치가 시작된 위치입니다. 이 위치는 장애 조치 후 기본 위치가 됩니다.
end_time TIMESTAMP 소프트 장애 조치가 완료된 시간입니다. NULL(소프트 장애 조치가 진행 중인 경우) 또는 항상 NULL(하드 장애 조치의 경우)
failover_mode STRING 장애 조치 유형입니다. SOFT 또는 HARD일 수 있습니다. 자세한 내용은 관리형 재해 복구를 참고하세요.
state STRING 장애 조치의 상태입니다. STARTED (소프트 장애 조치가 진행 중이거나 하드 장애 조치의 경우) 또는 COMPLETED (소프트 장애 조치가 완료된 후)일 수 있습니다. 강제 장애 조치에 대한 STARTED 상태에 관한 자세한 내용은 제한사항을 참고하세요.

안정성을 위해 와일드 카드(SELECT *)를 사용하는 대신 정보 스키마 쿼리에 열을 명시적으로 나열하는 것이 좋습니다. 열을 명시적으로 나열하면 기본 스키마가 변경될 때 쿼리가 중단되지 않습니다.

데이터 보관

이 뷰는 장애 조치 이벤트를 180일 동안 보관한 후 뷰에서 삭제합니다.

범위 및 구문

이 뷰에 대한 쿼리에는 리전 한정자가 있어야 합니다. 다음 표에는 이 뷰의 리전 범위가 나와 있습니다.

뷰 이름 리소스 범위 리전 범위
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.FAILOVER_HISTORY[_BY_PROJECT] 프로젝트 수준 REGION
다음을 바꿉니다.
  • 선택사항: PROJECT_ID: Google Cloud 프로젝트의 ID입니다. 지정하지 않으면 기본 프로젝트가 사용됩니다.
  • REGION: 모든 데이터 세트 리전 이름입니다. 예를 들면 `region-us`입니다.

제한사항

INFORMATION_SCHEMA.FAILOVER_HISTORY 뷰에는 다음과 같은 제한사항이 적용됩니다.

  • 이 뷰에는 예약의 장애 조치 이벤트만 포함됩니다. 개별 데이터 세트의 장애 조치 이벤트는 포함되지 않습니다.

  • 각 장애 조치 이벤트는 새 기본 위치 (to_location)가 되는 리전에 기록됩니다. 예를 들어 US에서 EU로 예약을 장애 조치하는 경우 이벤트는 region-eu에 기록됩니다. 기본 위치와 보조 위치 간 양방향 장애 조치 이벤트를 보려면 각 리전에서 뷰를 별도로 쿼리하세요.

  • 강제 장애 조치는 보조 위치에서 작업이 확인될 때까지 기다리지 않으므로 강제 장애 조치 이벤트에는 완료 신호가 없습니다. 강제 장애 조치 이벤트의 state 열은 장애 조치가 적용된 후에도 STARTED로 유지되고 end_time 열은 NULL로 유지됩니다.

예

다음 예에서는 특정 예약 및 프로젝트에 대해 region-us (여기서 US은 장애 조치의 대상 위치 to_location임)의 장애 조치 이벤트를 가장 최근 이벤트 순으로 정렬하여 가져옵니다.

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;

출력은 다음과 비슷합니다.

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