Pianifica un trasferimento Salesforce

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

Limitazioni

I trasferimenti di dati di Salesforce sono soggetti alle seguenti limitazioni:

  • BigQuery Data Transfer Service per Salesforce supporta solo la piattaforma Salesforce l'API collettiva per connettersi all'istanza Salesforce e supporta solo di entità supportate dall'API Bulk di Salesforce. Per ulteriori informazioni informazioni su quali entità sono supportate, consulta "L'entità non è supportata dall'API Bulk" .
  • L'intervallo di tempo minimo tra un trasferimento di dati ricorrente è di 15 minuti. La l'intervallo predefinito per un bonifico ricorrente è 24 ore.
  • BigQuery Data Transfer Service utilizza l'API collettiva Salesforce v1 per connettersi nell'endpoint Salesforce per recuperare i dati.

Prima di iniziare

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

Crea un'app collegata di Salesforce

Devi creare un'app collegata di Salesforce con le seguenti configurazioni obbligatorie:

  • Configura le informazioni di base nell'app connessa. Nome dell'app collegata e Email di contatto sono obbligatori per un trasferimento Salesforce.
  • Attivare le impostazioni di OAuth con le seguenti configurazioni:
    • Seleziona la casella di controllo Abilita impostazioni OAuth.
    • Nel campo Callback URL (URL di callback), inserisci quanto segue:
      • Per un ambiente di produzione, inserisci https://login.salesforce.com/services/oauth2/token.
      • Per un ambiente sandbox, inserisci https://test.salesforce.com/services/oauth2/token.
  • Nella sezione Ambiti OAuth selezionati, seleziona Gestisci i dati utente tramite API (api).
  • Cancella la chiave di prova obbligatoria per l'estensione PKCE (obbligatoria per lo scambio di codice) per i flussi di autorizzazione supportati. casella di controllo.
  • Seleziona Abilita flusso di credenziali client, quindi fai clic su OK nella che viene visualizzata.

Dopo aver configurato l'app connessa con le configurazioni richieste, fai clic su Salva. Viene visualizzata la pagina dei dettagli del nuovo App collegata.

Una volta creata l'app connessa, devi anche configurare il client il flusso delle credenziali nel seguente modo:

  1. Fai clic su Configurazione.
  2. Nella barra di ricerca, cerca App collegate.
  3. Fai clic su Gestione app > App collegate. Se utilizzi in Salesforce Lightning Experience, fai clic su Gestisci app collegate.
  4. Nell'app collegata che hai creato, fai clic su Modifica.
  5. Viene visualizzata la pagina Dettagli sull'app. Nel Flusso delle credenziali del client inserisci il tuo nome utente nel campo Esegui come. Puoi utilizzare lo lo strumento di ricerca in questo campo per assicurarti di aver selezionato utente.
  6. Fai clic su Salva.

Informazioni Salesforce richieste

Quando crei un'istanza, devi disporre delle seguenti informazioni di Salesforce Trasferimento dei dati di Salesforce:

Nome parametro Descrizione
myDomain Il tuo dominio My Domain in Salesforce.
clientId Chiave utente dell'applicazione collegata a Salesforce.
clientSecret

Client secret OAuth o consumer secret dell'applicazione collegata a Salesforce.

Per ottenere i valori myDomain, clientID e clientSecret, seleziona una delle seguenti opzioni:

Versione classica di Salesforce

Recupera i dettagli di myDomain

Per trovare il tuo myDomain:

  1. Accedi alla piattaforma Salesforce.
  2. Fai clic su Configurazione.
  3. Nella barra di ricerca, cerca My Domain.
  4. Nei risultati di ricerca, fai clic su Domain Management (Gestione dominio) > My Domain (Il mio dominio).

Nella sezione My Domain Details (Dettagli mio dominio), il tuo myDomain viene visualizzato come il prefisso in Current My Domain URL (URL corrente il mio dominio). Ad esempio, se l'URL del mio dominio è example.my.salesforce.com, il valore myDomain da utilizzare è example.

Recupera i dettagli di ClientId e ClientSecret

Per trovare i valori ClientId e ClientSecret:

  1. Accedi alla piattaforma Salesforce.
  2. Fai clic su Configurazione.
  3. Nella barra di ricerca, cerca App.
  4. Nella sezione Crea nei risultati di ricerca, fai clic su Crea > App.
  5. Fai clic su Nome app collegata.
  6. Nella pagina dei dettagli delle app collegate, fai clic su Gestisci dettagli consumatore.
  7. Verifica la tua identità utilizzando uno dei metodi registrati. Puoi visualizzare pagina dei dettagli del consumatore per un massimo di cinque minuti prima che ti venga richiesta la verifica la tua identità.
  8. Nella pagina Dettagli consumatore, la Chiave utente è il tuo ClientId valore. Il Segreto cliente è il valore ClientSecret.

Esperienza Salesforce Lightning

Recupera i dettagli di myDomain

Per trovare il tuo myDomain:

  1. Accedi alla piattaforma Salesforce.
  2. Fai clic su Configurazione.

Apri la pagina Configurazione nella piattaforma Salesforce.

  1. Nella barra di ricerca, cerca My Domain.
  2. Nei risultati di ricerca, fai clic su Company Settings > My Domain (Il mio dominio).

Nella sezione My Domain Details (Dettagli Il mio dominio), il tuo myDomain viene visualizzato come il prefisso in Current My Domain URL (URL corrente il mio dominio). Ad esempio, se l'URL del mio dominio è example.my.salesforce.com, il valore myDomain da utilizzare è example.

Recupera i dettagli di ClientId e ClientSecret

  1. Accedi alla piattaforma Salesforce.
  2. Fai clic su Configurazione.
  3. Nella barra di ricerca, cerca App.
  4. Nei risultati di ricerca, fai clic su App > Gestione app.
  5. Trova un'app collegata, quindi fai clic su Visualizza.
  6. Fai clic su Gestisci dettagli consumatore.
  7. Verifica la tua identità utilizzando uno dei metodi registrati. Puoi visualizzare pagina dei dettagli del consumatore per un massimo di cinque minuti prima che ti venga richiesta la verifica la tua identità.
  8. Nella pagina Dettagli consumatore, la Chiave utente è il tuo ClientId valore. Il Segreto cliente è il valore ClientSecret.

Prerequisiti di BigQuery

Ruoli BigQuery obbligatori

Per ottenere le autorizzazioni necessarie per creare un trasferimento, chiedi all'amministratore di concederti 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 vedere le autorizzazioni esatte obbligatorie, espandi la sezione Autorizzazioni obbligatorie:

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 riuscire a ottenere queste autorizzazioni con ruoli personalizzati e altri ruoli predefiniti.

Configurare un trasferimento di dati di Salesforce

Per creare un trasferimento di dati Salesforce:

Console

  1. Vai alla pagina Trasferimenti di dati nella console Google Cloud.

    Vai a Trasferimenti di dati

  2. Fai clic su Crea trasferimento.

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

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

  5. Nella sezione Opzioni di pianificazione:

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

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

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

  7. Nella sezione Dettagli origine dati:

    • In My Domain (Il mio dominio), inserisci My Domain di Salesforce.
    • In ID client, inserisci la chiave utente dell'applicazione connessa di Salesforce.
    • In Client secret, inserisci il consumer secret dell'applicazione connessa di Salesforce.
    • In Oggetti Salesforce da trasferire, fai clic su Sfoglia per selezionare qualsiasi oggetti da trasferire nella destinazione BigQuery del set di dati.

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

      Configurare una configurazione di trasferimento di Salesforce

  8. Nell'elenco Account di servizio, seleziona un account di servizio associati al tuo progetto Google Cloud. Il servizio selezionato l'account deve disporre dei ruoli richiesti per eseguire questa trasferimento di dati.

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

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

  9. (Facoltativo) Nella sezione Opzioni di notifica, procedi nel seguente modo:

    • Per attivare le notifiche via email, fai clic su Notifica email pulsante di attivazione/disattivazione. Quando abiliti questa opzione, l'amministratore dei trasferimenti riceve una notifica via email quando un trasferimento non va a buon fine.
    • Per attivare Notifiche di esecuzione del trasferimento di Pub/Sub per questo trasferimento, fai clic sull'opzione di attivazione/disattivazione Notifiche Pub/Sub. Tu puoi selezionare argomento personalizzato oppure fai clic su Crea un argomento per crearne uno.
  10. Fai clic su Salva.

bq

Inserisci il comando bq mk. e fornire 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:

  • (Facoltativo) PROJECT_ID: il tuo ID progetto Google Cloud. Se --project_id non viene fornito per specificare un particolare progetto, viene utilizzato il progetto predefinito.
  • DATA_SOURCE: origine dati - salesforce.
  • NAME: il nome visualizzato del trasferimento di dati configurazione. Il nome del trasferimento può essere qualsiasi valore che ti consenta identificare il trasferimento se devi modificarlo in un secondo momento.
  • DATASET: il set di dati di destinazione per la configurazione del trasferimento.
  • PARAMETERS: i parametri per il trasferimento creato configurazione in formato JSON. Ad esempio: --params='{"param":"param_value"}'. Di seguito sono riportati i parametri un trasferimento di dati Salesforce:

    • connector.authentication.oauth.clientId: la chiave utente dell'applicazione collegata a Salesforce.
    • connector.authentication.oauth.clientSecret: client secret OAuth o consumer secret dell'applicazione collegata a Salesforce.
    • connector.authentication.oauth.myDomain: Salesforce My Domain. Ad esempio, se l'URL del tuo dominio è example.my.salesforce.com, il valore è example.
    • assets: il percorso degli oggetti Salesforce da trasferire in BigQuery.

Ad esempio, il comando seguente crea un trasferimento di dati di Salesforce nella 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.authentication.oauth.myDomain":"MyDomainName",}'

API

Utilizza la projects.locations.transferConfigs.create e fornisce un'istanza del metodo TransferConfig risorsa.

Prezzi

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

Risolvere i problemi di configurazione del trasferimento

In caso di problemi durante la configurazione del trasferimento di dati, consulta Problemi di trasferimento di Salesforce.

Passaggi successivi