Pianificare un trasferimento Salesforce

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Nota: per ricevere assistenza o fornire un feedback su questa funzionalità, contatta [e-mail].

BigQuery Data Transfer Service per Salesforce consente di pianificare e gestire automaticamente i job di caricamento ricorrenti da Salesforce a BigQuery.

Limitazioni

I trasferimenti Salesforce sono soggetti alle seguenti limitazioni:

• BigQuery Data Transfer Service for Salesforce supporta solo l'API collettiva Salesforce per la connessione all'istanza di Salesforce e supporta solo il trasferimento di entità supportate dall'API collettiva Salesforce. Per ulteriori informazioni sulle entità supportate, consulta la pagina relativa all'errore "L'entità non è supportata dall'API collettiva".
• L'intervallo minimo tra trasferimenti ricorrenti è di 15 minuti. L'intervallo predefinito per un bonifico ricorrente è di 24 ore.
• BigQuery Data Transfer Service per Salesforce non supporta le connessioni agli ambienti sandbox di Salesforce.

Prima di iniziare

Le seguenti sezioni descrivono i passaggi da seguire prima di creare un trasferimento Salesforce.

Prerequisiti di Salesforce

Abilita l'API Salesforce Bulk per l'istanza Salesforce.

Crea un'app connessa di Salesforce con le seguenti configurazioni:

• Genera un token di sicurezza per l'app.

• Consenti il flusso di nome utente e password OAuth seguendo questi passaggi:

  1. Nell'app collegata, fai clic su Configura.

  2. Nel campo Ricerca rapida, cerca Impostazioni OAuth e OpenID Connect e attiva l'opzione.

     

• Attiva l'auto-autorizzazione per un utente per l'app collegata seguendo questi passaggi:

  1. Nell'app collegata, fai clic su Configura.
  2. Nel campo Ricerca rapida, cerca Gestisci le app collegate.
  3. Fai clic su Modifica nell'app collegata che utilizzi per l'esecuzione del trasferimento.

  4. In Criteri OAuth, fai clic sul menu Utenti consentiti e seleziona Tutti gli utenti possono eseguire l'autorizzazione automatica.

     

  5. In Relax IP, seleziona Restrizioni IP Relax.

     

Quando crei un trasferimento Salesforce, devi inoltre disporre delle seguenti informazioni su Salesforce:

Nome parametro	Descrizione
clientId	ID client o chiave utente dell'applicazione collegata a Salesforce.
clientSecret	Client secret OAuth o segreto utente dell'applicazione collegata a Salesforce.
username	Nome utente dell'account Salesforce.
password	Password dell'account Salesforce.
securityToken	Token di sicurezza dell'account Salesforce. Questo token di sicurezza è un codice alfanumerico sensibile alle maiuscole che viene aggiunto alla password. Il token di sicurezza è necessario se si accede alle API Salesforce dall'esterno dell'intervallo IP attendibile della configurazione di Salesforce.

Prerequisiti BigQuery

• Verifica di aver completato tutte le azioni necessarie per abilitare BigQuery Data Transfer Service.
• Crea un set di dati BigQuery per archiviare i tuoi dati.
• Se intendi configurare le notifiche di esecuzione del trasferimento per Pub/Sub, assicurati di avere l'autorizzazione pubsub.topics.setIamPolicy Identity and Access Management (IAM). Le autorizzazioni Pub/Sub non sono necessarie se configuri solo le notifiche via email. Per ulteriori informazioni, consulta Notifiche di esecuzione di BigQuery Data Transfer Service.

Ruoli BigQuery obbligatori

Per ottenere le autorizzazioni necessarie per creare un trasferimento, chiedi all'amministratore di concederti il ruolo IAM Amministratore BigQuery (roles/bigquery.admin). Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Questo ruolo predefinito contiene le autorizzazioni necessarie per creare un trasferimento. Per visualizzare le autorizzazioni esatte necessarie, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per creare un trasferimento sono necessarie le seguenti autorizzazioni:

• bigquery.transfers.update sull'utente
• bigquery.datasets.get sul set di dati di destinazione
• bigquery.datasets.update sul set di dati di destinazione

Potresti anche essere in grado di ottenere queste autorizzazioni con i ruoli personalizzati o altri ruoli predefiniti.

Configura un Data Transfer di Salesforce

Per creare un trasferimento di dati Salesforce:

Console

1. Nella console Google Cloud, vai alla pagina BigQuery.

   Vai a BigQuery

2. Fai clic su Trasferimenti di dati > Crea un trasferimento.

3. Nella sezione Tipo di origine, per Origine, scegli Salesforce.

4. Nella sezione Nome configurazione di trasferimento, in Nome visualizzato, inserisci un nome per il trasferimento.

5. Nella sezione Opzioni di pianificazione:

   • Nell'elenco Frequenza di ripetizione, seleziona un'opzione per specificare la frequenza di esecuzione di questo trasferimento. Per specificare una frequenza di ripetizione personalizzata, seleziona Personalizzata. Se selezioni On demand, questo trasferimento viene eseguito quando attivi manualmente il trasferimento.

   • Se applicabile, seleziona Inizia ora o Inizia all'ora impostata e specifica una data di inizio e un'ora di esecuzione.

6. Nella sezione Impostazioni destinazione, per Set di dati, scegli il set di dati creato per archiviare i dati.

7. Nella sezione Dettagli origine dati, procedi nel seguente modo:

   • In Dominio personalizzato, inserisci un dominio di accesso personalizzato, se applicabile. Se l'URL di accesso a Salesforce è login.salesforce.com o test.salesforce.com, lascia vuoto questo campo.

   • In URL Salesforce, seleziona il suffisso con cui termina l'URL di accesso a Salesforce. Se selezioni my.salesforce.com o sandbox.my.salesforce.com, questi valori genereranno il suffisso del dominio personalizzato che hai fornito nel campo Dominio personalizzato.

     Ad esempio, se hai fornito il dominio personalizzato mydomain e hai selezionato my.salesforce.com, l'URL di accesso sarà mydomain.my.salesforce.com.

   • In Nome utente, inserisci il nome utente dell'account Salesforce.

   • In Password, inserisci la password dell'account Salesforce.

   • In Token di sicurezza, inserisci il token di sicurezza dell'account Salesforce.

   • In Client ID, inserisci la chiave utente dell'applicazione collegata a Salesforce.

   • In Client secret, inserisci il consumer secret dell'applicazione connessa di Salesforce.

   • In corrispondenza di Oggetti Salesforce da trasferire, fai clic su Sfoglia per selezionare gli oggetti da trasferire nel set di dati di destinazione BigQuery.

     • Puoi anche inserire manualmente gli oggetti da includere nel trasferimento in questo campo.

     

8. Nell'elenco Account di servizio, seleziona un account di servizio associato al tuo progetto Google Cloud. L'account di servizio selezionato deve disporre dei ruoli richiesti per eseguire questo trasferimento.

   Se hai eseguito l'accesso con un'identità federata, è necessario un account di servizio per creare un trasferimento. Se hai eseguito l'accesso con un Account Google, un account di servizio per il trasferimento è facoltativo.

   Per ulteriori informazioni sull'utilizzo degli account di servizio con il trasferimento di dati, vedi Utilizzare gli account di servizio.

9. (Facoltativo) Nella sezione Opzioni di notifica, segui questi passaggi:

   • Per abilitare le notifiche via email, fai clic sul pulsante di attivazione/disattivazione Notifica via email. Abilitando questa opzione, l'amministratore dei trasferimenti riceve una notifica via email quando un'esecuzione del trasferimento non va a buon fine.
   • Per abilitare le notifiche dell'esecuzione del trasferimento di Pub/Sub per questo trasferimento, fai clic sul pulsante di attivazione/disattivazione Notifiche Pub/Sub. Puoi selezionare il nome dell'argomento o fare clic su Crea un argomento per crearne uno.

10. Fai clic su Salva.

bq

Inserisci il comando bq mk e fornisci il flag di creazione del trasferimento --transfer_config:

bq mk \
    --transfer_config \
    --project_id=PROJECT_ID \
    --data_source=DATA_SOURCE \
    --display_name=NAME \
    --target_dataset=DATASET \
    --params='PARAMETERS'

Dove:

• PROJECT_ID (facoltativo): il tuo ID progetto Google Cloud. Se non viene fornito il valore --project_id per specificare un progetto specifico, viene utilizzato il progetto predefinito.
• DATA_SOURCE: l'origine dati, salesforce.
• NAME: il nome visualizzato per la configurazione di trasferimento. Il nome del trasferimento può essere qualsiasi valore che ti consenta di identificare il trasferimento se devi modificarlo in seguito.
• DATASET: il set di dati di destinazione per la configurazione di trasferimento.

• PARAMETERS: i parametri per la configurazione di trasferimento creata in formato JSON. Ad esempio: --params='{"param":"param_value"}'. Di seguito sono riportati i parametri per un trasferimento Salesforce:

  • connector.authentication.oauth.clientId: ID client o chiave utente dell'applicazione collegata a Salesforce.
  • connector.authentication.oauth.clientSecret: client secret OAuth o client secret dell'applicazione Salesforce collegata.
  • connector.customDomainName (facoltativo): il dominio di accesso personalizzato Salesforce, se applicabile. Lascia il campo vuoto per utilizzare il dominio di accesso predefinito login.Salesforce.com.
  • connector.authentication.username: il nome utente dell'account Salesforce.
  • connector.authentication.password: la password dell'account Salesforce.
  • connector.authentication.securityToken: il token di sicurezza dell'account Salesforce.
  • assets: il percorso degli oggetti Salesforce da trasferire a BigQuery.

Ad esempio, il seguente comando crea un trasferimento Salesforce nel progetto predefinito con tutti i parametri richiesti:

bq mk \
    --transfer_config \
    --target_dataset=mydataset \
    --data_source=salesforce \
    --display_name='My Transfer' \
    --params='{"assets":["Account"],
        "connector.authentication.oauth.clientId": "1234567890",
        "connector.authentication.oauth.clientSecret":"ABC12345",
        "connector.customDomainName":"MyDomainName",
        "connector.authentication.username":"[e-mail]",
        "Connector.authentication.password":"abcdef1234",
        "connector.authentication.securityToken":"a1hghbb44lnl465lbl75b",}'

API

Utilizza il metodo projects.locations.transferConfigs.create e fornisci un'istanza della risorsa TransferConfig.

Prezzi

Non sono previsti costi per il trasferimento dei dati di Salesforce in BigQuery mentre questa funzionalità è in Anteprima.

Risolvere i problemi di configurazione del trasferimento

Se hai problemi durante la configurazione del trasferimento, consulta Problemi di trasferimento di Salesforce.

Passaggi successivi

• Per una panoramica di BigQuery Data Transfer Service, consulta Introduzione a BigQuery Data Transfer Service.
• Per informazioni sull'utilizzo dei trasferimenti, tra cui il recupero di informazioni su una configurazione di trasferimento, l'elenco delle configurazioni di trasferimento e la visualizzazione della cronologia delle esecuzioni di un trasferimento, vedi Utilizzo dei trasferimenti.
• Scopri come caricare dati con le operazioni cross-cloud.