Configurar a localidade dos dados com endpoints locais

Nesta página, descrevemos como configurar as bibliotecas de cliente do Firestore no modo Datastore para usar um endpoint regional.

Ao usar as bibliotecas de cliente do Firestore no modo Datastore, é possível usar um dos seguintes endpoints:

  • Endpoint global: por padrão, as bibliotecas de cliente do Firestore no modo Datastore enviam solicitações de API para um endpoint de serviço global chamado datastore.googleapis.com. O endpoint de serviço global roteia a solicitação para seu banco de dados. Durante o roteamento, a solicitação pode passar por um endpoint de serviço de localização em um local diferente do local do banco de dados.

  • Endpoint de local: um endpoint de local impõe restrições regionais, garantindo que os dados sejam armazenados e tratados em uma região especificada. Para garantir que o endpoint de serviço processe as solicitações do Firestore no modo Datastore do seu app na mesma região que o banco de dados, especifique um endpoint regional na biblioteca de cliente.

Definir um endpoint de local

Os exemplos a seguir mostram como definir um endpoint regional ao inicializar um cliente do Firestore no modo Datastore.

Java

Para saber como instalar e usar a biblioteca de cliente do modo Datastore, consulte Bibliotecas de cliente do modo Datastore. Para mais informações, consulte a documentação de referência da API Java do modo Datastore.

Para autenticar no modo Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento 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 como instalar e usar a biblioteca de cliente do modo Datastore, consulte Bibliotecas de cliente do modo Datastore. Para mais informações, consulte a documentação de referência da API Python do modo Datastore.

Para autenticar no modo Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento 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 do endpoint de local

O Firestore no modo Datastore é compatível com endpoints de local para locais regionais e multirregionais.

Use o seguinte formato para definir endpoints de local:

Java

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

Verifique se o URL https completo está sendo usado e se o número da porta está definido com o endpoint.

Python

  https://REGION_NAME-firestore.googleapis.com

Verifique se o URL https completo está definido como o endpoint de localização.

Go

  REGION_NAME-firestore.googleapis.com:443

Verifique se o número da porta está definido junto com o endpoint.

Substitua REGION_NAME pelo nome de um nome do host regional ou multirregional.

Alguns exemplos de nomes de host:

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

Para uma lista completa de nomes de host multirregionais e regionais, consulte Locais do Firestore no modo Datastore.

A seguir