Datenlokalität mit regionalen Endpunkten konfigurieren

Auf dieser Seite wird beschrieben, wie Sie die Firestore-Clientbibliotheken im Datastore-Modus für die Verwendung eines regionalen Endpunkts konfigurieren.

Wenn Sie Firestore-Clientbibliotheken im Datastore-Modus verwenden, können Sie einen der folgenden Endpunkte verwenden:

  • Globaler Endpunkt: Standardmäßig senden die Firestore-Clientbibliotheken im Datastore-Modus API-Anfragen an einen globalen Dienstendpunkt mit dem Namen datastore.googleapis.com. Der globale Dienstendpunkt leitet die Anfrage an Ihre Datenbank weiter. Beim Routing kann die Anfrage einen regionalen Dienstendpunkt an einem Standort durchlaufen, der sich vom Standort der Datenbank unterscheidet.

  • Regionaler Endpunkt: Ein regionaler Endpunkt erzwingt regionale Einschränkungen. Dadurch werden Daten in einer bestimmten Region gespeichert und verarbeitet. Damit der Dienstendpunkt die Firestore-Anfragen Ihrer Anwendung im Datastore-Modus in derselben Region wie Ihre Datenbank verarbeitet, geben Sie in der Clientbibliothek einen regionalen Endpunkt an.

Regionalen Endpunkt festlegen

Die folgenden Beispiele zeigen, wie Sie einen regionalen Endpunkt festlegen, wenn Sie einen Firestore-Client im Datastore-Modus initialisieren.

Java

Informationen zum Installieren und Verwenden der Clientbibliothek für den Datastore-Modus finden Sie unter Clientbibliotheken im Datastore-Modus. Weitere Informationen finden Sie in der Referenzdokumentation zur Java API im Datastore-Modus.

Richten Sie Standardanmeldedaten für Anwendungen ein, um sich im Datastore-Modus zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten. 


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

Informationen zum Installieren und Verwenden der Clientbibliothek für den Datastore-Modus finden Sie unter Clientbibliotheken im Datastore-Modus. Weitere Informationen finden Sie in der Referenzdokumentation zur Python API im Datastore-Modus.

Richten Sie Standardanmeldedaten für Anwendungen ein, um sich im Datastore-Modus zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten. 

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 regionaler Endpunkte

Firestore im Datastore-Modus unterstützt regionale Endpunkte sowohl für regionale als auch für multiregionale Standorte.

Verwenden Sie das folgende Format, um regionale Endpunkte zu definieren:

Java

  https://REGION_NAME-firestore.googleapis.com:443

Achten Sie darauf, dass die vollständige https-URL verwendet und die Portnummer zusammen mit dem Endpunkt definiert wurde.

Python

  https://REGION_NAME-firestore.googleapis.com

Achten Sie darauf, dass die vollständige https-URL als regionaler Endpunkt festgelegt ist.

Einfach loslegen (Go)

  REGION_NAME-firestore.googleapis.com:443

Achten Sie darauf, dass die Portnummer zusammen mit dem Endpunkt definiert ist.

Ersetzen Sie REGION_NAME durch den Namen eines regionalen oder multiregionalen Hostnamens.

Hier einige Beispiele für Hostnamen:

  • eur3-datastore.googleapis.com
  • nam5-datastore.googleapis.com
  • europe-west6-datastore.googleapis.com
  • asia-northeast2-datastore.googleapis.com

Eine vollständige Liste multiregionaler und regionaler Hostnamen finden Sie unter Standorte von Firestore im Datastore-Modus.

Nächste Schritte