Selecionar locais para seu projeto

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 vai exigir um aplicativo do App Engine. Durante a configuração, será necessário 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.finalize para 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

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 delas.

O Firebase oferece suporte aos locais multirregionais dos recursos do GCP a seguir:
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 oferece suporte aos seguintes locais regionais dos recursos do GCP:
Nome da regiãoDescrição do local regional
América do Norte
us-west1Oregon
us-west2Los Angeles
us-west3Salt Lake City
us-west4Las Vegas
northamerica-northeast1Montreal

northamerica-northeast2

Toronto
us-east1Carolina do Sul
us-east4Norte da Virgínia
América do Sul
southamerica-east1São Paulo
Europa
europe-west2Londres

europe-west4

Países Baixos

europe-west9

Paris
europe-west3Frankfurt
europe-central2Varsóvia
europe-west6Zurique
Oriente Médio

me-central1

Doha

me-west1

Tel Aviv
Ásia
asia-south1Mumbai

asia-south2

Este local não oferece suporte ao Cloud Storage para Firebase. Se você planeja usar o Cloud Storage para Firebase, escolha um local diferente.

Délhi
asia-southeast1Singapura
asia-southeast2Jacarta
asia-east2Hong Kong
asia-east1Taiwan
asia-northeast1Tóquio
asia-northeast2Osaka
asia-northeast3Seul
Austrália
australia-southeast1Sydney

australia-southeast2

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ó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.