Vários produtos do Firebase exigem uma configuração de localização:
Google Analytics: se você ativar o Google Analytics no seu projeto do Firebase, precisará selecionar um local para os relatório do Google Analytics. Esse local representa o país ou região da sua organização. O local do Analytics também define a moeda do relatório de receita.
Cloud Firestore e Cloud Storage: se você começar a usar um desses produtos, receberá uma solicitação para selecionar o local padrão dos recursos do Google Cloud Platform (GCP) para o projeto, se ele ainda não tiver sido selecionado.
Cloud Functions para Firebase (apenas funções programadas): se você executar funções programadas, o Cloud Scheduler exigirá um aplicativo do App Engine. Durante a configuração, você precisará selecionar o local padrão dos recursos do Google Cloud Platform (GCP) para o projeto, caso ele ainda não tenha 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, precisará selecionar o local dela. Além disso, cada instância poderá estar em um local diferente. Os locais das instâncias do Realtime Database não afetam as opções do local padrão dos recursos do GCP.
Selecione uma configuração de local para um produto ou grupo de produtos
Na maioria dos casos de uso, selecione uma configuração de local no Console do Firebase, durante a criação do projeto ou na página do console para um produto específico.
Analytics
Se você ativar o Google Analytics no seu projeto do Firebase no Console do Firebase, receberá uma solicitação para selecionar um local para o relatório do Google Analytics. Selecione um país ou uma região que represente o local da sua organização.
Se você é proprietário ou editor de um projeto, pode editar o fuso horário e a moeda do local do relatório do Google Analytics. Acesse as configurações do Google Analytics e role 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 padrão dos recursos do GCP. Veja a seguir mais informações sobre essa configuração de local. Lembre-se de 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.
Se você configurar o Cloud Firestore ou o Cloud Storage, será solicitado a selecionar o local padrão dos recursos do GCP do seu projeto no fluxo de trabalho do Console do Firebase.
Para o Cloud Storage, o local padrão dos recursos do GCP se aplica apenas ao seu 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 do aplicativo, será necessário selecionar o local padrão dos recursos do GCP para seu projeto.
É possível definir programaticamente seu local padrão dos recursos do GCP ao chamar o endpoint
defaultLocation.finalizepara seu projeto do Firebase.
Locais do Realtime Database
Se você criar uma nova instância do Realtime Database, precisará especificar o local dela. Cada instância do Realtime Database no seu projeto pode estar localizada em um local diferente. Os locais compatíveis atualmente para instâncias do Realtime Database estão listados abaixo, com os esquemas de URL do banco de dados associados.
Os locais das instâncias do Realtime Database não afetam as opções do local de recurso padrão 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 |
Singapura | DATABASE_NAME.asia-southeast1.firebasedatabase.app |
Ver configurações de local
Para o 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 o Realtime Database: no Console do Firebase, consulte a lista de instâncias do 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 padrão dos recursos do Google Cloud Platform (GCP) do projeto. Esse é o local onde seus dados são armazenados para serem usados por serviços do GCP que exigem essa configuração.
Os seguintes produtos compartilham o mesmo local padrão dos recursos do GCP:
Cloud Firestore
Observe que o local padrão do recurso do GCP não se aplica ao Firebase Realtime Database.Cloud Storage
Observe que o local padrão do recurso do GCP só se aplica ao bucket padrão do Cloud Storage bucket. 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, o local dele será o mesmo que o padrão dos recursos do GCP. 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.
Selecione um local multirregional ou
regional como padrão dos recursos do GCP. Se
você já tiver um aplicativo do App Engine com um local
us-central ou europe-west, qualquer serviço do GCP que usar essa configuração de local
será considerado multirregional.
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 zona.
O Firebase suporta os seguintes locais multirregionais dos recursos do GCP:| 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) |
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 GCP.
O Firebase é compatível com os seguintes locais regionais dos recursos do GCP:| Nome da região | Descrição do local regional | |
|---|---|---|
| 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 | Mumbai | |
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 | |
Próximas etapas
Para criar um banco de dados do Cloud Firestore em um local específico, consulte Primeiros passos com o Cloud Firestore.
Para criar um intervalo do Cloud Storage, acesse 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 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.