Vários produtos Firebase exigem uma configuração de localização:
Google Analytics — Se você ativar o Google Analytics em seu projeto Firebase, será solicitado a selecionar um local de relatório do Analytics. Este local representa o país ou região da sua organização. A localização do Analytics, por sua vez, define a moeda dos relatórios de receita.
Cloud Firestore e Cloud Storage — Se você começar a usar um desses produtos, será solicitado a selecionar o local de recurso padrão do Google Cloud Platform (GCP) do seu projeto (caso ainda não tenha sido selecionado ao configurar outro serviço).
Cloud Functions for Firebase (somente funções agendadas) — Se você executar funções agendadas , o Cloud Scheduler requer um aplicativo do App Engine; durante a configuração, você é solicitado a selecionar o local de recurso padrão do Google Cloud Platform (GCP) do seu projeto (caso ainda não tenha sido selecionado ao configurar outro serviço).
Para saber mais sobre as configurações de localização para funções não agendadas, visite Cloud Functions Locations .
Realtime Database — Se você criar uma instância do Realtime Database, será solicitado a selecionar o local da instância e cada instância poderá estar em um local diferente. Observe que os locais de suas instâncias do Realtime Database não afetam as opções para o local padrão de recursos do GCP.
Selecione uma configuração de localização para um produto ou grupo de produtos
Para a maioria dos casos de uso, você seleciona uma configuração de local no Firebase console , seja durante a criação do projeto ou na página do console de um produto específico.
Análise
Se você ativar o Google Analytics em seu projeto do Firebase no console do Firebase , será solicitado a selecionar um local de relatório do Analytics. Selecione um país ou região que represente a localização da sua organização.
Se você for proprietário ou editor de um projeto, poderá editar o fuso horário e a moeda do local de relatório do Analytics; vá para as configurações do Google Analytics e role até o painel Relatórios .
Cloud Firestore, Cloud Storage e funções agendadas
O Cloud Firestore, o Cloud Storage e as funções programadas compartilham a mesma configuração de local, chamada de local de recurso padrão do GCP (saiba mais detalhes sobre essa configuração de local abaixo). Observe que esse local pode ter sido definido anteriormente, durante a criação do projeto ou ao configurar outro serviço que usa essa configuração de local.
Se você configurar o Cloud Firestore ou o Cloud Storage, será solicitado a selecionar o local padrão do recurso GCP do seu projeto no fluxo de trabalho do Firebase console.
Para o Cloud Storage, o local padrão do recurso do GCP se aplica apenas ao seu intervalo padrão . Se você estiver no plano Blaze, poderá criar vários buckets, cada um com seu próprio local .
Se você executar funções programadas , o Cloud Scheduler exigirá um aplicativo do App Engine. Durante a configuração, você será solicitado a selecionar o local padrão do recurso GCP do seu projeto.
Você pode definir programaticamente o local padrão do recurso do GCP chamando o endpoint
defaultLocation.finalizepara seu projeto do Firebase.
Locais do banco de dados em tempo real
Se você criar uma nova instância do Realtime Database, precisará especificar o local dessa instância. Cada instância do Realtime Database em seu projeto pode estar localizada em um local diferente. Os locais com suporte atualmente para instâncias do Realtime Database estão listados abaixo junto com seus esquemas de URL de banco de dados associados.
Observe que os locais de suas instâncias do Realtime Database não afetam as opções para o local padrão de recursos do GCP .
| Nome da região | Descrição da região | Esquema de URL do banco de dados |
|---|---|---|
us-central1 | Iowa | DATABASE_NAME .firebaseio.com |
europe-west1 | Bélgica | DATABASE_NAME .europe-west1.firebasedatabase.app |
asia-southeast1 | Cingapura | DATABASE_NAME .asia-southeast1.firebasedatabase.app |
Ver configurações de localização
Para Analytics — No console do Firebase, acesse as configurações do Google Analytics e role até o painel Reporting .
Para Cloud Firestore, Cloud Storage e funções agendadas — No console do Firebase, acesse as configurações do projeto .
Para Realtime Database — No Firebase console, veja a lista de suas instâncias de banco de dados no visualizador de dados do Realtime Database .
Saiba mais sobre o local padrão dos recursos do GCP
Vários serviços disponíveis para seu aplicativo exigem uma configuração de local chamada de local de recurso padrão do Google Cloud Platform (GCP) do seu projeto. Este local é onde seus dados são armazenados para serviços GCP que exigem uma configuração de local.
Os produtos a seguir compartilham o mesmo local padrão de recursos do GCP:
Cloud Firestore
Observe que o local padrão do recurso do GCP não se aplica ao Firebase Realtime Database .Armazenamento na núvem
Observe que o local padrão do recurso do GCP se aplica apenas ao intervalo padrão do Cloud Storage. Se você estiver no plano Blaze, poderá criar vários buckets, cada um com seu próprio local .Aplicativo do App Engine (por exemplo, para funções programadas)
Se você configurar um aplicativo do App Engine, seu local compartilhará o local padrão do recurso do GCP. Observe que, se você usar o Cloud Scheduler (por exemplo, para executar funções programadas ), será necessário ter um aplicativo do App Engine em seu projeto.
Você pode selecionar um local multirregional ou um local regional como seu local padrão de recursos do GCP. Observe que, se você já tiver um aplicativo do Google App Engine com localização us-central ou europe-west , qualquer serviço do GCP que use essa configuração de localização será considerado multirregional .
Locais multirregionais
Selecione um local multirregional para maximizar a disponibilidade e a durabilidade do seu banco de dados.
Um local multirregional consiste em um conjunto definido de regiões onde várias réplicas do banco de dados são armazenadas. Cada réplica é uma réplica de leitura/gravação que contém todos os dados no banco de dados ou uma réplica de testemunha que não mantém um conjunto completo de dados, mas participa da replicação.
Ao replicar os dados entre várias regiões, os dados podem continuar sendo atendidos mesmo com a perda de uma região inteira. Dentro de uma região, os dados são replicados entre as zonas para que os dados possam continuar a ser atendidos nessa região mesmo com a perda de uma zona.
O Firebase é compatível com os seguintes locais de recursos do GCP multirregionais:| Nome de várias regiões | Descrição de várias regiões | Regiões de leitura-gravação | Região Testemunha |
|---|---|---|---|
eur3 | Europa | europe-west1 (Bélgica), europe-west4 (Holanda) | europe-north1 (Finlândia) |
nam5 | Estados Unidos | us-central1 (Iowa), us-central2 (Oklahoma — região privada do GCP) | us-east1 (Carolina do Sul) |
Locais regionais
Uma localização regional é um local geográfico específico, como a Carolina do Sul. Os dados em um local regional são replicados em várias zonas dentro de uma região . Todos os locais regionais são separados de outros locais regionais por pelo menos 100 milhas.
Selecione um local regional para custos mais baixos, para menor latência de gravação se seu aplicativo for sensível à latência ou para colocalização com outros recursos do GCP .
O Firebase é compatível com os seguintes locais de recursos regionais do GCP:| 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 | |
northamerica-northeast1 | Montreal | |
us-east1 | Carolina do Sul | |
us-east4 | Virgínia do Norte | |
| América do Sul | ||
southamerica-east1 | São Paulo | |
| Europa | ||
europe-west2 | Londres | |
europe-west3 | Frankfurt | |
europe-central2 | Varsóvia | |
europe-west6 | Zurique | |
| Ásia | ||
asia-south1 | Bombaim | |
asia-southeast1 | Cingapura | |
asia-southeast2 | Jacarta | |
asia-east2 | Hong Kong | |
asia-east1 | Taiwan | |
asia-northeast1 | Tóquio | |
asia-northeast2 | Osaka | |
asia-northeast3 | Seul | |
| Austrália | ||
australia-southeast1 | Sidney | |
Este local não oferece suporte ao Cloud Storage para Firebase. Se você planeja usar o Cloud Storage para Firebase, escolha um local diferente. | Melbourne | |
Próximos passos
Para criar um banco de dados Cloud Firestore em um local específico, visite Introdução ao Cloud Firestore .
Para criar um bucket do Cloud Storage , visite a página Primeiros passos da sua plataforma.
Para executar funções agendadas com o Cloud Functions para Firebase, visite o guia de configuração .
Para obter mais informações sobre como criar aplicativos para atender aos seus requisitos de latência, disponibilidade e durabilidade, consulte Geografia e regiões .