Cette page explique comment configurer les bibliothèques clientes Firestore en mode Datastore pour utiliser un point de terminaison localisé.
Lorsque vous utilisez les bibliothèques clientes Firestore en mode Datastore, vous pouvez utiliser l'un des points de terminaison suivants :
Point de terminaison global : par défaut, les bibliothèques clientes Firestore en mode Datastore envoient des requêtes d'API à un point de terminaison de service global nommé
datastore.googleapis.com
. Le point de terminaison du service mondial achemine la requête vers votre base de données. Lors du routage, la requête peut passer par un point de terminaison de service de localisation dans un emplacement différent de celui de votre base de données.Point de terminaison géographique : un point de terminaison géographique applique des restrictions régionales, en veillant à ce que les données soient stockées et traitées dans une région spécifique. Pour garantir que le point de terminaison de service traite les requêtes Firestore en mode Datastore de votre application dans la même région que votre base de données, spécifiez un point de terminaison géographique dans la bibliothèque cliente.
Définir un point de terminaison localisé
Les exemples suivants montrent comment définir un point de terminaison géographique lorsque vous initialisez un client Firestore en mode Datastore.
Java
Pour savoir comment installer et utiliser la bibliothèque cliente pour le mode Datastore, consultez la page Bibliothèques clientes en mode Datastore. Pour en savoir plus, consultez la documentation de référence de l'API Java en mode Datastore.
Pour vous authentifier auprès du mode Datastore, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour savoir comment installer et utiliser la bibliothèque cliente pour le mode Datastore, consultez la page Bibliothèques clientes en mode Datastore. Pour en savoir plus, consultez la documentation de référence de l'API Python en mode Datastore.
Pour vous authentifier auprès du mode Datastore, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Sémantique des points de terminaison utilisant la localisation
Firestore en mode Datastore est compatible avec les points de terminaison géographiques pour les emplacements régionaux et multirégionaux.
Utilisez le format suivant pour définir les points de terminaison de localisation :
Java
https://REGION_NAME-firestore.googleapis.com:443
Assurez-vous d'utiliser l'URL https
complète et de définir le numéro de port avec le point de terminaison.
Python
https://REGION_NAME-firestore.googleapis.com
Assurez-vous que l'URL https
complète est définie comme point de terminaison géographique.
Go
REGION_NAME-firestore.googleapis.com:443
Assurez-vous que le numéro de port est défini avec le point de terminaison.
Remplacez REGION_NAME par le nom d'un nom d'hôte régional ou multirégional.
Voici quelques exemples de noms d'hôte :
eur3-datastore.googleapis.com
nam5-datastore.googleapis.com
europe-west6-datastore.googleapis.com
asia-northeast2-datastore.googleapis.com
Pour obtenir la liste complète des noms d'hôte multirégionaux et régionaux, consultez Emplacements Firestore en mode Datastore.
Étapes suivantes
- Découvrez le modèle de données Firestore en mode Datastore. Consultez Entités, propriétés et clés.
- Consultez les bonnes pratiques pour Firestore en mode Datastore.