Configurer la localité des données avec des points de terminaison régionaux

Cette page explique comment configurer les bibliothèques clientes Firestore en mode Datastore pour utiliser un point de terminaison régional.

Lorsque vous utilisez 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 de Firestore en mode Datastore envoient des requêtes API à un point de terminaison du service nommé datastore.googleapis.com. Le point de terminaison du service global achemine la requête vers votre base de données. Pendant le routage, la requête peuvent passer par un point de terminaison de service régional dans un emplacement différent depuis l'emplacement de votre base de données.

  • Point de terminaison régional: un point de terminaison régional applique des restrictions régionales afin que les données soient stockées et traitées dans une région spécifiée. Pour garantir que le point de terminaison du service traite le Firestore de votre application en mode Datastore dans la même région que votre base de données, spécifiez un point de terminaison régional dans la bibliothèque cliente.

Définir un point de terminaison régional

Les exemples suivants montrent comment définir un point de terminaison régional lors de l'initialisation un client Firestore en mode Datastore.

Java

Pour savoir comment installer et utiliser la bibliothèque cliente pour le mode Datastore, consultez Bibliothèques clientes en mode Datastore. Pour en savoir plus, consultez les API Java du mode Datastore documentation de référence.

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. 


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

Pour savoir comment installer et utiliser la bibliothèque cliente pour le mode Datastore, consultez Bibliothèques clientes en mode Datastore. Pour en savoir plus, consultez les API Python du mode Datastore documentation de référence.

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. 

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)

Sémantique des points finaux régionaux

Firestore en mode Datastore accepte les points de terminaison régionaux pour les emplacements régionaux et multirégionaux.

Utilisez le format suivant pour définir des points de terminaison régionaux:

Java

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

Assurez-vous que l'URL https complète est utilisée et que le numéro de port est défini avec le point de terminaison.

Python

  https://REGION_NAME-firestore.googleapis.com

Assurez-vous que l'URL https complète est définie en tant que point de terminaison régional.

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 de noms d'hôte régionaux ou multirégionaux.

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 la section Emplacements Firestore en mode Datastore.

Étape suivante