Introduzione ai trasferimenti di dati Salesforce

Puoi caricare i dati da Salesforce Sales Cloud in BigQuery utilizzando il BigQuery Data Transfer Service per Salesforce. Con BigQuery Data Transfer Service, puoi pianificare job di trasferimento ricorrenti che aggiungono i dati più recenti da Salesforce Sales Cloud a BigQuery.

Per scoprire come pianificare un trasferimento Salesforce, consulta Caricare i dati di Salesforce in BigQuery.

Opzioni di acquisizione dei dati

Le sezioni seguenti forniscono ulteriori informazioni sulle opzioni di importazione dati quando configuri un trasferimento di dati Salesforce.

Trasferimenti completi o incrementali

Puoi specificare come caricare i dati in BigQuery selezionando la preferenza di scrittura Completa o Incrementale nella configurazione del trasferimento quando configuri un trasferimento Salesforce.

Puoi configurare un trasferimento di dati completo per trasferire tutti i dati dai set di dati Salesforce a ogni trasferimento di dati.

In alternativa, puoi configurare un trasferimento di dati incrementale per trasferire solo i dati modificati dall'ultimo trasferimento di dati, anziché caricare l'intero set di dati a ogni trasferimento di dati. Se selezioni Incrementale per il trasferimento di dati, devi specificare le modalità di scrittura Aggiungi o Esegui upsert per definire come scrivere i dati in BigQuery durante un trasferimento di dati incrementale. Le sezioni seguenti descrivono le modalità di scrittura disponibili.

Modalità di scrittura Aggiungi

La modalità di scrittura Aggiungi inserisce solo nuove righe nella tabella di destinazione. Questa opzione aggiunge rigorosamente i dati trasferiti senza verificare la presenza di record esistenti, pertanto questa modalità può potenzialmente causare la duplicazione dei dati nella tabella di destinazione.

Quando selezioni la modalità di aggiunta, devi selezionare una colonna watermark. È necessaria una colonna watermark affinché il connettore Salesforce possa monitorare le modifiche nella tabella di origine.

Seleziona una colonna watermark che viene aggiornata solo quando è stato creato il record e non cambia con gli aggiornamenti successivi, ad esempio la colonna CreatedDate.

Modalità di scrittura Esegui upsert

La modalità di scrittura Esegui upsert aggiorna una riga o inserisce una nuova riga nella tabella di destinazione verificando la presenza di una chiave primaria. Puoi specificare una chiave primaria per consentire al connettore Salesforce di determinare le modifiche necessarie per mantenere aggiornata la tabella di destinazione con la tabella di origine. Se la chiave primaria specificata è presente nella tabella BigQuery di destinazione durante un trasferimento di dati, il connettore Salesforce aggiorna la riga con i nuovi dati della tabella di origine. Se non è presente una chiave primaria durante un trasferimento di dati, il connettore Salesforce inserisce una nuova riga.

Quando selezioni la modalità Esegui upsert, devi selezionare una colonna watermark e una chiave primaria:

  • È necessaria una colonna watermark affinché il connettore Salesforce possa monitorare le modifiche nella tabella di origine.

    Seleziona una colonna watermark che si aggiorna ogni volta che una riga viene modificata. Ti consigliamo di utilizzare la colonna SystemModstamp o LastModifiedDate.

  • La chiave primaria può essere una o più colonne della tabella necessarie affinché il connettore Salesforce possa determinare se deve inserire o aggiornare una riga.

    Seleziona le colonne che contengono valori non nulli univoci in tutte le righe della tabella. Ti consigliamo di utilizzare colonne che includono identificatori generati dal sistema, codici di riferimento univoci (ad esempio ID a incremento automatico) o ID di sequenza basati sul tempo immutabili.

    Per evitare potenziali perdite o danneggiamenti dei dati, le colonne della chiave primaria selezionate devono avere valori univoci. Se hai dubbi sull'univocità della colonna della chiave primaria scelta, ti consigliamo di utilizzare la modalità di scrittura Aggiungi.

Comportamento di importazione incrementale

Quando apporti modifiche allo schema della tabella nell'origine dati, i trasferimenti di dati incrementali da queste tabelle vengono applicati a BigQuery nei seguenti modi:

Modifiche all'origine dati Comportamento di importazione incrementale
Aggiunta di una nuova colonna Una nuova colonna viene aggiunta alla tabella BigQuery di destinazione. Tutti i record precedenti per questa colonna avranno valori nulli.
Eliminazione di una colonna La colonna eliminata rimane nella tabella BigQuery di destinazione. Le nuove voci di questa colonna eliminata vengono compilate con valori nulli.
Modifica del tipo di dati in una colonna Il connettore supporta solo le conversioni dei tipi di dati supportate dall'istruzione DDL ALTER COLUMN. Qualsiasi altra conversione del tipo di dati causa il fallimento del trasferimento di dati.

Se riscontri problemi, ti consigliamo di creare una nuova configurazione di trasferimento.
Ridenominazione di una colonna La colonna originale rimane invariata nella tabella BigQuery di destinazione, mentre alla tabella di destinazione viene aggiunta una nuova colonna con il nome aggiornato.

Mappatura dei tipi di dati

La seguente tabella mappa i tipi di dati Salesforce ai tipi di dati BigQuery corrispondenti:

Tipo di dati Salesforce Tipo di dati BigQuery
_bool BOOLEAN
_int INTEGER
_long INTEGER
_double FLOAT
currency FLOAT
percent FLOAT
geolocation (latitude) FLOAT
geolocation (longitude) FLOAT
date DATE
datetime TIMESTAMP
time TIME
picklist STRING
multipicklist STRING
combobox STRING
reference STRING
base64 STRING
textarea STRING
phone STRING
id STRING
url STRING
email STRING
encryptedstring STRING
datacategorygroupreference STRING
location STRING
address STRING
anyType STRING

Prezzi

Per informazioni sui prezzi dei trasferimenti Salesforce, consulta Prezzi di Data Transfer Service.

Passaggi successivi