[Ultimate]{class="badge positive"}

Origine Google BigQuery

IMPORTANT
L'origine Google BigQuery è disponibile nel catalogo delle origini per gli utenti che hanno acquistato Real-Time Customer Data Platform Ultimate.

Leggi questo documento per i passaggi preliminari da completare per connettere correttamente l'account Google BigQuery a Adobe Experience Platform su Azure o Amazon Web Services (AWS).

Prerequisiti prerequisites

Leggere le sezioni seguenti relative alla configurazione dei prerequisiti da completare prima di connettere l'account Google BigQuery ad Experience Platform.

Indirizzo IP inserisco nell'elenco Consentiti

Prima di collegare le origini a Experience Platform su Azure o Amazon Web Services (AWS), è necessario aggiungere al inserisco nell'elenco Consentiti di indirizzi IP specifici per la regione. Per ulteriori informazioni, leggere la guida su inserire nell'elenco Consentiti degli indirizzi IP per la connessione ad Experience Platform su Azure e AWS.

Autenticazione per Experience Platform su Azure azure

Per connettere l'account Google BigQuery a Experience Platform su Azure, è necessario fornire le credenziali seguenti.

Autenticazione di base

Per eseguire l’autenticazione utilizzando una combinazione di OAuth 2.0 e autenticazione di base, fornisci i valori appropriati per le seguenti credenziali.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
Credenziali Descrizione
project Il progetto è l'entità organizzativa di base per le risorse Google Cloud, incluso Google BigQuery.
clientID L'ID client corrisponde alla metà delle credenziali OAuth 2.0 di Google BigQuery.
clientSecret Il segreto client è l'altra metà delle credenziali OAuth 2.0 di Google BigQuery.
refreshToken

Il token di aggiornamento consente di ottenere nuovi token di accesso per l’API. I token di accesso hanno una durata limitata e possono scadere nel corso del progetto. Puoi utilizzare il token di aggiornamento per autenticare e richiedere token di accesso successivi per il progetto, quando necessario. Assicurati che il token di aggiornamento includa i seguenti Google ambiti OAuth:

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

Questi ambiti consentono ad Experience Platform di inviare processi BigQuery e leggere dati dal progetto configurato.

largeResultsDataSetId

(Facoltativo) L'ID del set di dati Google BigQuery precreato necessario per abilitare il supporto per set di risultati di grandi dimensioni.

  • largeResultsDataSetId deve fare riferimento a un set di dati BigQuery precreato utilizzato per memorizzare tabelle temporanee per set di risultati di grandi dimensioni.
  • Il valore deve contenere solo l'ID del set di dati (ad esempio, marketing_temp_results), non il nome qualificato del progetto (non utilizzare my-project.marketing_temp_results).
  • La posizione (area) del set di dati specificato in largeResultsDataSetId deve corrispondere alla posizione delle tabelle su cui viene eseguita la query.
  • L’account utilizzato dal connettore deve disporre delle autorizzazioni per leggere e scrivere risultati temporanei in questo set di dati. Assegnare almeno il ruolo BigQuery Data Editor nel set di dati specificato in largeResultsDataSetId.

Ruoli IAM richiesti per l'identità Google

L'identità Google utilizzata per generare le credenziali OAuth (ID client, segreto client e refreshToken) deve avere i seguenti ruoli IAM nel progetto Google Cloud di destinazione:

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

Questi ruoli consentono ad Experience Platform di creare ed eseguire BigQuery processi, leggere i dati dalle tabelle configurate e utilizzare sessioni di lettura in base alle esigenze del connettore. Assicurarsi che questi ruoli siano concessi nello stesso progetto che contiene i BigQuery set di dati che si intende utilizzare con l'origine.

Per istruzioni dettagliate su come generare credenziali OAuth 2.0 per le API Google, consulta la Google Guida all’autenticazione di OAuth 2.0.

Autenticazione del servizio

Per eseguire l'autenticazione tramite l'autenticazione del servizio, specificare i valori appropriati per le credenziali seguenti.

Nota: l'account del servizio deve disporre di autorizzazioni sufficienti, ad esempio BigQuery Job User, BigQuery Data Viewer, BigQuery Read Session User e BigQuery Data Owner per eseguire l'autenticazione con l'autenticazione del servizio.

table 0-row-2 1-row-2 2-row-2 3-row-2
Credenziali Descrizione
projectId ID di Google BigQuery su cui si desidera eseguire la query.
keyFileContent File di chiave utilizzato per autenticare l'account del servizio. Puoi recuperare questo valore dal Google Cloud service accounts dashboard. Il contenuto del file chiave è in formato JSON. È necessario codificarlo in Base64 durante l'autenticazione in Experience Platform.
largeResultsDataSetId

(Facoltativo) L'ID del set di dati Google BigQuery precreato necessario per abilitare il supporto per set di risultati di grandi dimensioni.

  • largeResultsDataSetId deve fare riferimento a un set di dati BigQuery precreato utilizzato per memorizzare tabelle temporanee per set di risultati di grandi dimensioni.
  • Il valore deve contenere solo l'ID del set di dati (ad esempio, marketing_temp_results), non il nome qualificato del progetto (non utilizzare my-project.marketing_temp_results).
  • La posizione (area) del set di dati specificato in largeResultsDataSetId deve corrispondere alla posizione delle tabelle su cui viene eseguita la query.
  • L’account utilizzato dal connettore deve disporre delle autorizzazioni per leggere e scrivere risultati temporanei in questo set di dati. Assegnare almeno il ruolo BigQuery Data Editor nel set di dati specificato in largeResultsDataSetId.

Per ulteriori informazioni sull'utilizzo degli account del servizio in Google BigQuery, leggere la guida in utilizzo degli account del servizio in Google BigQuery.

Autenticazione per Experience Platform su AWS aws

Per connettere l'account Google BigQuery a Experience Platform su AWS, è necessario fornire le credenziali seguenti.

Credenziali
Descrizione
projectId
ID di Google BigQuery su cui si desidera eseguire la query.
keyFileContent
File di chiave utilizzato per autenticare l'account del servizio. Puoi recuperare questo valore dal Google Cloud service accounts dashboard. Il contenuto del file chiave è in formato JSON. È necessario codificarlo in Base64 durante l'autenticazione in Experience Platform.
datasetId
ID del set di dati Google BigQuery. Questo ID rappresenta dove si trovano le tabelle di dati.

Connetti Google BigQuery ad Experience Platform

La documentazione seguente fornisce informazioni su come connettere Google BigQuery ad Experience Platform tramite API o tramite l'interfaccia utente:

Utilizzo delle API

Utilizzo dell’interfaccia utente

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