Configurare Salesforce in un'attività attività Copy
Questo articolo illustra come usare l'attività Copy in Azure Data Factory per copiare dati da e in Salesforce.
Configurazione supportata
Per la configurazione di ogni scheda nell'attività Copy, leggere le rispettive sezioni seguenti.
Generali
Per configurare la scheda di impostazioni Generali, vedere la guida alle impostazioni Generali.
Origine
Le proprietà seguenti sono supportate per Salesforce nella scheda Origine di un'attività Copy.
Sono richieste le seguenti proprietà:
- Connessione: selezionare una connessione Salesforce dall'elenco di connessioni. Se non esiste alcuna connessione, creare una nuova connessione Salesforce selezionando Nuovo.
- Usa query: selezionare da API oggetto, Report o Query SOQL.
Se si seleziona API oggetto:
- API oggetto: nome dell'oggetto di Salesforce da cui recuperare i dati. Selezionare l'opzione Nome entità dall'elenco a discesa.
Se si seleziona Report:
ID report: ID del report Salesforce da cui recuperare i dati. Non è supportato nella destinazione. Esistono limitazioni quando si usano i report.
Se si seleziona SOQL Query:
SOQL Query: usare la query personalizzata per leggere i dati. È possibile utilizzare solo le query SOQL (Object Query Language) di Salesforce con le limitazioni di Understanding Bulk API 2.0 Query. Se non si specifica la query SOQL, verranno recuperati tutti i dati dell'oggetto Salesforce specificato in API oggetto o ID report.
In Avanzate, è possibile specificare i campi seguenti:
- Includi oggetti eliminati: specificare se eseguire una query sui record esistenti (deselezionati) o eseguire query su tutti i record, inclusi quelli eliminati (selezionati).
- Colonne aggiuntive: aggiungere altre colonne di dati per archiviare il percorso relativo o il valore statico dei file di origine. L'espressione è supportata per la seconda opzione.
Destinazione
Le proprietà seguenti sono supportate per Salesforce nella scheda Destinazione di un'attività Copy.
Sono richieste le seguenti proprietà:
- Connessione: selezionare una connessione Salesforce dall'elenco di connessioni. Se non esiste alcuna connessione, creare una nuova connessione Salesforce selezionando Nuovo.
- API oggetto: specificare il nome dell'oggetto Salesforce in cui scrivere i dati. Selezionare l'opzione Nome entità dall'elenco a discesa.
In Avanzate, è possibile specificare i campi seguenti:
Comportamento di scrittura: specificare il comportamento di scrittura per l'operazione. I valori consentiti sono: Insert e Upsert. È possibile scegliere un comportamento dall'elenco a discesa.
Se si seleziona Upsert:
Campo ID esterno: nome del campo ID esterno per l'operazione upsert. Il campo specificato deve essere definito come Campo ID esterno nell'oggetto di Salesforce. Non può includere valori NULL nei dati di input corrispondenti.
Ignora valori Null: specificare se ignorare i valori NULL dai dati di input durante un'operazione di scrittura.
- Quando selezionato: i dati nell'oggetto di destinazione rimangono invariati quando si esegue un'operazione di upsert o aggiornamento. Inserire un valore predefinito definito quando si esegue un'operazione di inserimento.
- Quando non selezionato: i dati nell'oggetto di destinazione vengono aggiornati a NULL quando si esegue un'operazione di upsert o aggiornamento. Inserire un valore NULL quando si esegue un'operazione di inserimento.
Dimensioni batch scrittura: conteggio delle righe di dati scritti da Salesforce in ogni batch. Suggerire di impostare questo valore da 10.000 a 200.000. Un numero eccessivo di righe in ogni batch riduce le prestazioni di copia. Un numero eccessivo di righe in ogni batch può causare un timeout dell'API.
Numero massimo di connessioni simultanee: limite massimo di connessioni simultanee stabilite all'archivio dati durante l'esecuzione dell'attività. Specificare un valore solo quando si desidera limitare le connessioni simultanee.
Mapping
Per la configurazione della scheda Mapping, vedere Configurare i mapping nella scheda Mapping.
Impostazione
Per la configurazione della scheda Impostazioni, vedere Configurare le altre impostazioni nella scheda Impostazioni.
Tabella di riepilogo
Le tabelle seguenti contengono altre informazioni sull'attività Copy in Salesforce.
Informazioni sull'origine
| Nome | Descrizione | valore | Richiesto | Proprietà script JSON |
|---|---|---|---|---|
| Connessione | Collegamento all'archivio dati di origine. | <connessione salesforce> | Sì | connection |
| Tipo di connessione | Tipo di connessione in uso. Selezionare Oggetti Salesforce. | SalesforceObject | Sì | / |
| Usa query | Modo per leggere i dati da Salesforce. | • API oggetto • Report • Query SOQL |
Sì | / |
| Per Oggetto API | ||||
| Oggetto API | Specificare il nome dell'oggetto Salesforce da cui recuperare i dati. | < nome dell'oggetto > | Sì | objectApiName |
| Per report | ||||
| ID report | ID del report Salesforce da cui recuperare i dati. Non è supportato nella destinazione. Esistono limitazioni quando si usano i report. | <ID report> | Sì | reportId |
| Per query SOQL | ||||
| Query SOQL | Usare la query personalizzata per leggere i dati. È possibile utilizzare solo le query SOQL (Object Query Language) di Salesforce con le limitazioni di Understanding Bulk API 2.0 Query. Se non si specifica la query SOQL, verranno recuperati tutti i dati dell'oggetto Salesforce specificato in API oggetto o ID report. | < query SOQL > | Sì | query |
| Includere oggetti eliminati | Indica se eseguire query sui record esistenti o su tutti i record inclusi quelli eliminati. | selezionato o non selezionato (impostazione predefinita) | No | includeDeletedObjects: true o false (valore predefinito) |
| Colonne aggiuntive | Aggiungere altre colonne di dati per archiviare il percorso relativo o il valore statico dei file di origine. L'espressione è supportata per la seconda opzione. | • Name • Valore |
No | additionalColumns: • name • value |
Informazioni sulla destinazione
| Nome | Descrizione | valore | Richiesto | Proprietà script JSON |
|---|---|---|---|---|
| Connessione | Collegamento all'archivio dati di destinazione. | <connessione salesforce> | Sì | connection |
| Oggetto API | Specificare il nome dell'oggetto Salesforce in cui scrivere i dati. | < nome dell'oggetto > | Sì | objectApiName |
| Comportamento di scrittura | Comportamento dell'azione di scrittura per l'operazione. I valori consentiti sono: Insert e Upsert. È possibile scegliere un comportamento dall'elenco a discesa. | • Insert • Upsert |
No (il valore predefinito è Insert) | writeBehavior: insert upsert |
| Campo ID esterno | Nome del campo ID esterno per l'operazione upsert. Il campo specificato deve essere definito come Campo ID esterno nell'oggetto di Salesforce. Non può includere valori NULL nei dati di input corrispondenti. | < campo ID esterno > | Sì per "Upsert" | externalIdFieldName |
| Ignora valori NULL | Indica se ignorare i valori NULL dai dati di input durante un'operazione di scrittura. | selezionato o non selezionato (impostazione predefinita) | No | ignoreNullValues: true o false (valore predefinito) |
| Dimensioni batch di scrittura | Conteggio delle righe di dati scritti da Salesforce in ogni batch. Suggerire di impostare questo valore da 10.000 a 200.000. Un numero eccessivo di righe in ogni batch riduce le prestazioni di copia. Un numero eccessivo di righe in ogni batch può causare un timeout dell'API. | <numero di righe> (integer) |
No (il valore predefinito è 100.000) | writeBatchSize |
| Numero massimo di connessioni simultanee | Limite massimo di connessioni simultanee stabilite all'archivio dati durante l'esecuzione dell'attività. Specificare un valore solo quando si desidera limitare le connessioni simultanee. | <Numero massimo di connessioni simultanee> | No | maxConcurrentConnections |
Limiti dell'API Bulk 2.0 di Salesforce
Per eseguire query e inserire dati viene usata l'API Bulk 2.0 di Salesforce. Nell'API Bulk 2.0 i batch vengono creati automaticamente. È possibile inviare fino a 15.000 batch per periodo di 24 ore in sequenza. Se i batch superano il limite, si verificano errori.
Nell'API Bulk 2.0, solo i processi di inserimento consumano batch. Ciò non avviene per i processi di query. Per informazioni dettagliate, vedere Come vengono elaborate le richieste nella Guida per sviluppatori dell'API Bulk 2.0.
Per altre informazioni, vedere la sezione Limiti generali in Limiti per sviluppatori di Salesforce.