Configure a localidade dos dados com pontos finais de localização

Esta página descreve como configurar as bibliotecas cliente do Firestore no modo Datastore para usar um ponto final de localização.

Quando usa as bibliotecas cliente do Firestore no modo Datastore, pode usar qualquer um dos seguintes pontos finais:

  • Ponto final global: por predefinição, as bibliotecas de cliente do Firestore no modo Datastore enviam pedidos de API para um ponto final de serviço global denominado datastore.googleapis.com. O ponto final do serviço global encaminha o pedido para a sua base de dados. Durante o planeamento de trajeto, o pedido pode passar por um ponto final do serviço de localização numa localização diferente da localização da sua base de dados.

  • Ponto final de localização: um ponto final de localização aplica restrições regionais, garantindo que os dados são armazenados e tratados numa região especificada. Para garantir que o ponto final do serviço processa os pedidos do Firestore no modo Datastore da sua app na mesma região que a sua base de dados, especifique um ponto final de localização na biblioteca de cliente.

Defina um ponto final de localização

Os exemplos seguintes mostram como definir um ponto final de localização quando inicializa um cliente do Firestore no modo Datastore.

Java

Para saber como instalar e usar a biblioteca cliente para o modo Datastore, consulte o artigo Bibliotecas 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 as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure 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 cliente para o modo Datastore, consulte o artigo Bibliotecas 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 as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure 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 de ponto final de localização

O Firestore no modo Datastore suporta pontos finais de localização para localizações regionais e multirregionais.

Use o seguinte formato para definir pontos finais de localização:

Java

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

Certifique-se de que usa o URL https completo e que o número da porta está definido juntamente com o ponto final.

Python

  https://REGION_NAME-firestore.googleapis.com

Certifique-se de que o https URL completo está definido como o ponto final de localização.

Ir

  REGION_NAME-firestore.googleapis.com:443

Certifique-se de que o número da porta está definido juntamente com o ponto final.

Substitua REGION_NAME pelo nome de um nome de anfitrião regional ou multirregional.

Seguem-se alguns exemplos de nomes de anfitrião:

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

Para ver uma lista completa de nomes de anfitrião regionais e multirregionais, consulte o artigo Localizações do Firestore no modo Datastore.

O que se segue?