FAILOVER_HISTORY 檢視畫面

如要尋求支援或對這項功能提供意見回饋，請傳送電子郵件至 bigquery-wlm-feedback@google.com。

INFORMATION_SCHEMA.FAILOVER_HISTORY 檢視畫面會顯示管理專案中預留項目的容錯移轉事件清單，這些預留項目使用受管理災難復原，且清單會近乎即時更新。每一列代表單一預訂的單一容錯移轉事件。

必要的角色

如要取得查詢 INFORMATION_SCHEMA.FAILOVER_HISTORY 檢視畫面所需的權限，請要求管理員授予您專案的「BigQuery 資源檢視者」 (roles/bigquery.resourceViewer) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

這個預先定義的角色具備 bigquery.reservations.list 權限，可查詢 INFORMATION_SCHEMA.FAILOVER_HISTORY 檢視畫面。

您或許還可透過自訂角色或其他預先定義的角色取得這項權限。

結構定義

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