En esta página, se describe cómo configurar las bibliotecas cliente de Firestore en modo Datastore para usar un extremo de ubicación.
Cuando usas las bibliotecas cliente de Firestore en modo Datastore, puedes usar cualquiera de los siguientes extremos:
Extremo global: De forma predeterminada, las bibliotecas cliente de Firestore en modo Datastore envían solicitudes a un extremo de servicio global llamado
datastore.googleapis.com
. El extremo de servicio global enruta la solicitud a tu base de datos. Durante el enrutamiento, es posible que la solicitud pase por un extremo de servicio de ubicación en una ubicación diferente de la de tu base de datos.Extremo de ubicación: Un extremo de ubicación aplica restricciones regionales, lo que garantiza que los datos se almacenen y procesen en una región especificada. Para garantizar que el extremo del servicio procese las solicitudes de Firestore en modo Datastore de tu app en la misma región que tu base de datos, especifica un extremo de ubicación en la biblioteca cliente.
Cómo establecer un extremo de ubicación
En los siguientes ejemplos, se muestra cómo configurar un extremo de ubicación cuando inicializas un cliente de Firestore en modo Datastore.
Java
Para obtener información sobre cómo instalar y usar la biblioteca cliente en modo Datastore, consulta las bibliotecas cliente en modo Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Java del modo Datastore.
Para autenticarte en el modo Datastore, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Para obtener información sobre cómo instalar y usar la biblioteca cliente en modo Datastore, consulta las bibliotecas cliente en modo Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Python del modo Datastore.
Para autenticarte en el modo Datastore, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Semántica de los extremos de ubicación
Firestore en modo Datastore admite extremos geográficos para ubicaciones regionales y multirregionales.
Usa el siguiente formato para definir los extremos de ubicación:
Java
https://REGION_NAME-firestore.googleapis.com:443
Asegúrate de usar la URL https
completa y de que el número de puerto esté definido junto con el extremo.
Python
https://REGION_NAME-firestore.googleapis.com
Asegúrate de que la URL https
completa esté establecida como el extremo de ubicación.
Go
REGION_NAME-firestore.googleapis.com:443
Asegúrate de que el número de puerto esté definido junto con el extremo.
Reemplaza 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 obtener una lista completa de los nombres de host regionales y multirregionales, consulta Ubicaciones de Firestore en modo Datastore.
¿Qué sigue?
- Obtén información sobre el modelo de datos de Firestore en modo Datastore. Consulta Entidades, propiedades y claves.
- Consulta las prácticas recomendadas para Firestore en modo Datastore.