Esta página foi traduzida pela API Cloud Translation.

Locais

Ao provisionar uma instância do Firestore, você precisa escolher um local. Para reduzir a latência e aumentar a disponibilidade, armazene os dados próximos dos usuários e serviços que precisam deles.

Você pode criar vários bancos de dados no projeto, cada um com a própria configuração de local.

Depois de provisionar uma instância de banco de dados, não será possível mudar a configuração de local.

Tipos de locais

Armazene seus dados do Firestore em um local multirregional ou um local regional.

Locais multirregionais

Selecione um local multirregional para aumentar a disponibilidade e a durabilidade do seu banco de dados.

Um local multirregional consiste em um conjunto definido de regiões com várias réplicas do banco de dados armazenadas. As réplicas são de leitura/gravação e contêm todos os dados no banco de dados ou são de testemunha e não mantêm um conjunto completo de dados, mas participam da replicação.

Ao replicar os dados entre várias regiões, esses dados continuam disponíveis mesmo com a perda de uma região inteira. Dentro de uma região, os dados são replicados em zonas, para que possam continuar disponíveis mesmo com a perda de uma delas.

O Firestore é compatível com os seguintes locais multirregionais:

Nome multirregional	Descrição multirregional	Regiões de leitura/gravação	Região de testemunha
`eur3`	Europa	`europe-west1` (Bélgica), `europe-west4` (Países Baixos)	`europe-north1` (Finlândia)
`nam5`	Estados Unidos	`us-central1` (Iowa), `us-central2` (Oklahoma: região privada do GCP)	`us-east1` (Carolina do Sul)

Se o projeto já tiver um app do App Engine com um local us-central ou europe-west, o banco de dados do padrão do Firestore será considerado multirregional.

Locais regionais

Um local regional é um lugar geográfico específico, como a Carolina do Sul. Os dados em um local regional são replicados em várias zonas em uma região. A distância entre todos os locais regionais é de pelo menos 160 quilômetros.

Selecione um local regional para reduzir os custos, diminuir a latência de gravação se o aplicativo for sensível à latência ou para compartilhar o local com outros recursos do Google Cloud.

O Firestore é compatível com os seguintes locais de recursos regionais:

	Nome da região	Descrição da região
América do Norte
	`us-west1`	Oregon
	`us-west2`	Los Angeles
	`us-west3`	Salt Lake City
	`us-west4`	Las Vegas
	`us-central1` Este local não é compatível com o App Engine. Se você planeja usar o App Engine, escolha um local diferente.	Iowa
	`northamerica-northeast1`	Montreal
	`northamerica-northeast2` Este local não é compatível com o App Engine. Se você planeja usar o App Engine, escolha um local diferente.	Toronto
	`northamerica-south1` Este local não é compatível com o App Engine. Se você planeja usar o App Engine, escolha um local diferente.	Queretaro
	`us-east1`	Carolina do Sul
	`us-east4`	Norte da Virgínia
	`us-east5` Este local não é compatível com o App Engine. Se você planeja usar o App Engine, escolha um local diferente.	Columbus
	`us-south1` Este local não é compatível com o App Engine. Se você planeja usar o App Engine, escolha um local diferente.	Dallas
América do Sul
	`southamerica-west1` Este local não é compatível com o App Engine. Se você planeja usar o App Engine, escolha um local diferente.	Santiago
	`southamerica-east1`	São Paulo
Europa
	`europe-west2`	Londres
	`europe-west1` Este local não é compatível com o App Engine. Se você planeja usar o App Engine, escolha um local diferente.	Bélgica
	`europe-west4` Este local não é compatível com o App Engine. Se você planeja usar o App Engine, escolha um local diferente.	Países Baixos
	`europe-west8` Este local não é compatível com o App Engine. Se você planeja usar o App Engine, escolha um local diferente.	Milão
	`europe-southwest1` Este local não é compatível com o App Engine. Se você planeja usar o App Engine, escolha um local diferente.	Madri
	`europe-west9` Este local não é compatível com o App Engine. Se você planeja usar o App Engine, escolha um local diferente.	Paris
	`europe-west12` Este local não é compatível com o App Engine. Se você planeja usar o App Engine, escolha um local diferente.	Turim
	`europe-west10` Este local não é compatível com o App Engine. Se você planeja usar o App Engine, escolha um local diferente.	Berlim
	`europe-west3`	Frankfurt
	`europe-north1` Este local não é compatível com o App Engine. Se você planeja usar o App Engine, escolha um local diferente.	Finlândia
	`europe-central2`	Varsóvia
	`europe-west6`	Zurique
Oriente Médio
	`me-central1` Este local não é compatível com o App Engine. Se você planeja usar o App Engine, escolha um local diferente.	Doha
	`me-central2` Este local não é compatível com o App Engine. Se você planeja usar o App Engine, escolha um local diferente.	Damã
	`me-west1` Este local não é compatível com o App Engine. Se você planeja usar o App Engine, escolha um local diferente.	Tel Aviv
Ásia
	`asia-south1`	Mumbai
	`asia-south2` Este local não é compatível com o App Engine. Se você planeja usar o App Engine, escolha um local diferente.	Délhi
	`asia-southeast1`	Singapura
	`asia-southeast2`	Jacarta
	`asia-east2`	Hong Kong
	`asia-east1`	Taiwan
	`asia-northeast1`	Tóquio
	`asia-northeast2`	Osaka
	`asia-northeast3`	Seul
Austrália
	`australia-southeast1`	Sydney
	`australia-southeast2` Este local não é compatível com o App Engine. Se você planeja usar o App Engine, escolha um local diferente.	Melbourne
África
	`africa-south1` Este local não é compatível com o App Engine. Se você planeja usar o App Engine, escolha um local diferente.	Johannesburgo

SLA do local

Seu tipo de local do Firestore determina a porcentagem de tempo de atividade do Contrato de nível de serviço (SLA) (em inglês):

Serviço coberto	Porcentagem de tempo de atividade mensal
Multirregião do Firestore	>= 99,999%
Região do Firestore	>= 99,99%

Preços do local

Seu local do Firestore determina o custo das operações do banco de dados.

Para uma explicação detalhada dos preços por região e por tipo de região, consulte informações sobre o faturamento do Firestore.

Conferir o local dos bancos de dados

Use um dos seguintes métodos para conferir a configuração de local dos seus bancos de dados:

Execute o comando gcloud firestore databases list.
Abra a lista de bancos de dados no console do Google Cloud. O local de cada banco de dados está na coluna "Local".
No console do Firebase, acesse a guia Dados do Firestore para conferir a lista de instâncias do banco de dados e os respectivos locais.

Possíveis dependências de local devido a "local para recursos padrão do Google Cloud"

O "local para recursos padrão do Google Cloud" é a configuração de local para todos os recursos do projeto associados ao Google App Engine, incluindo:

instância de banco de dados padrão do Firestore
bucket padrão do Cloud Storage para Firebase com o formato de nome *.appspot.com
Google Cloud Scheduler usado especificamente com funções programadas de 1ª geração.

Este "local para recursos padrão do Google Cloud" é uma configuração imutável. Além disso, ao definir o local para um dos recursos associados, você define indiretamente o local para todos eles devido à associação comum com o App Engine.

No entanto, com muitas mudanças no ecossistema do Firebase e do Google Cloud ao longo dos anos, as associações de recursos ao App Engine mudaram. Mais especificamente, a partir de 30 de outubro de 2024, todos os buckets padrão do Cloud Storage para Firebase recém-provisionados têm o formato de nome *.firebasestorage.app e não são associados ao App Engine.

Confira a seguir os detalhes do que mudou nas possíveis dependências de local:

Desde 30 de outubro de 2024, se a instância padrão do Firestore e o bucket padrão do Cloud Storage para Firebase não estiverem provisionados ainda:
- O provisionamento da instância padrão do Firestore define o local para qualquer app futuro do App Engine provisionado no projeto. No entanto, ele não determina o local do futuro bucket padrão do Cloud Storage.
- O provisionamento do bucket padrão do Cloud Storage não provisiona mais um app do App Engine. Portanto, o local do bucket padrão do Cloud Storage não determina o local da futura instância padrão do Firestore.
Desde 30 de outubro de 2024, se a instância padrão do Firestore já foi provisionada, mas o bucket padrão do Cloud Storage para Firebase não foi provisionado:
- A instância padrão do Firestore não determina o local do futuro bucket padrão do Cloud Storage (*.firebasestorage.app).
Desde 30 de outubro de 2024, se o bucket padrão do Cloud Storage para Firebase já foi provisionado (especificamente, o bucket *.appspot.com), mas a instância padrão do Firestore não foi provisionada:
- Quando o bucket padrão do Cloud Storage (*.appspot.com) era provisionado, um app do App Engine também era provisionado e, consequentemente, o local da futura instância padrão do Firestore era definido naquele momento. Mesmo que você exclua o bucket *.appspot.com, não será possível excluir o app do App Engine. Portanto, a configuração de local da futura instância padrão do Firestore já está definida.

Se você usou funções programadas de 1ª geração, o local delas é definido como o local dos recursos padrão do Google Cloud. Isso ocorre porque o Cloud Scheduler e o App Engine já tinham uma associação entre si. Além disso, se você configurar funções programadas de 1ª geração antes de provisionar outros recursos que compartilham essa configuração de local, também definirá o local deles.

Se você tiver um app do App Engine com um local us-central ou europe-west, o local dos recursos padrão do Google Cloud será considerado multirregional.

Próximas etapas

Para criar um banco de dados do Firestore em um local específico, acesse um dos guias de início rápido do Firestore.

Para mais informações sobre como criar aplicativos para atender às suas necessidades de latência, disponibilidade e durabilidade, consulte a página Geografia e regiões.