Caricare i dati di Salesforce in BigQuery

Salesforce Classic

Recuperare 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 Il mio dominio.
4. Nei risultati di ricerca, fai clic su Domain Management (Gestione dominio) > My Domain (Il mio dominio).

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

Recupera i dettagli di ClientId e ClientSecret

Per trovare i valori di ClientId e ClientSecret:

1. Accedi alla piattaforma Salesforce.
2. Fai clic su Configurazione.
3. Nella barra di ricerca, cerca App.
4. Nella sezione Crea dei risultati di ricerca, fai clic su Crea > App.
5. Fai clic su un nome di app collegata.
6. Nella pagina dei dettagli App collegate, fai clic su Gestisci i dettagli del consumatore.
7. Verifica la tua identità utilizzando uno dei metodi registrati. Puoi visualizzare la pagina dei dettagli del consumatore per un massimo di cinque minuti prima che ti venga chiesto di verificare nuovamente la tua identità.
8. Nella pagina Dettagli utente, la Consumer Key è il valore di ClientId. Il Customer Secret è il tuo valore ClientSecret.

Salesforce Lightning Experience

Recuperare i dettagli di myDomain

Per trovare il tuo myDomain:

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

1. Nella barra di ricerca, cerca Il mio dominio.
2. Nei risultati di ricerca, fai clic su Impostazioni azienda > Il mio dominio.

Nella sezione Dettagli del mio dominio, il tuo myDomain viene visualizzato come prefisso nell'URL corrente di My Domain. Ad esempio, se l'URL del 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 e fai clic su Visualizza.
6. Fai clic su Gestisci i dettagli del consumer.
7. Verifica la tua identità utilizzando uno dei metodi registrati. Puoi visualizzare la pagina dei dettagli del consumatore per un massimo di cinque minuti prima che ti venga chiesto di verificare nuovamente la tua identità.
8. Nella pagina Dettagli utente, la Consumer Key è il valore di ClientId. Il Customer Secret è il tuo valore ClientSecret.

Console

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

   Vai a Trasferimenti dati

2. Fai clic su add Crea trasferimento.

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

4. Nella sezione Dettagli origine dati, segui questi passaggi:

   • Per Il mio dominio, inserisci Il mio dominio di Salesforce.
   • Per ID client, inserisci la chiave utente dell'applicazione collegata a Salesforce.
   • Per Client secret, inserisci il secret consumer dell'applicazione collegata a Salesforce.

   • Per Oggetti Salesforce da trasferire, fai clic su Sfoglia per selezionare gli oggetti da trasferire al set di dati di destinazione BigQuery. In questo campo puoi anche inserire manualmente gli oggetti da includere nel trasferimento di dati.

     

5. Nella sezione Impostazioni destinazione, in Set di dati, scegli il set di dati che hai creato per archiviare i dati.

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

7. Nella sezione Opzioni di pianificazione:

   • Nell'elenco Frequenza di ripetizione, seleziona un'opzione per specificare la frequenza con cui viene eseguito questo trasferimento di dati. Per specificare una frequenza di ripetizione personalizzata, seleziona Personalizzata. Se selezioni On demand, l'esecuzione avviene quando attivi manualmente il trasferimento.
   • Se applicabile, seleziona Inizia ora o Inizia all'ora impostata e fornisci una data di inizio e un'ora di esecuzione.

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

   • Per attivare le notifiche via email, fai clic sul pulsante di attivazione/disattivazione Notifica email. Quando attivi questa opzione, l'amministratore del trasferimento riceve una notifica via email quando l'esecuzione di un trasferimento non riesce.
   • Per attivare le notifiche di esecuzione del trasferimento Pub/Sub per questo trasferimento, fai clic sul pulsante di attivazione/disattivazione Notifiche Pub/Sub. Puoi selezionare il nome del tuo argomento oppure fare clic su Crea un argomento per crearne uno.

9. 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:

• (Facoltativo) PROJECT_ID: il tuo ID progetto Google Cloud . Se non viene fornito --project_id per specificare un progetto particolare, viene utilizzato il progetto predefinito.
• DATA_SOURCE: l'origine dati salesforce.
• NAME: il nome visualizzato per la configurazione del trasferimento dei dati. Il nome del trasferimento può essere qualsiasi valore che ti consenta di 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 la configurazione del trasferimento creato in formato JSON. Ad esempio: --params='{"param":"param_value"}'. Di seguito sono riportati i parametri per 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 connessa a Salesforce.
  • connector.authentication.oauth.myDomain: il Mio dominio Salesforce. Ad esempio, se l'URL del tuo dominio è example.my.salesforce.com, il valore è example.
  • assets: il percorso degli oggetti Salesforce da trasferire a BigQuery.

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

API

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