Pianifica un trasferimento Salesforce
BigQuery Data Transfer Service per Salesforce consente di pianificare e i job di caricamento ricorrenti da Salesforce a BigQuery.
Limitazioni
I trasferimenti 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 collettiva di Salesforce. Per ulteriori informazioni informazioni su quali entità sono supportate, consulta "L'entità non è supportata dall'API Bulk" .
- L'intervallo minimo tra un trasferimento ricorrente e l'altro è 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 Salesforce.
Prerequisiti di 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:
- Nell'app collegata, fai clic su Configurazione.
Nel campo Ricerca rapida, cerca Impostazioni OAuth e OpenID Connect. e attivare.
Attiva l'autoautorizzazione di un utente per l'app collegata eseguendo la seguenti:
- Nell'app collegata, fai clic su Configurazione.
- Nel campo Ricerca rapida, cerca Gestisci app collegate.
- Fai clic su Modifica nell'app collegata che stai utilizzando per l'esecuzione del trasferimento.
In Criteri OAuth, fai clic sul menu Utenti consentiti e seleziona Tutti gli utenti possono autoautorizzarsi.
In Relax IP, seleziona Allenta limitazioni IP.
Inoltre, quando crei un'istanza, devi disporre delle seguenti informazioni di Salesforce Trasferimento Salesforce:
Nome parametro | Descrizione |
---|---|
clientId |
ClientId o Consumer Key dell'applicazione collegata a Salesforce. |
clientSecret |
Client secret OAuth o consumer secret dell'applicazione collegata a Salesforce. |
username |
Nome utente dell'account Salesforce. |
password |
Password dell'account Salesforce. |
securityToken |
Token di sicurezza dell'account Salesforce. Il token di sicurezza è un codice alfanumerico sensibile alle maiuscole che viene aggiunto alla password. Il token di sicurezza è richiesto per accedere alle API Salesforce al di fuori dell'intervallo IP attendibile della configurazione Salesforce. |
Prerequisiti di BigQuery
- Verifica di aver completato tutte le azioni richieste per abilitare BigQuery Data Transfer Service.
- Crea un set di dati BigQuery per archiviare i dati.
- Se intendi configurare le notifiche di esecuzione del trasferimento per Pub/Sub,
assicurati di disporre dell'autorizzazione Identity and Access Management (IAM) di
pubsub.topics.setIamPolicy
. Pub/Sub le autorizzazioni non sono necessarie se configuri solo le notifiche via email. Per ulteriori informazioni le informazioni, vedi 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
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
Nella console Google Cloud, vai alla pagina BigQuery.
Fai clic su Trasferimenti di dati > Crea un trasferimento.
Nella sezione Tipo di origine, per Origine, scegli Salesforce.
Nella sezione Nome configurazione di trasferimento, per Nome visualizzato, inserisci un nome del trasferimento.
Nella sezione Opzioni di pianificazione:
Nell'elenco Frequenza di ripetizione, seleziona un'opzione per specificare la spesso viene eseguito questo trasferimento. 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.
Nella sezione Impostazioni destinazione, per Set di dati, scegli il creato per archiviare i dati.
Nella sezione Dettagli origine dati:
- Per Dominio personalizzato, inserisci un dominio di accesso personalizzato
se applicabile. Se l'URL di accesso a Salesforce è
login.salesforce.com
otest.salesforce.com
, lascia vuoto questo campo. In URL Salesforce, seleziona il suffisso dell'URL Salesforce termina con l'URL di accesso. Se selezioni
my.salesforce.com
osandbox.my.salesforce.com
, questi valori daranno un suffisso al dominio personalizzato che hai fornito nella Dominio personalizzato.Ad esempio, se hai fornito il dominio personalizzato
mydomain
e selezionatomy.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 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 trasferire in questo campo.
- Per Dominio personalizzato, inserisci un dominio di accesso personalizzato
se applicabile. Se l'URL di accesso a Salesforce è
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.
Se hai eseguito l'accesso con un'identità federata: per creare un trasferimento è necessario un account di servizio. 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.
(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.
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 specificato per specificare un particolare progetto, viene utilizzato il progetto predefinito. - DATA_SOURCE: origine dati -
salesforce
. - NAME: il nome visualizzato del trasferimento 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 Salesforce:connector.authentication.oauth.clientId
: ClientId o Consumer Key dell'applicazione collegata a Salesforce.connector.authentication.oauth.clientSecret
: client secret OAuth o consumer secret dell'applicazione collegata a Salesforce.connector.customDomainName
(facoltativo): il Dominio di accesso personalizzato Salesforce, se applicabile. Lascia vuoto per utilizzare il dominio di accesso predefinitologin.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 in BigQuery.
Ad esempio, il comando seguente crea un trasferimento Salesforce in 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":"user1@force.com", "Connector.authentication.password":"abcdef1234", "connector.authentication.securityToken":"a1hghbb44lnl465lbl75b",}'
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, 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 cambi, inclusa la ricerca di informazioni su un configurazione di trasferimento, elencare le configurazioni di trasferimento e visualizzare cronologia esecuzioni del trasferimento, vedi Utilizzo dei trasferimenti.
- Scopri come caricare i dati con operazioni cross-cloud.