Endpoint regional dan global
Halaman ini menjelaskan endpoint Bigtable, menjelaskan hal-hal yang harus Anda pertimbangkan sebelum menggunakannya, dan menunjukkan cara menyetel endpoint menggunakan CLI cbt.
Untuk mengirim permintaan ke Bigtable, Anda dapat menggunakan endpoint layanan global atau regional. Endpoint regional untuk Bigtable memastikan bahwa data instance disimpan dan diproses di region Bigtable tempat data berada. Anda mungkin perlu menggunakan endpoint regional untuk Bigtable di wilayah geografis tertentu untuk mendukung kebutuhan keamanan dan kepatuhan project Anda.
Sebelum membaca dokumen ini, pahami Instance, cluster, dan node serta Profil aplikasi.
Konsep utama meliputi:
Endpoint layanan: URL dasar yang menentukan alamat jaringan layanan API. Bigtable memiliki endpoint global dan regional.
Endpoint global: memungkinkan Bigtable menyimpan dan merutekan data dalam instance Bigtable ke region mana pun yang berisi salah satu cluster instance. Endpoint global untuk Cloud Bigtable API (Data API) adalah
bigtable.googleapis.com. Endpoint Data API default mengakses endpoint global.Endpoint regional: menerapkan batasan regional, memastikan bahwa Bigtable menyimpan dan memproses data di region tertentu. Anda dapat menggunakan endpoint regional hanya dengan Cloud Bigtable API (Data API). Bigtable tidak mendukung endpoint regional untuk Cloud Bigtable Admin API.
Kapan harus menggunakan endpoint regional
Manfaat menggunakan endpoint regional Bigtable dibandingkan endpoint global adalah endpoint regional memberikan isolasi dan perlindungan regional untuk memenuhi persyaratan keamanan, kepatuhan, dan peraturan.
Namun, endpoint regional tidak mendukung Data Boost atau Cloud Bigtable Admin API. Selain itu, Anda tidak dapat mengonfigurasi Bigtable untuk mencapai persentase waktu beroperasi bulanan >=99,999% saat menggunakan endpoint regional. Untuk mengetahui informasi selengkapnya, lihat bagian Pertimbangan untuk menggunakan endpoint regional dalam dokumen ini.
Kapan harus menggunakan endpoint global
Gunakan endpoint global dalam kasus berikut:
- Anda tidak memiliki persyaratan pembatasan regional yang mengharuskan Anda menggunakan endpoint regional.
- Anda harus menggunakan Data Boost.
- Anda harus menggunakan Cloud Bigtable Admin API.
- Anda memerlukan persentase waktu beroperasi bulanan minimal 99,999%.
Pertimbangan untuk menggunakan endpoint regional
Jika Anda menggunakan endpoint regional, pertimbangkan faktor-faktor berikut:
Lokasi cluster
Sebelum dapat menggunakan endpoint regional, Anda harus membuat instance dengan minimal satu cluster di region tempat Anda ingin mengisolasi data. Endpoint regional Bigtable tersedia di region Bigtable tertentu. Untuk mengetahui daftar region yang tersedia, lihat Endpoint layanan regional.
Anda hanya dapat menggunakan endpoint regional yang termasuk dalam region tempat Anda ingin mengisolasi data. Misalnya, jika cluster berada di region us-central1, Anda tidak dapat menggunakan bigtable.us-west1.rep.googleapis.com untuk melayani permintaan.
Jika Anda mencoba menggunakan endpoint regional untuk mengakses cluster yang berada di region lain, Bigtable akan menolak permintaan dengan pesan error FAILED_PRECONDITION yang menyatakan bahwa tidak ada cluster yang dapat diakses menggunakan cluster dan endpoint yang ditentukan. Untuk mengetahui informasi selengkapnya tentang pesan error ini, lihat Kode status Bigtable.
Profil aplikasi
Setelah menetapkan endpoint regional, Anda harus menggunakan profil aplikasi yang dikonfigurasi untuk merutekan permintaan ke cluster di region endpoint.
Jika Anda mencoba menggunakan profil aplikasi yang dikonfigurasi untuk mengirim operasi tulis hanya ke cluster (menggunakan perutean cluster tunggal) atau cluster di region yang berbeda dari endpoint (menggunakan perutean multi-cluster), Anda akan menerima pesan error FAILED_PRECONDITION. Untuk mengetahui informasi selengkapnya tentang perutean
cluster, lihat Kebijakan perutean.
Jika Anda menggunakan profil aplikasi yang dikonfigurasi untuk merutekan ke cluster mana pun dalam instance untuk ketersediaan tinggi (HA), dan Anda juga menggunakan endpoint regional, maka endpoint regional memastikan bahwa semua permintaan hanya dirutekan ke cluster di regionnya, meskipun instance memiliki cluster di region lain. Failover otomatis dibatasi, sehingga permintaan hanya ditayangkan dari cluster di region endpoint.
Pertimbangkan contoh saat Anda mengirim permintaan menggunakan profil aplikasi
yang dikonfigurasi untuk perutean multi-cluster ke instance yang memiliki cluster di
us-west1-a (Oregon), us-west1-b (Oregon), dan us-central1-a (Iowa). Jika Anda
mengirim permintaan ini ke endpoint regional bigtable.us-central1.rep.googleapis.com, semua permintaan akan ditayangkan oleh us-central1-a meskipun Anda tidak mengonfigurasi ulang profil aplikasi. Permintaan yang tidak dapat diproses oleh us-central1-a akan gagal.
Replikasi
Endpoint regional tidak memengaruhi atau mencegah replikasi. Jika Anda mengonfigurasi endpoint regional di Region A, lalu menambahkan cluster ke instance di Region B, data Anda akan direplikasi ke Region B seperti saat Anda menggunakan endpoint global.
Untuk menghindari replikasi data ke region lain, buat cluster hanya di region yang diinginkan.
Untuk mencegah pengguna di organisasi Anda menambahkan cluster di luar region endpoint, Anda dapat menetapkan kebijakan organisasi yang menggunakan batasan lokasi.
Ketersediaan
Saat menggunakan endpoint regional, Anda tidak dapat mengonfigurasi Bigtable untuk mencapai persentase waktu beroperasi bulanan >=99,999%. Waktu beroperasi bulanan >=99,999% memerlukan failover otomatis permintaan di seluruh batas regional. Endpoint regional mencegah failover otomatis karena membatasi semua permintaan ke satu region. Untuk mengetahui informasi selengkapnya tentang persentase waktu beroperasi bulanan, lihat perjanjian tingkat layanan (SLA) Bigtable.
Semantik endpoint regional
Endpoint regional mengikuti format
bigtable.REGION.rep.googleapis.com, dengan
REGION adalah nama region Google Cloud , seperti
northamerica-northeast2.
Misalnya, jika Anda ingin mengisolasi data Anda di region Iowa, karena nama region untuk Iowa adalah us-central1, URL endpoint regional untuk region Iowa adalah bigtable.us-central1.rep.googleapis.com.
Menentukan endpoint regional
Anda dapat menentukan endpoint regional Bigtable menggunakan cbt CLI,
atau library klien Cloud Bigtable.
cbt
Untuk menentukan endpoint regional dan mengganti endpoint global menggunakan CLI cbt,
Anda dapat menggunakan opsi --data-endpoint dalam permintaan, atau menambahkan
berikut ke file ~/.cbtrc. Untuk mengetahui informasi tambahan tentang cara membuat file ~/.cbtrc, lihat referensi cbt CLI.
data-endpoint = https://bigtable.REGION.rep.googleapis.com/
Ganti REGION dengan region tempat Anda ingin menetapkan endpoint regional, seperti us-central1 atau europe-west1.
Misalnya, untuk mengonfigurasi endpoint regional sebagai us-central1, tambahkan ini ke
file ~/.cbtrc:
data-endpoint = https://bigtable.us-central1.rep.googleapis.com/
Menentukan endpoint global
cbt
Untuk menentukan endpoint pengiriman global, kirim permintaan Anda tanpa menggunakan opsi
--data-endpoint. Jika sebelumnya Anda menambahkan baris data-endpoint
ke file ~/.cbtrc, hapus baris tersebut.
Membatasi penggunaan endpoint API global
Untuk membantu menerapkan penggunaan endpoint regional, gunakan batasan kebijakan organisasi constraints/gcp.restrictEndpointUsage untuk memblokir permintaan ke endpoint API global. Untuk mengetahui informasi selengkapnya, baca artikel Membatasi penggunaan endpoint.