Pular para o conteúdo principal
Última atualização em

Configure o Google analítica 4 e o Google BigQuery para a ingestão de Databricks

Esta página descreve como configurar o Google analítica 4 (GA4) e o Google BigQuery (BigQuery) para ingerir dados brutos em nível de evento em Databricks.

Escolha um método de autenticação​

Os seguintes métodos de autenticação são suportados:

  • OAuth (recomendado)
  • Autenticação básica com um serviço account JSON

A Databricks recomenda o OAuth por ser mais seguro. No entanto, sua organização pode optar por usar uma key account de serviço se, por exemplo, você estiver migrando de um provedor que oferece suporte a esse método de autenticação.

Você usará os detalhes de autenticação obtidos durante a configuração da fonte para criar uma conexão Unity Catalog com o GA4.

Os requisitos de permissão são os mesmos para ambas as opções, permitindo que o usuário autenticador acesse o esquema e ingira os dados.

Ativar a nuvem do Google APIs​

Ative o Google Cloud APIs necessário no projeto BigQuery que contém os dados GA4 exportados.

  1. Identifique o projeto BigQuery que contém seus dados GA4 exportados.
  2. Habilite as seguintes APIs no projeto seguindo a documentação do Google:

Conceder permissões de usuário​

Esta seção permite que o usuário autenticador acesse o esquema de origem e ingira os dados. Os passos para fazer isso dependem de seu método de autenticação.

OAuth (recomendado)​

Para ingerir os dados do GA4 do projeto BigQuery usando OAuth, é necessário conceder ao usuário autenticador acesso ao BigQuery account correspondente.

  1. No console de nuvem do Google, navegue até IAM & Admin > IAM .
  2. Ative as seguintes funções para o usuário autenticador:
    • Visualizador de dados do BigQuery
    • Usuário do BigQuery Job
    • Usuário da sessão de leitura do BigQuery

autenticação account de serviço​

Para importar seus dados do GA4 do projeto BigQuery usando a autenticação account de serviço, você precisa de uma key account serviço GCP correspondente no formato JSON .

  1. No menu superior da página da conta de serviço , clique em + CRIAR conta de serviço .

    Criar um serviço GA4 account

  2. Em Grant this service account access to the project (Conceder a essa conta de serviço acesso ao projeto ), habilite as seguintes funções:

    • Visualizador de dados do BigQuery
    • Usuário do BigQuery Job
    • Usuário da sessão de leitura do BigQuery

    Conceder ao serviço account acesso ao projeto BigQuery

  3. Serviço completo account criação.

  4. Na página da conta de serviço , clique no serviço account que o senhor criou.

  5. Na chave tab, clique em ADD key > Create new key .

    Criar um novo key

  6. No modal Create private key , para o tipo de chave , selecione JSON .

  7. Clique em Criar .

    Este downloads seu serviço account JSON key.

    download do serviço account JSON key

Exportar dados do GA4 para o BigQuery​

Identifique a propriedade GA4 da qual o senhor deseja fazer a ingestão e, em seguida, exporte os dados da propriedade para o BigQuery. Para obter instruções, consulte Configurar a exportação do BigQuery na documentação do Google.

atenção

Não crie suas próprias tabelas, como exportações personalizadas ou resultados de query agendados, cujos nomes começam com events no dataset do BigQuery de origem. O conector trata essas tabelas como tabelas de eventos GA4, o que pode causar problemas de evolução de esquema e falhas de pipeline com o erro CANNOT_WRITE_TO_INACTIVE_COLUMNS. Armazene tabelas personalizadas em um dataset separado ou use um prefixo diferente para o nome da tabela.

Nesta página