Mengonfigurasi lokalitas data dengan endpoint regional

Halaman ini menjelaskan cara mengonfigurasi library klien Firestore dalam mode Datastore untuk menggunakan endpoint regional.

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 me-rutekan permintaan ke database Anda. Selama pemilihan rute, permintaan mungkin melewati endpoint layanan regional di lokasi yang berbeda dengan lokasi database Anda.

  • Endpoint regional: Endpoint regional menerapkan batasan regional, yang memastikan data disimpan dan diproses di region yang ditentukan. Untuk menjamin bahwa endpoint layanan memproses permintaan Firestore dalam mode Datastore aplikasi Anda di region yang sama dengan database Anda, tentukan endpoint regional di library klien.

Menetapkan endpoint regional

Contoh berikut menunjukkan cara menetapkan endpoint regional saat Anda melakukan inisialisasi 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 Java API mode Datastore.

Untuk melakukan autentikasi ke mode Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal. 


import com.google.cloud.datastore.Datastore;
import com.google.cloud.datastore.DatastoreOptions;

public class RegionalEndpoint {

  public Datastore createClient() throws Exception {
    // Instantiates a client
    DatastoreOptions options =
        DatastoreOptions.newBuilder().setHost("https://nam5-datastore.googleapis.com").build();
    Datastore datastore = options.getService();
    return datastore;
  }
}

Python

Untuk mempelajari cara menginstal dan menggunakan library klien untuk mode Datastore, lihat Library klien mode Datastore. Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi Python API mode Datastore.

Untuk melakukan autentikasi ke mode Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal. 

ENDPOINT = "https://eur3-datastore.googleapis.com"
client_options = ClientOptions(api_endpoint=ENDPOINT)
client = datastore.Client(client_options=client_options)

query = client.query(kind="Task")
results = list(query.fetch())
for r in results:
    print(r)

Semantik endpoint regional

Firestore dalam mode Datastore mendukung endpoint regional untuk lokasi region dan multi-region.

Gunakan format berikut untuk menentukan endpoint regional:

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 regional.

Go

  REGION_NAME-firestore.googleapis.com:443

Pastikan nomor port ditentukan bersama dengan endpoint.

Ganti REGION_NAME dengan nama 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 selanjutnya