[Ultimate]{class="badge positive"}

Google BigQuery origem

IMPORTANT
A origem Google BigQuery está disponível no catálogo de origens para usuários que compraram o Real-Time Customer Data Platform Ultimate.

Leia este documento para obter as etapas de pré-requisito que você precisa concluir para conectar com êxito sua conta do Google BigQuery ao Adobe Experience Platform no Azure ou no Amazon Web Services (AWS).

Pré-requisitos prerequisites

Leia as seções a seguir para obter a configuração de pré-requisitos que você deve concluir para poder conectar sua conta do Google BigQuery à Experience Platform.

INCLUO NA LISTA DE PERMISSÕES de endereços IP

Você deve adicionar endereços IP específicos da região ao incluo na lista de permissões antes de conectar suas fontes à Experience Platform no Azure ou no Amazon Web Services (AWS). Para obter mais informações, leia o guia sobre Experience Platform de endereços IP para se conectar ao incluir na lista de permissões no Azure e no AWS para obter mais informações.

Autenticar para o Experience Platform no Azure azure

Você deve fornecer as credenciais a seguir para conectar sua conta do Google BigQuery ao Experience Platform no Azure.

Autenticação básica

Para autenticar usando uma combinação do OAuth 2.0 e a autenticação básica, forneça os valores apropriados para as credenciais a seguir.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
Credencial Descrição
project O projeto é a entidade organizacional básica dos recursos do Google Cloud, incluindo o Google BigQuery.
clientID A ID do cliente é metade das suas credenciais do OAuth 2.0 Google BigQuery.
clientSecret O segredo do cliente é a outra metade das credenciais do OAuth 2.0 do Google BigQuery.
refreshToken

O token de atualização permite obter novos tokens de acesso para a API. Os tokens de acesso têm duração limitada e podem expirar durante o curso do projeto. Você pode usar o token de atualização para autenticar e solicitar tokens de acesso subsequentes para seu projeto quando necessário. Certifique-se de que o token de atualização inclua os seguintes Google escopos OAuth:

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

Esses escopos permitem que o Experience Platform envie trabalhos do BigQuery e leia dados do seu projeto configurado.

largeResultsDataSetId

(Opcional) A ID do conjunto de dados Google BigQuery pré-criada que é necessária para habilitar o suporte para grandes conjuntos de resultados.

  • O largeResultsDataSetId deve se referir a um conjunto de dados BigQuery pré-criado usado para armazenar tabelas temporárias para conjuntos de resultados grandes.
  • O valor deve conter somente a ID do conjunto de dados (por exemplo, marketing_temp_results), não o nome qualificado do projeto (não use my-project.marketing_temp_results).
  • A localização (região) do conjunto de dados especificado em largeResultsDataSetId deve corresponder à localização das tabelas que estão sendo consultadas.
  • A conta usada pelo conector deve ter permissões para ler e gravar resultados temporários neste conjunto de dados. No mínimo, atribua a função BigQuery Data Editor no conjunto de dados especificado em largeResultsDataSetId.

Funções IAM necessárias para a identidade Google

A identidade Google usada para gerar as credenciais OAuth (ID do cliente, segredo do cliente e refreshToken) deve ter as seguintes funções IAM no projeto de destino Google Cloud:

  • BigQuery Job User
  • BigQuery Data Viewer
  • BigQuery Read Session User

Essas funções garantem que o Experience Platform possa criar e executar BigQuery trabalhos, ler dados das tabelas configuradas e usar sessões de leitura conforme exigido pelo conector. Verifique se essas funções são concedidas no mesmo projeto que contém os conjuntos de dados BigQuery que você planeja usar com a origem.

Para obter instruções detalhadas sobre como gerar credenciais OAuth 2.0 para APIs Google, consulte o Google guia de autenticação do OAuth 2.0 a seguir.

Autenticação de serviço

Para autenticar usando a autenticação de serviço, forneça os valores apropriados para as credenciais a seguir.

Observação: sua conta de serviço deve ter permissões suficientes, como BigQuery Job User, BigQuery Data Viewer, BigQuery Read Session User e BigQuery Data Owner, para ser autenticada com êxito com a autenticação de serviço.

table 0-row-2 1-row-2 2-row-2 3-row-2
Credencial Descrição
projectId A ID do Google BigQuery que você deseja consultar.
keyFileContent O arquivo de chave usado para autenticar a conta de serviço. Você pode recuperar este valor do Google Cloud service accounts painel. O conteúdo principal do arquivo está no formato JSON. Você deve codificar isso em Base64 ao autenticar no Experience Platform.
largeResultsDataSetId

(Opcional) A ID do conjunto de dados Google BigQuery pré-criada que é necessária para habilitar o suporte para grandes conjuntos de resultados.

  • O largeResultsDataSetId deve se referir a um conjunto de dados BigQuery pré-criado usado para armazenar tabelas temporárias para conjuntos de resultados grandes.
  • O valor deve conter somente a ID do conjunto de dados (por exemplo, marketing_temp_results), não o nome qualificado do projeto (não use my-project.marketing_temp_results).
  • A localização (região) do conjunto de dados especificado em largeResultsDataSetId deve corresponder à localização das tabelas que estão sendo consultadas.
  • A conta usada pelo conector deve ter permissões para ler e gravar resultados temporários neste conjunto de dados. No mínimo, atribua a função BigQuery Data Editor no conjunto de dados especificado em largeResultsDataSetId.

Para obter mais informações sobre o uso de contas de serviço no Google BigQuery, leia o manual sobre uso de contas de serviço no Google BigQuery.

Autenticar para o Experience Platform no AWS aws

Você deve fornecer as credenciais a seguir para conectar sua conta do Google BigQuery ao Experience Platform no AWS.

Credencial
Descrição
projectId
A ID do Google BigQuery que você deseja consultar.
keyFileContent
O arquivo de chave usado para autenticar a conta de serviço. Você pode recuperar este valor do Google Cloud service accounts painel. O conteúdo principal do arquivo está no formato JSON. Você deve codificar isso em Base64 ao autenticar no Experience Platform.
datasetId
A ID do conjunto de dados Google BigQuery. Essa ID representa onde as tabelas de dados estão localizadas.

Conectar Google BigQuery ao Experience Platform

A documentação abaixo fornece informações sobre como conectar o Google BigQuery ao Experience Platform usando APIs ou a interface do usuário:

Uso de APIs

Uso da interface

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089