Exportar dados do projeto para o BigQuery

No Console do Firebase, você encontra ferramentas para explorar e analisar os dados históricos do seu projeto. Essas ferramentas podem responder muitas perguntas sobre como seus apps estão sendo usados. No entanto, em alguns casos, você também pode querer configurar consultas específicas para responder às suas perguntas.

É possível fazer isso ao exportar os dados do seu projeto do Firebase para o BigQuery. Com o BigQuery, é possível analisar seus dados com o BigQuery SQL ou exportar os dados para que sejam usados com suas próprias ferramentas.

É possível configurar o Firebase para exportar dados para o BigQuery usando os seguintes produtos da plataforma:

• Analytics
• Cloud Messaging
• Crashlytics
• Performance Monitoring
• A/B Testing
• Personalização da Remote Config

Permissões obrigatórias e papéis sugeridos

Para visualizar ou gerenciar as configurações de exportação de dados para o BigQuery, é necessário ter o nível de acesso necessário.

Se você não tiver o acesso necessário do Firebase, peça a um proprietário de projeto do Firebase para atribuir a você o papel aplicável usando as configurações de IAM do Console do Firebase. Se você tiver dúvidas sobre como acessar seu projeto do Firebase, incluindo encontrar ou atribuir um proprietário, consulte as Perguntas frequentes sobre permissões e acesso aos projetos do Firebase.

Nível do projeto

A tabela a seguir se aplica à vinculação de nível superior de um projeto do Firebase ao BigQuery.

Ação no console do Firebase	Permissão do IAM obrigatória	Papéis do IAM que incluem as permissões necessárias por padrão	Outros papéis necessários
Vincular um projeto do Firebase e o BigQuery	firebase.links.create	Proprietário Administrador do Firebase	nenhum
Desvincular um projeto do Firebase e o BigQuery	firebase.links.delete	Proprietário Administrador do Firebase	nenhum
Conferir os links existentes para BigQuery	firebase.links.list	Qualquer papel básico (proprietário, editor ou leitor) Qualquer papel no nível do Firebase Qualquer papel de categoria dos produtos do Firebase	nenhum

Google Analytics

A tabela a seguir se aplica especificamente à exportação de dados de Google Analytics para BigQuery.

Ação no console do Firebase	Permissão do IAM obrigatória	Papéis do IAM que incluem as permissões necessárias por padrão	Outros papéis necessários
Ativar a exportação de dados do Google Analytics para o BigQuery	firebase.links.update E serviceusage.services.enable	Proprietário Administrador do Firebase E Administrador de uso do serviço	Google Analytics: equivalente a editor ou administrador da conta da propriedade Google Analytics vinculada Veja a observação abaixo.
Ativar a exportação para apps específicos do Firebase	firebase.links.update	Proprietário Administrador do Firebase	Google Analytics: equivalente a editor ou administrador da conta da propriedade Google Analytics vinculada Veja a observação abaixo.
Desativar exportação para apps específicos do Firebase	firebase.links.update	Proprietário Administrador do Firebase	Google Analytics: equivalente a editor ou administrador da conta da propriedade Google Analytics vinculada Veja a observação abaixo.

Produtos do Firebase

A tabela a seguir se aplica a qualquer um dos produtos do Firebase em que você pode exportar dados para o BigQuery, como Crashlytics ou Performance Monitoring.

Ação no console do Firebase	Permissão do IAM obrigatória	Papéis do IAM que incluem as permissões necessárias por padrão	Outros papéis necessários
Ativar a exportação de dados de um produto para o BigQuery	firebase.links.update	Proprietário Administrador do Firebase	nenhum
Ativar a exportação para apps específicos do Firebase	firebase.links.update	Proprietário Administrador do Firebase	nenhum
Desativar exportação para apps específicos do Firebase	firebase.links.update	Proprietário Administrador do Firebase	nenhum

Ativar a exportação para BigQuery

1. No console do Firebase, acesse a guia Integrações.

2. No card do BigQuery, clique em Vincular.

3. Siga as instruções na tela para ativar a exportação para o BigQuery.

Veja o que acontece quando você ativa a exportação para o BigQuery:

• Você seleciona o local do conjunto de dados. Após a criação do banco de dados, o local não pode ser alterado, mas é possível mover (recriar) ou copiar o conjunto de dados para um local diferente. Para saber mais, consulte Mudar local do conjunto de dados.

• Todos os apps no projeto são vinculados ao BigQuery por padrão, e todos os apps adicionados posteriormente ao projeto são vinculados automaticamente ao BigQuery. É possível gerenciar quais apps enviam dados.

• O Firebase exporta uma cópia dos dados existentes para o BigQuery.

• O Firebase configura as sincronizações diárias dos seus dados do seu projeto do Firebase para o BigQuery.

Para desativar as exportações do BigQuery, desvincule seu projeto no console do Firebase.

Mudar local do conjunto de dados

Depois de ativar um produto no BigQuery Export e criar um conjunto de dados, o local não pode ser alterado. No entanto, é possível copiar seu conjunto de dados para um novo com um outro local. Para saber mais sobre os locais de conjuntos de dados BigQuery, consulte Locais de conjuntos de dados.

Selecione o produto que você quer mudar o local do conjunto de dados.

Para mudar a localização de um conjunto de dados do Google Analytics, siga estas instruções:

1. No console do Firebase, acesse a guia Integrações. Em seguida, faça o seguinte:

   1. No card BigQuery, clique em Gerenciar.
   2. Desative o controle deslizante Google Analytics para desativar BigQuery.

2. No console Google Cloud, acesse a página BigQuery. Em seguida, faça o seguinte:

   1. Crie um conjunto de dados temporário para armazenar uma cópia dos dados do conjunto original. Atribua ao conjunto de dados temporário um nome diferente do que foi dado ao conjunto original.
   2. Copie ou mova os dados do conjunto original para o temporário.
   3. Exclua o conjunto de dados original.
   4. Crie um novo conjunto de dados permanente com o mesmo nome do conjunto original (analytics_ANALYTICS_PROPERTY_ID) e selecione a nova região.
   5. Copie ou mova os dados do conjunto de dados temporário para o novo e exclua o temporário.

3. Volte para o console do Firebase e o card BigQuery. Em seguida, faça o seguinte:

   1. Ative o controle deslizante Google Analytics para reativar a integração BigQuery.
   2. Selecione os apps para os quais você quer ativar a exportação.

Preços e o sandbox do BigQuery

Se o projeto do Firebase estiver no plano Spark sem custos financeiros, será possível vincular Crashlytics, Cloud Messaging, Google Analytics e Performance Monitoring ao sandbox do BigQuery, que oferece acesso sem custos financeiros ao BigQuery. Consulte Como usar o sandbox do BigQuery para saber mais sobre os recursos do sandbox do BigQuery.

Se o projeto do Firebase estiver em um plano pago, você poderá vincular A/B Testing, Crashlytics, Cloud Messaging, Google Analytics e Performance Monitoring a BigQuery. O uso de BigQuery está sujeito aos preços normais do BigQuery, o que inclui o uso limitado e sem custos financeiros.