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.
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.
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
- 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.