Configura la localidad de los datos con extremos regionales

En esta página, se describe cómo configurar las bibliotecas cliente de Firestore en modo Datastore para usar un extremo regional.

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 la API a un extremo de servicio global llamado datastore.googleapis.com. El extremo de servicio global enruta la solicitud a la base de datos. Durante el enrutamiento, la solicitud puede pasar a través de un extremo de servicio regional en una ubicación diferente de la de tu base de datos.

  • Extremo regional: Un extremo regional aplica restricciones regionales, lo que garantiza que los datos se almacenen y procesen en una región específica. Para garantizar que el extremo de servicio procese las solicitudes de Firestore en modo Datastore de tu app en la misma región que la base de datos, especifica un extremo regional en la biblioteca cliente.

Configura un extremo regional

En los siguientes ejemplos, se muestra cómo configurar un extremo regional cuando inicializas un cliente de Firestore en modo Datastore.

Java

Para obtener información sobre cómo instalar y usar la biblioteca cliente del modo Datastore, consulta Bibliotecas cliente del modo Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API 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. 


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 obtener información sobre cómo instalar y usar la biblioteca cliente del modo Datastore, consulta Bibliotecas cliente del modo Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API 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. 

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 extremos regionales

Firestore en modo Datastore admite extremos regionales para ubicaciones regionales y multirregionales.

Usa el siguiente formato para definir extremos regionales:

Java

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

Asegúrate de usar la URL https completa y de que el número de puerto se defina junto con el extremo.

Python

  https://REGION_NAME-firestore.googleapis.com

Asegúrate de que la URL https completa esté configurada como el extremo regional.

Go

  REGION_NAME-firestore.googleapis.com:443

Asegúrate de que el número de puerto se defina junto con el extremo.

Reemplaza REGION_NAME por el nombre de un nombre de 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 Firestore en las ubicaciones del modo Datastore.

¿Qué sigue?