Source Google BigQuery

Last update: Tue Mar 24 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :

Créé pour :

Développeur

IMPORTANT

La source Google BigQuery est disponible dans le catalogue des sources pour les utilisateurs qui ont acheté Real-Time Customer Data Platform Ultimate.

Lisez ce document pour connaître les étapes préalables à suivre pour connecter votre compte Google BigQuery à Adobe Experience Platform sur Azure ou Amazon Web Services (AWS).

Conditions préalables prerequisites

Lisez les sections suivantes pour connaître les conditions préalables à la configuration que vous devez remplir avant de pouvoir connecter votre compte Google BigQuery à Experience Platform.

Liste autorisée d’adresses IP

Vous devez ajouter à votre liste autorisée des adresses IP spécifiques à une région avant de connecter vos sources à Experience Platform sur Azure ou Amazon Web Services (AWS). Pour plus d’informations, consultez le guide sur la liste autorisée des adresses IP pour se connecter à Experience Platform sur Azure et AWS.

Authentification à Experience Platform sur Azure azure

Vous devez fournir les informations d’identification suivantes pour connecter votre compte Google BigQuery à Experience Platform sur Azure.

Authentification de base

Pour vous authentifier à l’aide d’une combinaison d’OAuth 2.0 et de l’authentification de base, fournissez les valeurs appropriées pour les informations d’identification suivantes.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
Informations d’identification	Description
`project`	Le projet est l’entité d’organisation de base pour vos ressources Google Cloud, y compris les Google BigQuery.
`clientID`	L’ID client correspond à la moitié de vos informations d’identification OAuth 2.0 Google BigQuery.
`clientSecret`	Le secret client correspond à l’autre moitié de vos informations d’identification OAuth 2.0 Google BigQuery.
`refreshToken`	Le jeton d’actualisation vous permet d’obtenir de nouveaux jetons d’accès pour votre API. Les jetons d’accès ont une durée de vie limitée et peuvent expirer au cours de votre projet. Vous pouvez utiliser le jeton d’actualisation pour vous authentifier et demander des jetons d’accès ultérieurs pour votre projet, si nécessaire. Assurez-vous que votre jeton d’actualisation inclut les portées OAuth Google suivantes : `https://www.googleapis.com/auth/bigquery` `https://www.googleapis.com/auth/cloud-platform` Ces portées permettent à Experience Platform d’envoyer des tâches BigQuery et de lire les données de votre projet configuré.
`largeResultsDataSetId`	(Facultatif) Identifiant de jeu de données Google BigQuery précréé et requis pour permettre la prise en charge de jeux de résultats volumineux. Le `largeResultsDataSetId` doit faire référence à un jeu de données BigQuery précréé utilisé pour stocker des tables temporaires pour des jeux de résultats volumineux. La valeur doit contenir uniquement l’identifiant du jeu de données (par exemple, `marketing_temp_results`), et non le nom qualifié du projet (n’utilisez pas `my-project.marketing_temp_results`). L’emplacement (région) du jeu de données spécifié dans `largeResultsDataSetId` doit correspondre à l’emplacement des tables interrogées. Le compte utilisé par le connecteur doit disposer des autorisations pour lire et écrire des résultats temporaires dans ce jeu de données. Au minimum, attribuez le rôle BigQuery Data Editor sur le jeu de données spécifié dans `largeResultsDataSetId`.

Rôles IAM requis pour l’identité Google

L’identité Google utilisée pour générer les informations d’identification OAuth (identifiant client, secret client et refreshToken) doit avoir les rôles IAM suivants dans le projet de Google Cloud cible :

BigQuery Job User
BigQuery Data Viewer
BigQuery Read Session User

Ces rôles permettent de s’assurer qu’Experience Platform peut créer et exécuter des tâches BigQuery, lire les données des tables configurées et utiliser des sessions de lecture selon les besoins du connecteur. Assurez-vous que ces rôles sont accordés dans le même projet qui contient les jeux de données BigQuery que vous prévoyez d’utiliser avec la source.

Pour obtenir des instructions détaillées sur la génération des informations d’identification OAuth 2.0 pour les API Google, consultez le guide d’authentification Google OAuth 2.0 suivant.

Authentification du service

Pour vous authentifier à l’aide de l’authentification de service, indiquez les valeurs appropriées pour les informations d’identification suivantes.

Remarque : votre compte de service doit disposer des autorisations suffisantes, telles que : BigQuery Job User, BigQuery Data Viewer, BigQuery Read Session User et BigQuery Data Owner, pour réussir l’authentification avec l’authentification de service.

table 0-row-2 1-row-2 2-row-2 3-row-2
Informations d’identification	Description
`projectId`	L’identifiant du Google BigQuery sur lequel vous souhaitez effectuer une requête.
`keyFileContent`	Fichier de clé utilisé pour authentifier le compte de service. Vous pouvez récupérer cette valeur à partir du Google Cloud service accounts tableau de bord. Le contenu du fichier de clé est au format JSON. Vous devez l’encoder en Base64 lors de l’authentification à Experience Platform.
`largeResultsDataSetId`	(Facultatif) Identifiant de jeu de données Google BigQuery précréé et requis pour permettre la prise en charge de jeux de résultats volumineux. Le `largeResultsDataSetId` doit faire référence à un jeu de données BigQuery précréé utilisé pour stocker des tables temporaires pour des jeux de résultats volumineux. La valeur doit contenir uniquement l’identifiant du jeu de données (par exemple, `marketing_temp_results`), et non le nom qualifié du projet (n’utilisez pas `my-project.marketing_temp_results`). L’emplacement (région) du jeu de données spécifié dans `largeResultsDataSetId` doit correspondre à l’emplacement des tables interrogées. Le compte utilisé par le connecteur doit disposer des autorisations pour lire et écrire des résultats temporaires dans ce jeu de données. Au minimum, attribuez le rôle BigQuery Data Editor sur le jeu de données spécifié dans `largeResultsDataSetId`.

Pour plus d’informations sur l’utilisation des comptes de service dans Google BigQuery, consultez le guide sur l’utilisation de comptes de service dans Google BigQuery.

Authentification à Experience Platform sur AWS aws

Vous devez fournir les informations d’identification suivantes pour connecter votre compte Google BigQuery à Experience Platform sur AWS.

Informations d’identification

Description

projectId

L’identifiant du Google BigQuery sur lequel vous souhaitez effectuer une requête.

keyFileContent

Fichier de clé utilisé pour authentifier le compte de service. Vous pouvez récupérer cette valeur à partir du Google Cloud service accounts tableau de bord. Le contenu du fichier de clé est au format JSON. Vous devez l’encoder en Base64 lors de l’authentification à Experience Platform.

datasetId

Identifiant du jeu de données Google BigQuery. Cet identifiant représente l’emplacement de vos tables de données.

Connexion de Google BigQuery à Experience Platform

La documentation ci-dessous fournit des informations sur la connexion de Google BigQuery à Experience Platform à l’aide d’API ou de l’interface utilisateur :

Utiliser les API

Utilisation de l’interface utilisateur

recommendation-more-help

337b99bb-92fb-42ae-b6b7-c7042161d089