Datenspeicherort mit regionalen Endpunkten konfigurieren

Auf dieser Seite wird beschrieben, wie Sie die Clientbibliotheken von Firestore im Datastore-Modus so konfigurieren, dass sie einen regionalen oder multiregionalen Endpunkt 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 Dienstendpunkt mit dem Namen datastore.googleapis.com. Der globale Dienstendpunkt leitet die Anfrage an Ihre Datenbank weiter. Während der Weiterleitung wird die Anfrage möglicherweise über einen Server an einem anderen Standort als dem Ihrer Datenbank gesendet.

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

  • Multiregionaler Endpunkt: Ein multiregionaler Endpunkt erzwingt Einschränkungen, damit Daten in einer bestimmten Google Cloud Multiregion übertragen, gespeichert und verarbeitet werden. Damit der Dienstendpunkt die Anfragen Ihrer App an Firestore im Datastore-Modus in derselben Multiregion wie Ihre Datenbank verarbeitet, geben Sie in der Clientbibliothek einen multiregionalen Endpunkt an.

Regionalen oder multiregionalen Endpunkt festlegen

Die Methode zum Konfigurieren eines regionalen oder multiregionalen Endpunkts ist dieselbe: Sie geben den Endpunktstring beim Initialisieren der Clientbibliothek an. In den folgenden Beispielen wird gezeigt, wie Sie den Endpunktstring mit einem regionalen Endpunkt (datastore.us-central1.rep.googleapis.com) festlegen. Wenn Sie einen multiregionalen Endpunkt verwenden möchten, geben Sie einen multiregionalen Endpunktstring an, der dem Standort Ihrer Datenbank entspricht (z. B. datastore.us.rep.googleapis.com für nam5).

Java

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

Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Firestore 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://datastore.us-central1.rep.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 Referenzdokumentation zur Datastore Mode Python API.

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

from google.cloud import datastore
from google.api_core.client_options import ClientOptions

ENDPOINT = "https://datastore.africa-south1.rep.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 und multiregionaler Endpunkte

Regionale Endpunkte

Firestore im Datastore-Modus unterstützt regionale Endpunkte für die hier aufgeführten regionalen Standorte: Standorte von Firestore im Datastore-Modus.

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

Java

    datastore.REGION_NAME.rep.googleapis.com:443

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

Python

    datastore.REGION_NAME.rep.googleapis.com

Go

    datastore.REGION_NAME.rep.googleapis.com:443

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

Ersetzen Sie REGION_NAME durch den Namen eines regionalen Hostnamens.

Beispiele für Hostnamen:

  • datastore.us-central1.rep.googleapis.com
  • datastore.europe-west1.rep.googleapis.com

Multiregionale Endpunkte

Verwenden Sie für multiregionale Endpunkte us für die Standorte nam5 und nam7 und eu für den Standort eur3 (siehe Multiregionale Standorte).

Java

    datastore.us.rep.googleapis.com:443
    datastore.eu.rep.googleapis.com:443

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

Python

    datastore.us.rep.googleapis.com
    datastore.eu.rep.googleapis.com

Go

    datastore.us.rep.googleapis.com:443
    datastore.eu.rep.googleapis.com:443

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

Standortendpunkte (eingestellt)

Standortendpunkte sind jetzt eingestellt. Verwenden Sie stattdessen regionale oder multiregionale Endpunkte.

Firestore im Datastore-Modus unterstützte zuvor Standortendpunkte mit dem folgenden Format:

Java

  https://REGION_NAME-datastore.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-datastore.googleapis.com

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

Go

  REGION_NAME-datastore.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.

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 Standorte von Firestore im Datastore-Modus.

Nutzung globaler API-Endpunkt einschränken

Um die Verwendung regionaler und multiregionaler Endpunkte zu erzwingen, können Sie die Einschränkung der Organisationsrichtlinie constraints/gcp.restrictEndpointUsage verwenden, um Anfragen an den globalen API-Endpunkt zu blockieren. Weitere Informationen finden Sie unter Endpunktnutzung einschränken.

Nächste Schritte