Tampilan FAILOVER_HISTORY

Untuk meminta masukan atau dukungan terkait fitur ini, kirim email ke bigquery-wlm-feedback@google.com.

Tampilan INFORMATION_SCHEMA.FAILOVER_HISTORY berisi daftar peristiwa failover yang mendekati real-time untuk reservasi dalam project administrasi yang menggunakan pemulihan bencana terkelola. Setiap baris mewakili satu peristiwa failover untuk satu reservasi.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk membuat kueri tampilan INFORMATION_SCHEMA.FAILOVER_HISTORY, minta administrator untuk memberi Anda peran IAM BigQuery Resource Viewer (roles/bigquery.resourceViewer) di project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin bigquery.reservations.list, yang diperlukan untuk membuat kueri tampilan INFORMATION_SCHEMA.FAILOVER_HISTORY.

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Skema

Tabel virtual INFORMATION_SCHEMA.FAILOVER_HISTORY memiliki skema berikut:

Nama kolom Jenis data Nilai
project_id STRING ID project administrasi yang berisi reservasi.
project_number INTEGER Jumlah project administrasi.
reservation_name STRING Nama reservasi yang diberikan pengguna. Misalnya, jika URI reservasi adalah projects/my-project/locations/US/reservations/my-reservation, maka nama reservasi adalah my-reservation.
start_time TIMESTAMP Waktu saat failover dimulai.
original_primary_location STRING Lokasi tempat pemesanan awalnya dibuat.
from_location STRING Lokasi utama sebelum failover. Lokasi ini menjadi sekunder setelah failover.
to_location STRING Lokasi sekunder sebelum failover, tempat failover dimulai. Lokasi ini menjadi lokasi utama setelah failover.
end_time TIMESTAMP Waktu saat soft failover selesai. NULL saat soft failover sedang berlangsung, dan selalu NULL untuk hard failover.
failover_mode STRING Jenis failover. Dapat berupa SOFT atau HARD. Untuk informasi selengkapnya, lihat Managed disaster recovery.
state STRING Status failover. Dapat berupa STARTED (saat failover non-teknis sedang berlangsung, atau untuk failover teknis) atau COMPLETED (setelah failover non-teknis selesai). Untuk mengetahui informasi selengkapnya tentang status STARTED untuk failover paksa, lihat Batasan.

Untuk stabilitas, sebaiknya Anda mencantumkan kolom secara eksplisit dalam kueri skema informasi, bukan menggunakan karakter pengganti (SELECT *). Mencantumkan kolom secara eksplisit mencegah kueri rusak jika skema yang mendasarinya berubah.

Retensi data

Tampilan ini menyimpan peristiwa failover selama 180 hari, setelah itu peristiwa tersebut akan dihapus dari tampilan.

Cakupan dan sintaksis

Kueri terhadap tabel virtual ini harus menyertakan penentu region. Tabel berikut menjelaskan cakupan region untuk tampilan ini:

Nama tampilan Cakupan resource Cakupan region
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.FAILOVER_HISTORY[_BY_PROJECT] Level project REGION
Ganti kode berikut:
  • Opsional: PROJECT_ID: ID Google Cloud project Anda. Jika tidak ditentukan, project default akan digunakan.
  • REGION: nama region set data apa pun. Misalnya, `region-us`.

Batasan

Batasan berikut berlaku untuk tampilan INFORMATION_SCHEMA.FAILOVER_HISTORY:

  • Tampilan ini hanya berisi peristiwa failover untuk pemesanan. Database ini tidak berisi peristiwa failover untuk setiap set data.

  • Setiap peristiwa failover dicatat di region yang menjadi lokasi utama baru (to_location). Misalnya, jika Anda melakukan failover reservasi dari US ke EU, peristiwa tersebut dicatat di region-eu. Untuk melihat peristiwa failover di kedua arah antara lokasi utama dan sekunder, kueri tampilan secara terpisah di setiap region.

  • Pengalihan paksa tidak menunggu operasi dikonfirmasi di lokasi sekunder, sehingga peristiwa pengalihan paksa tidak memiliki sinyal penyelesaian. Kolom state untuk peristiwa failover berat tetap STARTED, dan kolom end_time tetap NULL, bahkan setelah failover diterapkan.

Contoh

Contoh berikut mengambil peristiwa failover di region-us (dengan US sebagai lokasi tujuan to_location failover) untuk reservasi dan project tertentu, yang diurutkan berdasarkan peristiwa terbaru:

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;

Outputnya mirip dengan hal berikut ini:

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