Configurar a localidade dos dados com endpoints regionais

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

Ao usar o Firestore nas bibliotecas de cliente do 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 uma endpoint de serviço chamado datastore.googleapis.com. O endpoint de serviço global encaminha a solicitação ao banco de dados. Durante o roteamento, a solicitação podem passar por um endpoint de serviço regional em um local diferente do local do banco de dados.

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

Definir um endpoint regional

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 para o modo Datastore, consulte Bibliotecas de cliente no modo Datastore. Para mais informações, consulte a documentação de referência da API Java do modo do 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 para o modo Datastore, consulte Bibliotecas de cliente no modo Datastore. Para mais informações, consulte a API Python do modo Datastore documentação de referência.

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 regional

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

Use o seguinte formato para definir endpoints regionais:

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 completo de https está definido como o endpoint regional.

Go

  REGION_NAME-firestore.googleapis.com:443

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

Substitua REGION_NAME pelo nome dos nomes de host regionais ou multirregionais.

Alguns exemplos de nomes de host são:

  • 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