Halaman ini menjelaskan cara mengonfigurasi library klien Firestore dalam mode Datastore untuk menggunakan endpoint lokasi.
Saat menggunakan library klien Firestore dalam mode Datastore, Anda dapat menggunakan salah satu endpoint berikut:
Endpoint global: Secara default, library klien Firestore dalam mode Datastore mengirim permintaan API ke endpoint layanan global bernama
datastore.googleapis.com
. Endpoint layanan global mengarahkan permintaan ke database Anda. Selama perutean, permintaan dapat melewati endpoint layanan lokasi di lokasi yang berbeda dari lokasi database Anda.Endpoint lokasi: Endpoint lokasi menerapkan batasan regional, sehingga memastikan bahwa data disimpan dan diproses di region tertentu. Untuk menjamin bahwa endpoint layanan memproses permintaan Firestore dalam mode Datastore aplikasi Anda di region yang sama dengan database Anda, tentukan endpoint lokasi di library klien.
Menetapkan endpoint lokasi
Contoh berikut menunjukkan cara menyetel endpoint lokasi saat Anda menginisialisasi klien Firestore dalam mode Datastore.
Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk mode Datastore, lihat library klien mode Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Java mode Datastore.
Untuk melakukan autentikasi ke mode Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk mode Datastore, lihat library klien mode Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Python mode Datastore.
Untuk melakukan autentikasi ke mode Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Semantik endpoint lokasi
Firestore dalam mode Datastore mendukung endpoint lokasi untuk lokasi region dan multi-region.
Gunakan format berikut untuk menentukan endpoint lokasi:
Java
https://REGION_NAME-firestore.googleapis.com:443
Pastikan URL https
lengkap digunakan dan nomor port ditentukan bersama dengan endpoint.
Python
https://REGION_NAME-firestore.googleapis.com
Pastikan URL https
lengkap ditetapkan sebagai endpoint lokasi.
Go
REGION_NAME-firestore.googleapis.com:443
Pastikan nomor port ditentukan bersama dengan endpoint.
Ganti REGION_NAME dengan nama host regional atau multi-regional.
Beberapa contoh nama host adalah:
eur3-datastore.googleapis.com
nam5-datastore.googleapis.com
europe-west6-datastore.googleapis.com
asia-northeast2-datastore.googleapis.com
Untuk mengetahui daftar lengkap nama host multi-region dan regional, lihat Lokasi Firestore dalam mode Datastore.
Langkah berikutnya
- Pelajari model data Firestore dalam mode Datastore. Lihat Entity, properti, dan kunci.
- Lihat Praktik terbaik untuk Firestore dalam mode Datastore.