Vários produtos do Firebase exigem uma configuração de local:
Google Analytics : se você ativar o Google Analytics em seu projeto do Firebase, será solicitado a selecionar um local de geração de relatórios do Analytics. Este local representa o país ou região da sua organização. A sua localização no Google Analytics, por sua vez, define a moeda para os relatórios de receitas.
Cloud Firestore e Cloud Storage : se você começar a usar qualquer um desses produtos, será solicitado que selecione o local de recurso padrão do Google Cloud Platform (GCP) do seu projeto (se ainda não tiver sido selecionado ao configurar outro serviço).
Cloud Functions para Firebase (somente funções programadas) : se você executa funções programadas , o Cloud Scheduler requer um aplicativo do App Engine; durante a configuração, você será solicitado a selecionar o local de recurso padrão do Google Cloud Platform (GCP) do seu projeto (se ainda não tiver sido selecionado ao configurar outro serviço).
Para saber mais sobre configurações de localização para funções não programadas, acesse Locais do Cloud Functions .
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 das instâncias do Realtime Database não afetam as opções do local padrão do recurso do GCP.
Selecione uma configuração de local para um produto ou grupo de produtos
Na maioria dos casos de uso, você seleciona uma configuração de local no console do Firebase , 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 Firebase console , será solicitado que você selecione um local de geração de relatórios 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 dos relatórios do Google Analytics. acesse as configurações do Google Analytics e vá até o painel Relatórios .
Cloud Firestore, Cloud Storage e funções programadas
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 use essa configuração de local.
Se você configurar o Cloud Firestore ou o Cloud Storage, será solicitado que você selecione 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 bucket 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.finalizedo seu projeto do Firebase.
Locais do Realtime Database
Se você criar uma nova instância do Realtime Database, será necessário especificar o local dessa instância. Cada instância do Realtime Database no seu projeto pode estar localizada em um local diferente. Os locais atualmente suportados para instâncias do Realtime Database estão listados abaixo, juntamente com os esquemas de URL do banco de dados associados.
Observe que os locais das instâncias do Realtime Database não afetam as opções do local padrão do recurso do GCP .
| Nome da região | Descrição da região | Esquema de URL do banco de dados |
|---|---|---|
us-central1 | Iowa | DATABASE_NAME |
europe-west1 | Bélgica | DATABASE_NAME |
asia-southeast1 | Cingapura | DATABASE_NAME |
Ver configurações de localização
Para Analytics: no console do Firebase, acesse as configurações do Google Analytics e role até o painel Relatórios .
Para Cloud Firestore, Cloud Storage e funções programadas: no console do Firebase, acesse as configurações do projeto .
Para Realtime Database: no console do Firebase, visualize a lista de instâncias do seu banco de dados no visualizador de dados do Realtime Database .
Saiba mais sobre o local padrão do recurso do GCP
Vários serviços disponíveis para seu aplicativo exigem uma configuração de local chamada local de recurso padrão do Google Cloud Platform (GCP) do seu projeto. Este local é onde seus dados são armazenados para serviços do GCP que exigem uma configuração de local.
Os produtos a seguir compartilham o mesmo local de recurso padrão do GCP:
Cloud Fire Store
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 bucket padrão do Cloud Storage. Se você estiver no plano Blaze, poderá criar vários buckets, cada um com seu próprio local .Aplicativo App Engine (por exemplo, para funções programadas)
Se você configurar um aplicativo do App Engine, o local dele 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 no seu projeto.
Você pode selecionar um local multirregional ou regional como local de recurso padrão do GCP. Observe que se você já tiver um aplicativo do 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 diversas réplicas do banco de dados são armazenadas. Cada réplica é uma réplica de leitura e gravação que contém todos os dados do banco de dados ou uma réplica testemunha que não mantém um conjunto completo de dados, mas participa da replicação.
Ao replicar os dados entre múltiplas regiões, os dados podem continuar a ser servidos mesmo com a perda de uma região inteira. Dentro de uma região, os dados são replicados entre zonas para que os dados possam continuar a ser servidos nessa região mesmo com a perda de uma zona.
O Firebase oferece suporte aos seguintes locais de recursos multirregionais do GCP:| Nome multirregional | Descrição multirregional | Regiões de leitura e gravação | Região de 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 diversas zonas de uma região . Todas as localidades regionais estão separadas de outras localidades regionais por pelo menos 160 quilômetros.
Selecione um local regional para reduzir custos, reduzir a 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 regionais de recursos do GCP:| Nome da região | Descrição da região | |
|---|---|---|
| América do Norte | ||
us-west1 | Óregon | |
us-west2 | Los Angeles | |
us-west3 | Cidade do Lago Salgado | |
us-west4 | Las Vegas | |
northamerica-northeast1 | Montreal | |
| Toronto | |
us-east1 | Carolina do Sul | |
us-east4 | Virgínia do Norte | |
| América do Sul | ||
southamerica-east1 | São Paulo | |
| Europa | ||
europe-west2 | Londres | |
| Bélgica | |
| Holanda | |
| Paris | |
europe-west3 | Francoforte | |
europe-central2 | Varsóvia | |
europe-west6 | Zurique | |
| Médio Oriente | ||
| Doha | |
| Droga | |
| Tel Aviv | |
| Ásia | ||
asia-south1 | Bombaim | |
Este local não é compatível com o Cloud Storage para Firebase. Se você planeja usar o Cloud Storage para Firebase, escolha um local diferente. | Délhi | |
asia-southeast1 | Cingapura | |
asia-southeast2 | Jacarta | |
asia-east2 | Hong Kong | |
asia-east1 | Taiwan | |
asia-northeast1 | Tóquio | |
asia-northeast2 | Osaca | |
asia-northeast3 | Seul | |
| Austrália | ||
australia-southeast1 | Sidney | |
Este local não é compatível com o 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 do Cloud Firestore em um local específico, acesse Primeiros passos com o Cloud Firestore .
Para criar um bucket do Cloud Storage , visite a página de primeiros passos da sua plataforma.
Para executar funções programadas com o Cloud Functions para Firebase, acesse 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 .