Konfigurer Salesforce i en kopiaktivitet
I denne artikel beskrives det, hvordan du bruger kopiaktiviteten i datapipeline til at kopiere data fra og til Salesforce.
Understøttet konfiguration
Hvis du vil konfigurere hver fane under kopiaktivitet, skal du gå til henholdsvis følgende afsnit.
Generelt
Se vejledningen til generelle indstillinger for at konfigurere fanen Generelle indstillinger.
Kilde
Følgende egenskaber understøttes for Salesforce under fanen Kilde for en kopiaktivitet.
Følgende egenskaber er påkrævet:
- Forbindelse: Vælg en Salesforce-forbindelse på forbindelseslisten. Hvis der ikke findes nogen forbindelse, skal du oprette en ny Salesforce-forbindelse ved at vælge Ny.
- Brug forespørgsel: Vælg fra objekt-API, rapport eller SOQL-forespørgsel.
Hvis du vælger Objekt-API:
- Objekt-API: Angiv det Salesforce-objektnavn, der skal hentes data fra. Vælg navnet på rullelisten.
Hvis du vælger Rapport:
Rapport-id: Angiv id'et for den Salesforce-rapport, der skal hentes data fra. Det understøttes ikke i destinationen. Der er begrænsninger , når du bruger rapporter.
Hvis du vælger SOQL-forespørgsel:
SOQL-forespørgsel: Brug den brugerdefinerede forespørgsel til at læse data. Du kan kun bruge SOQL-forespørgsel (Salesforce Object Query Language) med begrænsninger om masse-API 2.0-forespørgsel. Hvis du ikke angiver SOQL-forespørgsel, hentes alle data for Salesforce-objektet, der er angivet i Objekt-API eller rapport-id .
Under Avanceret kan du angive følgende felter:
- Medtag slettede objekter: Angiv, om der skal forespørges om de eksisterende poster (ikke markeret), eller om du vil forespørge alle poster, herunder de slettede poster (markeret).
- Flere kolonner: Tilføj flere datakolonner for at gemme kildefilernes relative sti eller statiske værdi. Udtrykket understøttes for sidstnævnte.
Destination
Følgende egenskaber understøttes for Salesforce under fanen Destination for en kopiaktivitet.
Følgende egenskaber er påkrævet:
- Forbindelse: Vælg en Salesforce-forbindelse på forbindelseslisten. Hvis der ikke findes nogen forbindelse, skal du oprette en ny Salesforce-forbindelse ved at vælge Ny.
- Objekt-API: Angiv det Salesforce-objektnavn, der skal skrives data til. Vælg navnet på rullelisten.
Under Avanceret kan du angive følgende felter:
Skrivefunktion: Angiv skrivefunktionsmåden for handlingen. Tilladte værdier er Insert og Upsert. Du kan vælge en funktionsmåde på rullelisten.
Hvis du vælger Upsert:
Feltet Eksternt id: Navnet på det eksterne id-felt for upserthandlingen. Det angivne felt skal være defineret som eksternt id-felt i Salesforce-objektet. Den kan ikke have NULL-værdier i de tilsvarende inputdata.
Ignorer null-værdier: Angiv, om NULL-værdier skal ignoreres fra inputdata under en skrivehandling.
- Når den er valgt: Lad dataene i destinationsobjektet være uændrede, når du foretager en upsert- eller opdateringshandling. Indsæt en defineret standardværdi, når du udfører en indsættelseshandling.
- Når den ikke er markeret: Opdater dataene i destinationsobjektet til NULL, når du foretager en upsert- eller opdateringshandling. Indsæt en NULL-værdi, når du udfører en indsættelseshandling.
Skriv batchstørrelse: Angiv rækkeantallet af data, der skrives til Salesforce i hvert batch. Foreslå, at du angiver denne værdi fra 10.000 til 200.000. For få rækker i hvert batch reducerer kopiens ydeevne. For mange rækker i hvert batch kan medføre API-timeout.
Maksimalt antal samtidige forbindelser: Den øvre grænse for samtidige forbindelser, der er oprettet til datalageret under aktivitetskørslen. Angiv kun en værdi, når du vil begrænse samtidige forbindelser.
Tilknytning
Hvis du vil have mere at vide om konfiguration af fanen Tilknytning , skal du se Konfigurer dine tilknytninger under fanen Tilknytning.
Indstillinger
For Konfiguration af fanen Indstillinger skal du gå til Konfigurer dine andre indstillinger under fanen Indstillinger.
Tabeloversigt
Følgende tabeller indeholder flere oplysninger om kopiaktiviteten i Salesforce.
Kildeoplysninger
Navn | Beskrivelse | Værdi | Obligatorisk | JSON-scriptegenskab |
---|---|---|---|---|
Forbindelse | Din forbindelse til kildedatalageret. | <din Salesforce-forbindelse> | Ja | forbindelse |
Forbindelsestype | Din forbindelsestype. Vælg Salesforce-objekter. | SalesforceObject | Ja | / |
Brug forespørgsel | Måden at læse data fra Salesforce på. | • Objekt-API • Rapport • SOQL-forespørgsel |
Ja | / |
Til objekt-API | ||||
Objekt-API | Angiv det Salesforce-objektnavn, der skal hentes data fra. | < dit objektnavn > | Ja | objectApiName |
Til rapport | ||||
Rapport-id | Id'et for den Salesforce-rapport, der skal hentes data fra. Det understøttes ikke i destinationen. Der er begrænsninger , når du bruger rapporter. | <dit rapport-id> | Ja | reportId |
Til SOQL-forespørgsel | ||||
SOQL-forespørgsel | Brug den brugerdefinerede forespørgsel til at læse data. Du kan kun bruge SOQL-forespørgsel (Salesforce Object Query Language) med begrænsninger om masse-API 2.0-forespørgsel. Hvis du ikke angiver SOQL-forespørgsel, hentes alle data for Salesforce-objektet, der er angivet i Objekt-API eller rapport-id . | < din SOQL-forespørgsel > | Ja | query |
Medtag slettede objekter | Angiver, om du vil forespørge om de eksisterende poster eller forespørge alle poster, herunder de slettede poster. | markeret eller ikke markeret (standard) | Nr. | includeDeletedObjects: true eller false (standard) |
Flere kolonner | Tilføj yderligere datakolonner for at gemme kildefilernes relative sti eller statiske værdi. Udtrykket understøttes for sidstnævnte. | • Navn •Værdi |
Nr. | additionalColumns: •Navn •værdi |
Destinationsoplysninger
Navn | Beskrivelse | Værdi | Obligatorisk | JSON-scriptegenskab |
---|---|---|---|---|
Forbindelse | Din forbindelse til destinationsdatalageret. | <din Salesforce-forbindelse> | Ja | forbindelse |
Objekt-API | Angiv det Salesforce-objektnavn, der skal skrives data til. | < dit objektnavn > | Ja | objectApiName |
Skrivefunktionsmåde | Skrivefunktionsmåden for handlingen. Tilladte værdier er Insert og Upsert. Du kan vælge en funktionsmåde på rullelisten. | •Indsætte • Upsert |
Nej (standard er Indsæt) | writeBehavior: indsæt upsert |
Feltet Eksternt id | Navnet på det eksterne id-felt for upsert-handlingen. Det angivne felt skal være defineret som eksternt id-felt i Salesforce-objektet. Den kan ikke have NULL-værdier i de tilsvarende inputdata. | < dit eksterne id-felt > | Ja for "Upsert" | externalIdFieldName |
Ignorer null-værdier | Angiver, om NULL-værdier skal ignoreres fra inputdata under en skrivehandling. | markeret eller ikke markeret (standard) | Nr. | ignoreNullValues: true eller false (standard) |
Skriv batchstørrelse | Rækkeantallet af data, der skrives til Salesforce i hvert batch. Foreslå, at du angiver denne værdi fra 10.000 til 200.000. For få rækker i hvert batch reducerer kopiens ydeevne. For mange rækker i hvert batch kan medføre API-timeout. | <antal rækker> (heltal) |
Nej (standard er 100.000) | writeBatchSize |
Maks. antal samtidige forbindelser | Den øvre grænse for samtidige forbindelser, der er oprettet til datalageret under aktivitetskørslen. Angiv kun en værdi, når du vil begrænse samtidige forbindelser. | <maks. antal samtidige forbindelser> | Nr. | maxConcurrentConnections |
Salesforce Bulk API 2.0-grænser
Vi bruger Salesforce Bulk API 2.0 til at forespørge om og indfødning af data. I Bulk API 2.0 oprettes der automatisk batches for dig. Du kan sende op til 15.000 batches pr. rullende 24-timers periode. Hvis batches overskrider grænsen, oplever du fejl.
I Bulk API 2.0 bruger kun indfødningsjob batches. Det gør forespørgselsjob ikke. Du kan finde flere oplysninger i Sådan behandles anmodninger i udviklervejledningen til Masse-API 2.0.
Du kan få flere oplysninger i afsnittet Generelle grænser i Salesforce-udviklergrænser.