Datenspeicherort mit regionalen Endpunkten konfigurieren

Auf dieser Seite wird beschrieben, wie Sie Clientbibliotheken für Firestore im Datastore-Modus konfigurieren um einen regionalen Endpunkt zu verwenden.

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

  • Globaler Endpunkt: Standardmäßig senden die Clientbibliotheken von Firestore im Datastore-Modus API-Anfragen an einen globalen Endpunkt. Dienstendpunkt mit dem Namen datastore.googleapis.com. Der globale Dienstendpunkt leitet die Anfrage an Ihre Datenbank weiter. Während der Weiterleitung wird die Anfrage durch einen regionalen Dienstendpunkt an einem anderen Standort geleitet wird, aus Ihrer Datenbank aus.

  • Regionaler Endpunkt: Ein regionaler Endpunkt erzwingt regionale Einschränkungen, damit Daten in einer bestimmten Region gespeichert und verarbeitet werden. Damit der Dienstendpunkt die Firestore-im-Datastore-Modus-Anfragen Ihrer App 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 bei der Initialisierung einen regionalen Endpunkt festlegen einen Firestore-Client im Datastore-Modus.

Java

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

Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich beim 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 hier. Weitere Informationen finden Sie in der Python API im Datastore-Modus Referenzdokumentation.

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 für regionale und 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 wird und die Portnummer zusammen mit dem Endpunkt definiert ist.

Python

  https://REGION_NAME-firestore.googleapis.com

Die vollständige https-URL muss als regionaler Endpunkt festgelegt sein.

Go

  REGION_NAME-firestore.googleapis.com:443

Die Portnummer muss zusammen mit dem Endpunkt definiert sein.

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 der multiregionalen und regionalen Hostnamen finden Sie unter Firestore an Standorten im Datastore-Modus.

Nächste Schritte