Configurar la localidad de los datos con puntos finales de ubicación

En esta página se describe cómo configurar las bibliotecas de cliente de Firestore en modo Datastore para usar un endpoint de ubicación.

Cuando usas las bibliotecas de cliente de Firestore en el modo Datastore, puedes usar cualquiera de los siguientes endpoints:

  • Endpoint global: de forma predeterminada, las bibliotecas de cliente de Firestore en modo Datastore envían solicitudes de API a un endpoint de servicio global llamado datastore.googleapis.com. El endpoint de servicio global dirige la solicitud a tu base de datos. Durante el enrutamiento, la solicitud puede pasar por un endpoint de servicio de ubicación en una ubicación diferente a la de tu base de datos.

  • Endpoint de ubicación: un endpoint de ubicación aplica restricciones regionales, lo que asegura que los datos se almacenen y se traten en una región específica. Para garantizar que el endpoint de servicio procese las solicitudes de Firestore en modo Datastore de tu aplicación en la misma región que tu base de datos, especifica un endpoint de ubicación en la biblioteca cliente.

Definir un endpoint de ubicación

En los siguientes ejemplos se muestra cómo definir un endpoint de ubicación al inicializar un cliente de Firestore en modo Datastore.

Java

Para saber cómo instalar y usar la biblioteca de cliente del modo Datastore, consulta Bibliotecas de cliente del modo Datastore. Para obtener más información, consulta la documentación de referencia de la API del modo Datastore Java.

Para autenticarte en el modo Datastore, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo 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

Para saber cómo instalar y usar la biblioteca de cliente del modo Datastore, consulta Bibliotecas de cliente del modo Datastore. Para obtener más información, consulta la documentación de referencia de la API del modo Datastore Python.

Para autenticarte en el modo Datastore, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo 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)

Semántica de los puntos finales de ubicación

Firestore en el modo de Datastore admite endpoints de ubicación para regiones y ubicaciones multirregionales.

Utiliza el siguiente formato para definir los endpoints de ubicación:

Java

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

Asegúrese de que se usa la https URL completa y de que el número de puerto se define junto con el endpoint.

Python

  https://REGION_NAME-firestore.googleapis.com

Asegúrate de que la httpsURL completa esté definida como endpoint de ubicación.

Go

  REGION_NAME-firestore.googleapis.com:443

Asegúrate de que el número de puerto esté definido junto con el endpoint.

Sustituye REGION_NAME por el nombre de un host regional o multirregional.

Estos son algunos ejemplos de nombres de host:

  • eur3-datastore.googleapis.com
  • nam5-datastore.googleapis.com
  • europe-west6-datastore.googleapis.com
  • asia-northeast2-datastore.googleapis.com

Para ver una lista completa de los nombres de host multirregionales y regionales, consulta Ubicaciones de Firestore en el modo de Datastore.

Siguientes pasos