Attivare BigQuery Data Transfer Service

Per utilizzare BigQuery Data Transfer Service, devi completare i seguenti passaggi come proprietario del progetto:

• Creare un progetto e abilitare l'API BigQuery.
• Abilitare BigQuery Data Transfer Service.

Per saperne di più sui ruoli IAM (Identity and Access Management), consulta la Panoramica sui ruoli nella documentazione di IAM.

Nota: se chiami l'API BigQuery Data Transfer Service subito dopo aver attivato BigQuery Data Transfer Service tramite programmazione, devi implementare una chiamata recuperabile con ritardi di backoff tra le chiamate consecutive. Questo è necessario perché l'attivazione dell'API è asincrona e soggetta a ritardi di propagazione causati dalla coerenza eventuale.

Crea un progetto e abilita l'API BigQuery

Prima di utilizzare BigQuery Data Transfer Service, devi creare un progetto e, nella maggior parte dei casi, abilitare la fatturazione per quel progetto. Puoi utilizzare un progetto esistente con BigQuery Data Transfer Service o crearne uno nuovo. Se utilizzi un progetto esistente, potresti anche dover attivare l'API BigQuery.

Per creare un progetto e attivare l'API BigQuery:

1. In the Google Cloud console, go to the project selector page.

   Go to project selector

2. Select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

3. Abilita la fatturazione sul progetto per tutti i trasferimenti. Non ti viene addebitato alcun costo per i trasferimenti gratuiti.

   L'abilitazione della fatturazione è richiesta una sola volta per progetto, anche se trasferire dati da più origini. La fatturazione deve essere abilitata anche per eseguire una query sui dati in BigQuery, dopo che i dati sono stati trasferiti.

   Scopri come verificare che la fatturazione sia abilitata sul tuo progetto.

4. BigQuery viene attivato automaticamente nei nuovi progetti. Per attivare BigQuery in un progetto esistente, abilita il l'API BigQuery.
   
   Abilita l'API BigQuery

Abilita BigQuery Data Transfer Service

Prima di poter creare un trasferimento, devi attivare BigQuery Data Transfer Service. A abilitare BigQuery Data Transfer Service, devi ricevere Proprietario per il tuo progetto.

Per attivare BigQuery Data Transfer Service:

1. Apri la pagina dell'API BigQuery Data Transfer nella raccolta di API.

2. Dal menu a discesa, seleziona il progetto appropriato.

3. Fai clic sul pulsante ABILITA.

   Abilita l'API Data Transfer

Agente di servizio

BigQuery Data Transfer Service utilizza un agente di servizio per accedere alle tue risorse e gestirle. Rientrano in questa categoria, a titolo esemplificativo, quanto segue: di risorse:

• Recupero di un token di accesso per l'account di servizio da utilizzare durante l'autorizzazione il trasferimento dei dati.
• Pubblicazione di notifiche nell'argomento Pub/Sub fornito, se abilitato.
• Avvio dei job BigQuery in corso...

L'agente di servizio viene creato automaticamente per tuo conto dopo aver attivato BigQuery Data Transfer Service e aver utilizzato l'API per la prima volta. Al momento della creazione dell'agente di servizio, Google concede automaticamente il ruolo agente di servizio predefinito.

Autorizzazione dell'account di servizio tra progetti

Se autorizzi il trasferimento di dati utilizzando un account di servizio da un progetto che è diverso dal progetto con BigQuery Data Transfer Service abilitato, devi concedi il ruolo roles/iam.serviceAccountTokenCreator all'agente di servizio utilizzando questo comando per Google Cloud CLI:

gcloud iam service-accounts add-iam-policy-binding service_account \
--member serviceAccount:[e-mail] \
--role roles/iam.serviceAccountTokenCreator

Dove:

• service_account è l'account di servizio tra progetti utilizzato per autorizzare il trasferimento dei dati.
• project_number è il numero del progetto in cui è abilitato BigQuery Data Transfer Service.

Per ulteriori informazioni sulla configurazione delle risorse tra progetti, consulta Configurazione per una risorsa in un altro progetto nella documentazione sull'usurpazione dell'identità dell'account servizio Identity and Access Management.

Creazione manuale dell'agente di servizio

Se vuoi attivare la creazione dell'agente di servizio prima di interagire con l'API, ad esempio se devi concedere ruoli aggiuntivi all'agente di servizio, puoi utilizzare uno dei seguenti approcci:

• API: services.GenerateServiceIdentity
• Interfaccia a riga di comando gcloud: gcloud beta services identity create
• Provider Terraform: google_project_service_identity

Quando attivi manualmente la creazione dell'agente di servizio, Google non concede automaticamente il ruolo dell'agente di servizio predefinito. Devi concedere manualmente all'agente di servizio il ruolo predefinito utilizzando questo comando di Google Cloud CLI:

gcloud projects add-iam-policy-binding project_number \
--member serviceAccount:[e-mail] \
--role roles/bigquerydatatransfer.serviceAgent

Dove:

• project_number è il numero del progetto in cui BigQuery Data Transfer Service è abilitato.

Avviso: non revocare il ruolo di agente di servizio dall'agente di servizio. Se revocare il ruolo, BigQuery Data Transfer Service non funzionerà più.

Concedi l'accesso a bigquery.admin

Ti consigliamo di concedere il ruolo IAM predefinito bigquery.admin agli utenti che creano trasferimenti di BigQuery Data Transfer Service. Il ruolo bigquery.admin include le autorizzazioni IAM necessarie per: eseguire le attività più comuni. Il ruolo bigquery.admin include le seguenti autorizzazioni di BigQuery Data Transfer Service:

• Autorizzazioni BigQuery Data Transfer Service:
  • bigquery.transfers.update
  • bigquery.transfers.get
• Autorizzazioni BigQuery:
  • bigquery.datasets.get
  • bigquery.datasets.update
  • bigquery.jobs.create

Nota: se il ruolo bigquery.admin è troppo ampio per un caso d'uso specifico, puoi: crea un ruolo IAM personalizzato con le autorizzazioni necessarie.

In alcuni casi, le autorizzazioni richieste potrebbero variare in base alle diverse sorgenti di dati. Per informazioni specifiche su IAM, consulta la sezione "Autorizzazioni richieste" in ogni guida al trasferimento delle origini dati. Ad esempio, consulta Autorizzazioni di trasferimento Amazon S3 o autorizzazioni di trasferimento di Cloud Storage.

Per concedere il ruolo bigquery.admin:

Console

1. Apri la pagina IAM nella console Google Cloud

   Apri la pagina IAM

2. Fai clic su Seleziona un progetto.

3. Seleziona un progetto e fai clic su Apri.

4. Fai clic su Aggiungi per aggiungere nuovi membri al progetto e impostarne le autorizzazioni.

5. Nella finestra di dialogo Aggiungi membri:

   • In Membri, inserisci l'indirizzo email dell'utente o del gruppo.
   • Nel menu a discesa Seleziona un ruolo, fai clic su BigQuery > Amministratore BigQuery.

   • Fai clic su Aggiungi.

     

gcloud

Puoi utilizzare Google Cloud CLI per concedere a un utente o un gruppo il ruolo bigquery.admin.

Per aggiungere una singola associazione al criterio IAM del progetto, digita il comando seguente. Per aggiungere un utente, fornisci il flag --member nel formato user:[e-mail]. Per aggiungere un gruppo, fornisci il flag --member nel formato group:[e-mail].

gcloud projects add-iam-policy-binding project_id \
--member principal:address \
--role roles/bigquery.admin

Dove:

• project_id è l'ID progetto.
• principal è group o user.
• address è l'indirizzo email dell'utente o del gruppo.

Ad esempio:

gcloud projects add-iam-policy-binding myproject \
--member group:[e-mail] \
--role roles/bigquery.admin

Il comando genera l'output del criterio aggiornato:

    bindings:
    - members:
      - group:[e-mail]
        role: roles/bigquery.admin
    

Per ulteriori informazioni sui ruoli IAM in BigQuery, consulta Ruoli e autorizzazioni predefiniti.

Passaggi successivi

Dopo aver attivato BigQuery Data Transfer Service, crea un trasferimento per l'origine dati.

• Amazon S3
• Amazon Redshift
• Archiviazione BLOB di Azure
• Campaign Manager
• Cloud Storage
• Display e Video a 360°
• Inserzioni di Facebook (anteprima)
• Google Ad Manager
• Google Ads
• Google Merchant Center (anteprima)
• Google Play
• Oracle (anteprima)
• Salesforce (anteprima)
• Salesforce Marketing Cloud (anteprima)
• Search Ads 360
• ServiceNow (anteprima)
• Teradata
• Canale YouTube
• Proprietario dei contenuti YouTube