Localizações

Localizações

Quando aprovisiona uma instância do Firestore, tem de escolher uma localização para a instância. Para reduzir a latência e aumentar a disponibilidade, armazene os seus dados perto dos utilizadores e dos serviços que os necessitam.

Opcionalmente, pode criar várias bases de dados no seu projeto, cada uma com a sua própria definição de localização.

Tenha em atenção que, depois de aprovisionar uma instância de base de dados, não pode alterar a respetiva definição de localização.

Importante: a definição de localização da instância de base de dados do Firestore predefinida tem uma dependência da "localização dos recursos Google Cloud predefinidos". Isto significa que, quando aprovisiona a base de dados do Firestore predefinida, a respetiva localização pode já ter sido definida, quer durante a criação do projeto, quer quando configura outro serviço que partilha esta dependência de localização.

As instâncias da base de dados do Firestore não predefinidas no seu projeto não partilham esta dependência de localização.

Tipos de localizações

Pode armazenar os seus dados do Firestore numa localização multirregional ou numa localização regional.

Localizações multirregionais

Selecione uma localização multirregional para maximizar a disponibilidade e a durabilidade da sua base de dados.

Uma localização multirregional consiste num conjunto definido de regiões onde são armazenadas várias réplicas da base de dados. Cada réplica é uma réplica de leitura/escrita que contém todos os dados na base de dados ou uma réplica de testemunho que não mantém um conjunto completo de dados, mas participa na replicação.

Ao replicar os dados entre várias regiões, os dados podem continuar a ser servidos mesmo com a perda de uma região inteira. Numa região, os dados são replicados em várias zonas para que possam continuar a ser publicados nessa região, mesmo com a perda de uma zona.

O Firestore suporta as seguintes localizações multirregionais:

Nome da multirregião	Descrição de várias regiões	Regiões de leitura/escrita	Região de testemunhas
eur3	Europa	europe-west1 (Bélgica), europe-west4 (Países Baixos)	europe-north1 (Finlândia)
nam5	Estados Unidos (central)	us-central1 (Iowa), us-central2 (Oklahoma – região privada da GCP)	us-east1 (Carolina do Sul)
nam7	Estados Unidos (central e leste)	us-central1 (Iowa), us-east4 (norte da Virgínia)	us-central2 (Oklahoma – região Google Cloud privada)

Nota: se o seu projeto já tiver uma app do App Engine com uma localização de us-central ou europe-west, a sua base de dados do Firestore predefinida será considerada multirregional.

Localizações regionais

Uma localização regional é um local geográfico específico, como a Carolina do Sul. Os dados numa localização regional são replicados em várias zonas numa região.

Selecione uma localização regional para custos mais baixos, para uma latência de gravação mais baixa se a sua aplicação for sensível à latência ou para colocação conjunta com outros Google Cloud recursos.

O Firestore suporta as seguintes localizações 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 Esta localização não suporta o App Engine. Se planeia usar o App Engine, deve escolher uma localização diferente.	Iowa
	northamerica-northeast1	Montréal
	northamerica-northeast2 Esta localização não suporta o App Engine. Se planeia usar o App Engine, deve escolher uma localização diferente.	Toronto
	northamerica-south1 Esta localização não suporta o App Engine. Se planeia usar o App Engine, deve escolher uma localização diferente.	Queretaro
	us-east1	Carolina do Sul
	us-east4	Virgínia do Norte
	us-east5 Esta localização não suporta o App Engine. Se planeia usar o App Engine, deve escolher uma localização diferente.	Columbus
	us-south1 Esta localização não suporta o App Engine. Se planeia usar o App Engine, deve escolher uma localização diferente.	Dallas
América do Sul
	southamerica-west1 Esta localização não suporta o App Engine. Se planeia usar o App Engine, deve escolher uma localização diferente.	Santiago
	southamerica-east1	São Paulo
Europa
	europe-west2	Londres
	europe-west1 Esta localização não suporta o App Engine. Se planeia usar o App Engine, deve escolher uma localização diferente.	Bélgica
	europe-west4 Esta localização não suporta o App Engine. Se planeia usar o App Engine, deve escolher uma localização diferente.	Países Baixos
	europe-west8 Esta localização não suporta o App Engine. Se planeia usar o App Engine, deve escolher uma localização diferente.	Milão
	europe-southwest1 Esta localização não suporta o App Engine. Se planeia usar o App Engine, deve escolher uma localização diferente.	Madrid
	europe-west9 Esta localização não suporta o App Engine. Se planeia usar o App Engine, deve escolher uma localização diferente.	Paris
	europe-west12 Esta localização não suporta o App Engine. Se planeia usar o App Engine, deve escolher uma localização diferente.	Turim
	europe-west10 Esta localização não suporta o App Engine. Se planeia usar o App Engine, deve escolher uma localização diferente.	Berlim
	europe-west3	Frankfurt
	europe-north1 Esta localização não suporta o App Engine. Se planeia usar o App Engine, deve escolher uma localização diferente.	Finlândia
	europe-north2 Esta localização não suporta o App Engine. Se planeia usar o App Engine, deve escolher uma localização diferente.	Estocolmo
	europe-central2	Varsóvia
	europe-west6	Zurique
Médio Oriente
	me-central1 Esta localização não suporta o App Engine. Se planeia usar o App Engine, deve escolher uma localização diferente.	Doha
	me-central2 Esta localização não suporta o App Engine. Se planeia usar o App Engine, deve escolher uma localização diferente.	Damã
	me-west1 Esta localização não suporta o App Engine. Se planeia usar o App Engine, deve escolher uma localização diferente.	Telavive
Ásia
	asia-south1	Mumbai
	asia-south2 Esta localização não suporta o App Engine. Se planeia usar o App Engine, deve escolher uma localização diferente.	Deli
	asia-southeast1	Singapura
	asia-southeast2	Jacarta
	asia-east2	Hong Kong
	asia-east1	Taiwan
	asia-northeast1	Tóquio
	asia-northeast2	Osaca
	asia-northeast3	Seul
Austrália
	australia-southeast1	Sydney
	australia-southeast2 Esta localização não suporta o App Engine. Se planeia usar o App Engine, deve escolher uma localização diferente.	Melbourne
África
	africa-south1 Esta localização não suporta o App Engine. Se planeia usar o App Engine, deve escolher uma localização diferente.	Joanesburgo

SLA de localização

O tipo de localização do Firestore determina a percentagem de tempo de atividade do contrato de nível de serviço (SLA):

Serviço abrangido	Percentagem de tempo de atividade mensal
Multirregião do Firestore	>= 99,999%
Firestore Regional	>= 99,99%

Preços por localização

A sua localização do Firestore determina o custo das operações da base de dados.

Para uma explicação abrangente dos preços por região e por tipo de região, consulte o artigo Compreender a faturação do Firestore.

Veja a localização das suas bases de dados

Use um dos seguintes métodos para ver a definição de localização das suas bases de dados:

• Execute o comando gcloud firestore databases list.

• Abra a lista de bases de dados na Google Cloud consola. A localização de cada base de dados encontra-se na coluna de localização.

• Na consola do Firebase, aceda ao separador Dados do Firestore para ver a lista das instâncias da base de dados e respetivas localizações.

Possíveis dependências de localização devido a "localização para recursos Google Cloud predefinidos"

A "localização dos recursos Google Cloud predefinidos" é a definição de localização para todos os recursos do projeto associados ao Google App Engine, incluindo o seguinte:

• instância de base de dados do Firestore predefinida
• Contentor do Cloud Storage para Firebase predefinido com o formato de nome *.appspot.com
• Google Cloud Scheduler usado especificamente com funções agendadas de 1.ª geração

Nota: nenhum dos outros recursos no seu projeto partilha esta dependência de localização, incluindo o seguinte: instâncias da base de dados em tempo real, instâncias do Firestore não predefinidas, contentores do Cloud Storage não predefinidos, contentores do Cloud Storage predefinidos com o formato de nome *.firebasestorage.app, funções não agendadas e funções agendadas de 2.ª geração.

Esta "localização dos recursos Google Cloud predefinidos" é uma definição imutável. Além disso, quando define a localização de um dos recursos associados, define indiretamente a localização de todos eles devido à associação comum com o App Engine.

No entanto, com as muitas alterações ao Firebase e ao Google Cloud ecossistema ao longo dos anos, as associações de recursos ao App Engine têm vindo a mudar. Em particular, a partir de 30 de outubro de 2024, todos os contentores do Cloud Storage para Firebase predefinidos recém-aprovisionados têm o formato de nome *.firebasestorage.app e não estão associados ao App Engine.

Ponto-chave: a partir de 30 de outubro de 2024, o aprovisionamento do contentor do Cloud Storage para Firebase predefinido não define a "localização dos recursos Google Cloud predefinidos" (como a localização da instância do Firestore predefinida do projeto). Além disso, o aprovisionamento da instância do Firestore predefinida já não define a localização de um novo contentor do Cloud Storage para Firebase predefinido (com o formato de nome *.firebasestorage.app).

Seguem-se os detalhes das alterações nas possíveis dependências de localização:

• A partir de 30 de outubro de 2024, se a instância do Firestore predefinida e o contentor do Cloud Storage para Firebase predefinido ainda não tiverem sido aprovisionados:

  • O aprovisionamento da instância predefinida do Firestore define a localização para qualquer app do App Engine futura aprovisionada no projeto. No entanto, não determina a localização do contentor do Cloud Storage predefinido futuro.

  • O aprovisionamento do contentor do Cloud Storage predefinido já não aprovisiona uma app do App Engine. Assim, a localização do contentor do Cloud Storage predefinido não determina a localização da futura instância predefinida do Firestore.

• A partir de 30 de outubro de 2024, se a instância do Firestore predefinida já tiver sido aprovisionada, mas o contentor do Cloud Storage for Firebase predefinido não tiver sido aprovisionado:

  • A instância predefinida do Firestore existente não determina a localização do futuro contentor predefinido do Cloud Storage (*.firebasestorage.app).

• A partir de 30 de outubro de 2024, se o contentor do Cloud Storage para Firebase predefinido já tiver sido aprovisionado (especificamente, o contentor *.appspot.com), mas a instância do Firestore predefinida não tiver sido aprovisionada:

  • Quando o contentor do Cloud Storage predefinido (*.appspot.com) foi aprovisionado, também foi aprovisionada uma app do App Engine. Por isso, a localização da futura instância do Firestore predefinida foi definida nessa altura. Mesmo que elimine o contentor *.appspot.com, não pode eliminar a app do App Engine, pelo que a definição de localização da futura instância predefinida do Firestore já está definida.

Se usou funções agendadas de 1.ª geração, a respetiva localização é definida como a localização dos recursos Google Cloud predefinidos. Isto acontece porque o Cloud Scheduler e o App Engine tinham anteriormente uma associação entre si. Além disso, se configurar funções programadas de 1.ª geração antes de aprovisionar outros recursos que partilham esta definição de localização, também define a localização destes.

Tenha em atenção que, se tiver uma app do App Engine com uma localização de us-central ou europe-west, a localização dos recursos predefinidos é considerada multirregional. Google Cloud

Passos seguintes

• Para criar uma base de dados do Firestore numa localização específica, consulte um dos inícios rápidos do Firestore.

• Para mais informações sobre a criação de aplicações que cumpram os seus requisitos de latência, disponibilidade e durabilidade, consulte o artigo Geografia e regiões.