Auf dieser Seite wird beschrieben, wie Sie die Clientbibliotheken von Firestore im Datastore-Modus für die Verwendung eines Standortendpunkts konfigurieren.
Wenn Sie Clientbibliotheken für Firestore im Datastore-Modus verwenden, können Sie einen der folgenden Endpunkte verwenden:
Globaler Endpunkt: Standardmäßig senden die Clientbibliotheken für Firestore im Datastore-Modus API-Anfragen an einen globalen Dienstendpunkt namens
datastore.googleapis.com
. Der globale Dienstendpunkt leitet die Anfrage an Ihre Datenbank weiter. Während des Routings kann die Anfrage einen Standortdienstendpunkt an einem anderen Standort als dem Ihrer Datenbank durchlaufen.Standortbezogener Endpunkt: Ein standortbezogener Endpunkt erzwingt regionale Einschränkungen, damit Daten in einer bestimmten Region gespeichert und verarbeitet werden. Damit der Dienstendpunkt die Firestore-Anfragen im Datastore-Modus Ihrer App in derselben Region wie Ihre Datenbank verarbeitet, geben Sie in der Clientbibliothek einen Standortendpunkt an.
Standortendpunkt festlegen
In den folgenden Beispielen wird gezeigt, wie Sie beim Initialisieren eines Firestore im Datastore-Modus-Clients einen Standortendpunkt festlegen.
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 im Datastore-Modus zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
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-Modus-Python-API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich im Datastore-Modus zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Semantik von Standortendpunkten
Firestore im Datastore-Modus unterstützt Standortendpunkte für regionale und multiregionale Standorte.
Verwenden Sie das folgende Format, um Standortendpunkte 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
Achten Sie darauf, dass die vollständige https
-URL als Standortendpunkt festgelegt ist.
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.
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 im Datastore-Modus – Standorte.
Nächste Schritte
- Informationen zum Datenmodell von Firestore im Datastore-Modus. Weitere Informationen finden Sie unter Entitäten, Attribute und Schlüssel.
- Best Practices für Firestore im Datastore-Modus