Method: hive.v1.projects.catalogs.failover

Melakukan failover katalog ke region replika utama baru.

Permintaan HTTP


POST https://biglake.googleapis.com/hive/v1/{name=projects/*/catalogs/*}:failover

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
name

string

Wajib. Nama katalog dalam bentuk "projects/{projectId}/catalogs/{catalogId}"

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "primaryReplica": string,
  "validateOnly": boolean,
  "conditionalFailoverReplicationTime": string
}
Kolom
primaryReplica

string

Wajib. Region yang ditetapkan sebagai region replika utama baru. Misalnya, "us-east1". Nilai ini harus berupa salah satu region replika dalam daftar replika katalog yang ditandai sebagai "sekunder".
validateOnly

boolean

Opsional. Jika disetel, hanya validasi permintaan, tetapi jangan lakukan update. Hal ini dapat digunakan untuk memeriksa replicationTime kapan saja, termasuk sebelum melakukan failover.
conditionalFailoverReplicationTime

string (Timestamp format)

Opsional. Jika tidak disetel, tunggu hingga semua data dari region sumber direplikasi ke region utama baru sebelum menyelesaikan failover, tanpa kehilangan data (juga disebut "soft failover"). Jika disetel, failover akan segera dilakukan, dan menerima hilangnya data apa pun yang di-commit di region sumber setelah stempel waktu ini, yang belum direplikasi. Jika ada data yang di-commit sebelum waktu ini belum direplikasi, failover tidak akan dilakukan dan error akan ditampilkan (juga disebut "failover berat").

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

Isi respons

Pesan respons untuk catalogs.failover.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "replicationTime": string
}
Kolom
replicationTime

string (Timestamp format)

Hanya output. Stempel waktu minimum yang semua namespace dan metadata tabelnya telah direplikasi di region yang ditentukan sebagai primaryReplica baru. Beberapa resource mungkin telah direplikasi lebih baru dari stempel waktu ini. Jika kosong, replika baru saja dibuat dan belum diinisialisasi sepenuhnya.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.