Utilizza account di servizio
Alcune origini dati supportano l'autenticazione Data Transfer utilizzando un account di servizio tramite la console Google Cloud, l'API o la riga di comando bq
. Un account di servizio è un Account Google associato al tuo progetto Google Cloud. Un account di servizio può eseguire job, ad esempio query pianificate o pipeline di elaborazione batch, autenticandosi con le credenziali dell'account di servizio anziché con le credenziali di un utente.
Puoi aggiornare un trasferimento di dati esistente con le credenziali di un account di servizio. Per ulteriori informazioni, vedi Aggiornare le credenziali di Data Transfer.
Le seguenti situazioni richiedono l'aggiornamento delle credenziali:
Il trasferimento non ha autorizzato l'accesso dell'utente all'origine dati:
Error code 401 : Request is missing required authentication credential. UNAUTHENTICATED
Quando tenti di eseguire il trasferimento, ricevi un errore INVALID_USER:
Error code 5 : Authentication failure: User Id not found. Error code: INVALID_USERID
Per scoprire di più sull'autenticazione con gli account di servizio, consulta Introduzione all'autenticazione.
Origini dati con assistenza per account di servizio
BigQuery Data Transfer Service può utilizzare le credenziali dell'account di servizio per i trasferimenti con i seguenti dati:
- Cloud Storage
- Amazon Redshift
- Amazon S3
- Campaign Manager
- Copia del set di dati
- Google Ad Manager
- Google Ads
- Google Merchant Center
- Google Play
- Query pianificate
- Search Ads 360
- Teradata
- Proprietario dei contenuti YouTube
Prima di iniziare
- Verifica di aver completato tutte le azioni richieste in Abilitazione di BigQuery Data Transfer Service.
- Concedi i ruoli IAM (Identity and Access Management) che concedono agli utenti le autorizzazioni necessarie per eseguire ogni attività nel documento.
Autorizzazioni obbligatorie
Per aggiornare un trasferimento di dati in modo che utilizzi un account di servizio, devi disporre delle seguenti autorizzazioni:
L'autorizzazione
bigquery.transfers.update
per modificare il trasferimento.Il ruolo IAM
roles/bigquery.admin
predefinito include questa autorizzazione.Accesso all'account di servizio. Per ulteriori informazioni sulla concessione agli utenti del ruolo Account di servizio, consulta Ruolo Utente account di servizio.
Assicurati che l'account di servizio che scegli per eseguire il trasferimento disponga delle seguenti autorizzazioni:
Le autorizzazioni
bigquery.datasets.get
ebigquery.datasets.update
per il set di dati di destinazione. Se la tabella utilizza il controllo dell'accesso a livello di colonna, l'account di servizio deve disporre anche dell'autorizzazionebigquery.tables.setCategory
.Il ruolo IAM predefinito
bigquery.admin
include tutte queste autorizzazioni. Per ulteriori informazioni sui ruoli IAM in BigQuery Data Transfer Service, consulta Introduzione a IAM.Accesso all'origine dati di trasferimento configurata. Per maggiori informazioni sulle autorizzazioni richieste per le diverse origini dati, consulta Origini dati con assistenza per account di servizio.
Aggiornare le credenziali di Data Transfer
Console
La procedura seguente consente di aggiornare la configurazione di un trasferimento di dati in modo da eseguire l'autenticazione come account di servizio anziché come account utente individuale.
Nella console Google Cloud, vai alla pagina Trasferimenti di dati.
Fai clic sul trasferimento nell'elenco dei trasferimenti di dati.
Fai clic su MODIFICA per aggiornare la configurazione di trasferimento.
Nel campo Account di servizio, inserisci il nome dell'account di servizio.
Fai clic su Salva.
bq
Per aggiornare le credenziali di un trasferimento di dati, puoi utilizzare lo strumento a riga di comando bq per aggiornare la configurazione del trasferimento.
Utilizza il comando bq update
con i flag --transfer_config
, --update_credentials
e --service_account_name
.
Ad esempio, il seguente comando aggiorna la configurazione di Data Transfer in modo da eseguire l'autenticazione come account di servizio anziché come account utente individuale:
bq update \
--transfer_config \
--update_credentials \
--service_account_name=abcdef-test-sa@abcdef-test.iam.gserviceaccount.com projects/862514376110/locations/us/transferConfigs/5dd12f26-0000-262f-bc38-089e0820fe38 \
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java disponibili nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API BigQuery Java.
Per eseguire l'autenticazione in BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python disponibili nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API BigQuery Python.
Per eseguire l'autenticazione in BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.