Selecionar locais para seu projeto

Vários produtos do Firebase exigem uma configuração de localização:

  • Google Analytics para Firebase: quando você cria um novo projeto do Firebase, é preciso selecionar um local para os relatórios do 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, será solicitado a 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 precisará de um app do Google 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.

Local padrão dos recursos do GCP

Vários serviços disponíveis para o aplicativo exigem uma configuração específica que é o local padrão dos recursos do Google Cloud Platform (GCP) no seu projeto. Esse 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:

Tipos de locais

  • Analytics: selecione um país ou região que represente a localização da sua organização.

  • Cloud Firestore e Cloud Storage: selecione um local multirregional ou regional.

  • Funções programadas (para o app obrigatório do App Engine): selecione um local multirregional ou regional.

Se você já tiver um app do App Engine com uma localização que seja us-central ou europe-west, qualquer serviço do GCP que utilize esta definição de localização será considerado multirregional.

Locais multirregionais

Um local multirregional é uma área geográfica geral, como os Estados Unidos. Os dados em um local multirregional são replicados em várias regiões. Em uma região, os dados são replicados nas zonas.

Selecione um local multirregional para aumentar a disponibilidade e a durabilidade do seu banco de dados. Os locais multirregionais podem suportar a perda de regiões inteiras e manter a disponibilidade sem perder dados.

O Firebase é compatível com os seguintes locais multirregionais dos recursos do GCP:
Nome multirregional Descrição multirregional Regiões constituintes
eur3 ou europe-west Europa europe-west1, europe-west4
nam5 ou us-central Ucrânia us-central1, us-central2 (Oklahoma: região particular do GCP)

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ãoDescrição da região
América do Norte
us-west2Los Angeles
northamerica-northeast1Montreal
us-east1Carolina do Sul
us-east4Virgínia do Norte
América do Sul
southamerica-east1São Paulo
Europa
europe-west2Londres
europe-west3Frankfurt
europe-west6Zurique
Ásia
asia-south1Mumbai
asia-east2Hong Kong
asia-northeast1Tóquio
asia-northeast2Osaka
Austrália
australia-southeast1Sydney

Definir a configuração de local do seu projeto

Para a maioria dos casos de uso, você define as configurações de local do seu projeto no Console do Firebase durante a criação do projeto ou na página do produto no console.

Analytics

Ao criar um novo projeto no Console do Firebase, é preciso selecionar um local para os relatórios do Analytics.

Se você é proprietário ou editor de um projeto, pode editar o local do relatório do Analytics. Acesse as configurações do Analytics e role até o painel Relatórios.

Cloud Firestore, Cloud Storage e funções programadas

Saiba que o local padrão dos recursos do GCP pode ter sido definido anteriormente durante a criação do projeto ou quando outro serviço que precisa dessa configuração foi ajustado.

  • No Console do Firebase, quando você configura o Cloud Firestore ou o Cloud Storage inicialmente, é preciso selecionar o local padrão dos recursos do GCP para seu projeto.

  • Se você executa funções programadas, o Cloud Scheduler exige um app do Google App Engine. Durante a configuração do app, é preciso a selecionar o local padrão dos recursos do GCP para seu projeto.

  • Você pode definir programaticamente seu local padrão dos recursos do GCP ao chamar o ponto de extremidade defaultLocation.finalize para seu projeto do Firebase.

Ver a configuração de local do seu projeto

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.