Konfigurera Salesforce i en kopieringsaktivitet
Den här artikeln beskriver hur du använder kopieringsaktiviteten i datapipelinen för att kopiera data från och till Salesforce.
Konfiguration som stöds
För konfigurationen av varje flik under kopieringsaktivitet går du till följande avsnitt.
Allmänt
Se vägledningen allmänna inställningar för att konfigurera fliken Allmänna inställningar.
Källa
Följande egenskaper stöds för Salesforce under fliken Källa i en kopieringsaktivitet.
Följande egenskaper krävs:
- Anslutning: Välj en Salesforce-anslutning i anslutningslistan. Om det inte finns någon anslutning skapar du en ny Salesforce-anslutning genom att välja Ny.
- Använd fråga: Välj från Objekt-API, Rapport eller SOQL-fråga.
Om du väljer Objekt-API:
- Objekt-API: Ange salesforce-objektnamnet som du vill hämta data från. Välj namnet i listrutan.
Om du väljer Rapport:
Rapport-ID: Ange ID för Salesforce-rapporten som du vill hämta data från. Det stöds inte i målet. Det finns begränsningar när du använder rapporter.
Om du väljer SOQL-fråga:
SOQL-fråga: Använd den anpassade frågan för att läsa data. Du kan bara använda FRÅGAN Salesforce Object Query Language (SOQL) med begränsningar Förstå mass-API 2.0-fråga. Om du inte anger SOQL-fråga hämtas alla data för Salesforce-objektet som anges i Objekt-API eller Rapport-ID .
Under Avancerat kan du ange följande fält:
- Inkludera borttagna objekt: Ange om du vill köra frågor mot befintliga poster (omarkerade) eller fråga alla poster, inklusive de borttagna (markerade).
- Ytterligare kolumner: Lägg till ytterligare datakolumner för att lagra källfilernas relativa sökväg eller statiska värde. Uttrycket stöds för det senare.
Mål
Följande egenskaper stöds för Salesforce under fliken Mål för en kopieringsaktivitet.
Följande egenskaper krävs:
- Anslutning: Välj en Salesforce-anslutning i anslutningslistan. Om det inte finns någon anslutning skapar du en ny Salesforce-anslutning genom att välja Ny.
- Objekt-API: Ange salesforce-objektnamnet som du vill skriva data till. Välj namnet i listrutan.
Under Avancerat kan du ange följande fält:
Skrivbeteende: Ange skrivbeteendet för åtgärden. Tillåtna värden är Insert och Upsert. Du kan välja ett beteende i listrutan.
Om du väljer Upsert:
Externt ID-fält: Namnet på det externa ID-fältet för upsert-åtgärden. Det angivna fältet måste definieras som externt ID-fält i Salesforce-objektet. Det kan inte ha NULL-värden i motsvarande indata.
Ignorera null-värden: Ange om NULL-värden ska ignoreras från indata under en skrivåtgärd.
- När den är markerad: Lämna data i målobjektet oförändrade när du utför en upsert- eller uppdateringsåtgärd. Infoga ett definierat standardvärde när du utför en infogningsåtgärd.
- När den är avmarkerad: Uppdatera data i målobjektet till NULL när du utför en upsert- eller uppdateringsåtgärd. Infoga ett NULL-värde när du utför en infogningsåtgärd.
Skriv batchstorlek: Ange radantalet data som skrivits till Salesforce i varje batch. Föreslå att du anger det här värdet från 10 000 till 200 000. För få rader i varje batch minskar kopieringsprestandan. För många rader i varje batch kan orsaka API-timeout.
Maximalt antal samtidiga anslutningar: Den övre gränsen för samtidiga anslutningar som upprättats till datalagret under aktivitetskörningen. Ange endast ett värde när du vill begränsa samtidiga anslutningar.
Mappning
Information om konfiguration av fliken Mappning finns i Konfigurera dina mappningar under mappningsfliken.
Inställningar
För Inställningsflikskonfiguration går du till Konfigurera dina andra inställningar under fliken Inställningar.
Tabellsammanfattning
Följande tabeller innehåller mer information om kopieringsaktiviteten i Salesforce.
Källinformation
| Name | Beskrivning | Värde | Obligatoriskt | JSON-skriptegenskap |
|---|---|---|---|---|
| Anslutning | Din anslutning till källdatalagret. | <din Salesforce-anslutning> | Ja | anslutning |
| Anslutningstyp | Din anslutningstyp. Välj Salesforce-objekt. | SalesforceObject | Ja | / |
| Använda fråga | Sättet att läsa data från Salesforce. | • Objekt-API • Rapport • SOQL-fråga |
Ja | / |
| För objekt-API | ||||
| Objekt-API | Ange det Salesforce-objektnamn som data ska hämtas från. | < objektnamnet > | Ja | objectApiName |
| För rapport | ||||
| Rapport-ID | ID:t för Salesforce-rapporten som du vill hämta data från. Det stöds inte i målet. Det finns begränsningar när du använder rapporter. | <ditt rapport-ID> | Ja | reportId |
| För SOQL-fråga | ||||
| SOQL-fråga | Använd den anpassade frågan för att läsa data. Du kan bara använda FRÅGAN Salesforce Object Query Language (SOQL) med begränsningar Förstå mass-API 2.0-fråga. Om du inte anger SOQL-fråga hämtas alla data för Salesforce-objektet som anges i Objekt-API eller Rapport-ID . | < din SOQL-fråga > | Ja | query |
| Inkludera borttagna objekt | Anger om du vill köra frågor mot befintliga poster eller fråga alla poster, inklusive de borttagna. | markerad eller omarkerad (standard) | Nej | includeDeletedObjects: sant eller falskt (standard) |
| Ytterligare kolumner | Lägg till ytterligare datakolumner för att lagra källfilernas relativa sökväg eller statiska värde. Uttrycket stöds för det senare. | • Namn •Värde |
Nej | additionalColumns: •Namn •värde |
Målinformation
| Name | Beskrivning | Värde | Obligatoriskt | JSON-skriptegenskap |
|---|---|---|---|---|
| Anslutning | Din anslutning till måldatalagret. | <din Salesforce-anslutning> | Ja | anslutning |
| Objekt-API | Ange namnet på Salesforce-objektet som du vill skriva data till. | < objektnamnet > | Ja | objectApiName |
| Skrivbeteende | Skrivbeteendet för åtgärden. Tillåtna värden är Insert och Upsert. Du kan välja ett beteende i listrutan. | •Infoga • Upsert |
Nej (standard är Infoga) | writeBehavior: insert upsert |
| Fält för externt ID | Namnet på det externa ID-fältet för upsert-åtgärden. Det angivna fältet måste definieras som externt ID-fält i Salesforce-objektet. Det kan inte ha NULL-värden i motsvarande indata. | < ditt externa ID-fält > | Ja för "Upsert" | externalIdFieldName |
| Ignorera null-värden | Anger om null-värden ska ignoreras från indata under en skrivåtgärd. | markerad eller omarkerad (standard) | Nej | ignoreNullValues: sant eller falskt (standard) |
| Skriv batchstorlek | Radantalet data som skrivits till Salesforce i varje batch. Föreslå att du anger det här värdet från 10 000 till 200 000. För få rader i varje batch minskar kopieringsprestandan. För många rader i varje batch kan orsaka API-timeout. | <antal rader> (heltal) |
Nej (standardvärdet är 100 000) | writeBatchSize |
| Maximalt antal samtidiga anslutningar | Den övre gränsen för samtidiga anslutningar som upprättats till datalagret under aktivitetskörningen. Ange endast ett värde när du vill begränsa samtidiga anslutningar. | <maximalt antal samtidiga anslutningar> | Nej | maxConcurrentConnections |
Gränser för Salesforce Bulk API 2.0
Vi använder Salesforce Bulk API 2.0 för att fråga efter och mata in data. I Bulk API 2.0 skapas batchar automatiskt åt dig. Du kan skicka upp till 15 000 batchar per rullande 24-timmarsperiod. Om batcharna överskrider gränsen uppstår fel.
I Bulk API 2.0 använder endast inmatningsjobb batchar. Frågejobb gör det inte. Mer information finns i Hur begäranden bearbetas i utvecklarguiden för mass-API 2.0.
Mer information finns i avsnittet Allmänna gränser i Salesforce-utvecklargränser.