Nesta página, descrevemos como configurar as bibliotecas de cliente do Firestore no modo Datastore para usar um endpoint regional.
Quando você usa o Firestore em bibliotecas de cliente no modo Datastore, pode 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
. Esse endpoint encaminha a solicitação para o banco de dados. Durante o roteamento, a solicitação pode passar por um endpoint de serviço regional em um local diferente do local do banco de dados.Endpoint regional: um endpoint regional aplica restrições regionais, garantindo 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 aplicativo na mesma região do seu banco de dados, especifique um endpoint regional na biblioteca de 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 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.
Python
Para saber como instalar e usar a biblioteca de cliente para o 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.
Semântica do endpoint regional
O Firestore no modo Datastore oferece suporte a endpoints regionais para locais multirregionais e regionais.
Use o seguinte formato para definir endpoints regionais:
Java
https://REGION_NAME-firestore.googleapis.com:443
Verifique se o URL https
completo é 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 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 de um nome de 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 Firestore em locais do modo Datastore.
A seguir
- Saiba mais sobre o modelo de dados do Firestore no modo Datastore. Consulte Entidades, propriedades e chaves.
- Consulte as Práticas recomendadas para o Firestore no modo Datastore.