Del via


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.

Skærmbillede, der viser kildefanen.

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.

        Skærmbillede, der viser Brug forespørgsel – rapport.

    • Hvis du vælger SOQL-forespørgsel:

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.

Skærmbillede, der viser destinationsfanen og listen over egenskaber.

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.

      Skærmbillede, der viser skrivefunktionsmåden – upsert.

  • 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.