[Ultimate]{class="badge positive"}

Fuente de Google BigQuery

IMPORTANT
El origen Google BigQuery está disponible en el catálogo de orígenes para los usuarios que han adquirido Real-Time Customer Data Platform Ultimate.

Lea este documento para conocer los pasos necesarios que debe seguir para conectar correctamente su cuenta de Google BigQuery a Adobe Experience Platform en Azure o Amazon Web Service (AWS).

Requisitos previos prerequisites

Lea las siguientes secciones para la configuración de requisitos previos que debe completar antes de poder conectar su cuenta de Google BigQuery a Experience Platform.

LISTA DE PERMITIDOS de direcciones IP

Debe añadir direcciones IP específicas de la región a la lista de permitidos antes de conectar las fuentes a Experience Platform en Azure o Amazon Web Service (AWS). Para obtener más información, lea la guía de inclusión en la lista de permitidos de direcciones IP para conectarse a Experience Platform en Azure y AWS.

Autenticar en Experience Platform en Azure azure

Debe proporcionar las siguientes credenciales para conectar su cuenta de Google BigQuery a Experience Platform en Azure.

Autenticación básica

Para autenticarse con una combinación de OAuth 2.0 y autenticación básica, proporcione los valores adecuados para las siguientes credenciales.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
Credencial Descripción
project El proyecto es la entidad organizadora de nivel base para los recursos de Google Cloud, entre ellos Google BigQuery.
clientID El ID de cliente es la mitad de sus credenciales de Google BigQuery OAuth 2.0.
clientSecret El secreto de cliente es la otra mitad de sus credenciales de OAuth 2.0 de Google BigQuery.
refreshToken

El token de actualización le permite obtener nuevos tokens de acceso para su API. Los tokens de acceso tienen una duración limitada y pueden caducar durante el transcurso del proyecto. Puede utilizar el token de actualización para autenticar y solicitar tokens de acceso posteriores para su proyecto cuando sea necesario. Asegúrese de que el token de actualización incluya los siguientes Google ámbitos de OAuth:

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

Estos ámbitos permiten a Experience Platform enviar trabajos de BigQuery y leer datos del proyecto configurado.

largeResultsDataSetId

(Opcional) El ID del conjunto de datos Google BigQuery creado previamente que es necesario para habilitar la compatibilidad con grandes conjuntos de resultados.

  • largeResultsDataSetId debe hacer referencia a un conjunto de datos BigQuery creado previamente que se usa para almacenar tablas temporales para grandes conjuntos de resultados.
  • El valor solo debe contener el identificador del conjunto de datos (por ejemplo, marketing_temp_results), no el nombre completo del proyecto (no use my-project.marketing_temp_results).
  • La ubicación (región) del conjunto de datos especificado en largeResultsDataSetId debe coincidir con la ubicación de las tablas consultadas.
  • La cuenta utilizada por el conector debe tener permisos para leer y escribir resultados temporales en este conjunto de datos. Como mínimo, asigne el rol BigQuery Data Editor en el conjunto de datos especificado en largeResultsDataSetId.

Roles IAM necesarios para la identidad Google

La identidad Google utilizada para generar las credenciales de OAuth (ID de cliente, secreto de cliente y refreshToken) debe tener los siguientes roles de IAM en el proyecto de destino Google Cloud:

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

Estas funciones garantizan que Experience Platform pueda crear y ejecutar BigQuery trabajos, leer datos de las tablas configuradas y usar sesiones de lectura según lo requerido por el conector. Asegúrese de que estas funciones se otorguen en el mismo proyecto que contiene los BigQuery conjuntos de datos que planea utilizar con el origen.

Para obtener instrucciones detalladas sobre cómo generar credenciales de OAuth 2.0 para API Google, consulte la siguiente Google guía de autenticación OAuth 2.0.

Autenticación de servicio

Para autenticarse mediante la autenticación del servicio, proporcione los valores adecuados para las siguientes credenciales.

Nota: su cuenta de servicio debe tener permisos suficientes, como: BigQuery Job User, BigQuery Data Viewer, BigQuery Read Session User y BigQuery Data Owner para autenticarse correctamente con la autenticación de servicio.

table 0-row-2 1-row-2 2-row-2 3-row-2
Credencial Descripción
projectId El identificador de Google BigQuery con el que desea realizar la consulta.
keyFileContent El archivo de clave que se utiliza para autenticar la cuenta de servicio. Puede recuperar este valor del Google Cloud service accounts tablero. El contenido del archivo de claves está en formato JSON. Debe codificar esto en Base64 al autenticarse en Experience Platform.
largeResultsDataSetId

(Opcional) El ID del conjunto de datos Google BigQuery creado previamente que es necesario para habilitar la compatibilidad con grandes conjuntos de resultados.

  • largeResultsDataSetId debe hacer referencia a un conjunto de datos BigQuery creado previamente que se usa para almacenar tablas temporales para grandes conjuntos de resultados.
  • El valor solo debe contener el identificador del conjunto de datos (por ejemplo, marketing_temp_results), no el nombre completo del proyecto (no use my-project.marketing_temp_results).
  • La ubicación (región) del conjunto de datos especificado en largeResultsDataSetId debe coincidir con la ubicación de las tablas consultadas.
  • La cuenta utilizada por el conector debe tener permisos para leer y escribir resultados temporales en este conjunto de datos. Como mínimo, asigne el rol BigQuery Data Editor en el conjunto de datos especificado en largeResultsDataSetId.

Para obtener más información sobre cómo usar cuentas de servicio en Google BigQuery, lea la guía sobre usar cuentas de servicio en Google BigQuery.

Autenticar en Experience Platform en AWS aws

Debe proporcionar las siguientes credenciales para conectar su cuenta de Google BigQuery a Experience Platform en AWS.

Credencial
Descripción
projectId
El identificador de Google BigQuery con el que desea realizar la consulta.
keyFileContent
El archivo de clave que se utiliza para autenticar la cuenta de servicio. Puede recuperar este valor del Google Cloud service accounts tablero. El contenido del archivo de claves está en formato JSON. Debe codificar esto en Base64 al autenticarse en Experience Platform.
datasetId
Identificador del conjunto de datos Google BigQuery. Este ID representa dónde se encuentran las tablas de datos.

Conectar Google BigQuery a Experience Platform

La siguiente documentación proporciona información sobre cómo conectar Google BigQuery a Experience Platform mediante API o la interfaz de usuario:

Uso de API

Uso de la IU

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