Introduzione ai trasferimenti da 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 da Salesforce, consulta Caricare i dati di Salesforce in BigQuery.

Opzioni di importazione dei dati

Le sezioni seguenti forniscono ulteriori informazioni sulle opzioni di importazione dati quando configuri un trasferimento di dati da 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 da Salesforce.

Puoi configurare un trasferimento di dati completo per trasferire tutti i dati dai set di dati di 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 i dati vengono scritti 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à Aggiungi, devi selezionare una colonna watermark. Il connettore Salesforce richiede una colonna watermark per monitorare le modifiche nella tabella di origine.

Seleziona una colonna watermark che viene aggiornata solo quando il record è stato creato 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:

  • Il connettore Salesforce richiede una colonna watermark per 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 al connettore Salesforce per determinare se è necessario 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'unicità 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 Alla tabella BigQuery di destinazione viene aggiunta una nuova colonna. 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 mancato completamento del trasferimento di dati.

Se riscontri problemi, ti consigliamo di creare una nuova configurazione di trasferimento.
Ridenominazione di una colonna La colonna originale rimane nella tabella BigQuery di destinazione così com'è, 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 di Salesforce ai tipi di dati di BigQuery corrispondenti:

Tipo di dati di Salesforce Tipo di dati di 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 da Salesforce, consulta Prezzi di Data Transfer Service.

Passaggi successivi