Konfigurer Dataverse i en kopiaktivitet
I denne artikel beskrives det, hvordan du bruger kopiaktiviteten i en datapipeline til at kopiere data fra og til Dataverse.
Forudsætninger
Hvis du vil bruge denne connector med microsoft Entra-tjenesteprincipalgodkendelse, skal du konfigurere S2S-godkendelse (server-to-server) i Dataverse. Registrer først programbrugeren (tjenesteprincipal) i Microsoft Entra. Du kan få flere oplysninger under Opret et Microsoft Entra-program og en tjenesteprincipal, der kan få adgang til ressourcer.
Under programregistreringen skal du oprette den pågældende bruger i Dataverse og tildele tilladelser. Disse tilladelser kan enten tildeles direkte eller indirekte ved at føje programbrugeren til et team, der har fået tildelt tilladelser i Dataverse. Du kan få flere oplysninger om, hvordan du konfigurerer en programbruger til godkendelse med Dataverse, under Brug enkeltlejerserver-til-server-godkendelse.
Understøttet konfiguration
Hvis du vil konfigurere hver fane under kopiaktivitet, skal du gå til henholdsvis følgende afsnit.
Generelt
Gå til Generelle indstillinger for konfiguration af fanen Generelt.
Kilde
Gå til fanen Kilde for at konfigurere din kopiaktivitetskilde. Se følgende indhold for at få den detaljerede konfiguration.
Følgende egenskaber er påkrævet:
- Datalagertype: Vælg ekstern.
- Forbind ion: Vælg en eksisterende Dataverse-forbindelse på forbindelseslisten. Hvis der ikke findes nogen forbindelse, skal du oprette en ny Dataverse-forbindelse ved at vælge Ny.
- Forbind ionstype: Vælg Dataverse.
- Brug forespørgsel: Angiv, hvordan data skal læses. Du kan vælge Objektnavn for at læse data ved hjælp af objektnavn eller Forespørgsel for at bruge forespørgslen til at læse data.
Objektnavn: Vælg dit objektnavn på rullelisten, eller vælg Rediger for at angive det manuelt. Det er det logiske navn på det objekt, der skal hentes.
Forespørgsel: Brug af FetchXML til at læse data fra Dataverse. FetchXML er et beskyttet forespørgselssprog, der bruges i Dynamics online og i det lokale miljø. Se følgende eksempel. Du kan få mere at vide under Opret forespørgsler med FetchXML.
Eksempel på FetchXML-forespørgsel:
<fetch> <entity name="account"> <attribute name="accountid" /> <attribute name="name" /> <attribute name="marketingonly" /> <attribute name="modifiedon" /> <order attribute="modifiedon" descending="false" /> <filter type="and"> <condition attribute ="modifiedon" operator="between"> <value>2017-03-10 18:40:00z</value> <value>2017-03-12 20:40:00z</value> </condition> </filter> </entity> </fetch>
Under Avanceret kan du angive følgende felter:
- Flere kolonner: Tilføj flere datakolonner for at gemme kildefilernes relative sti eller statiske værdi. Udtrykket understøttes for sidstnævnte. Du kan finde flere oplysninger ved at gå til Tilføj flere kolonner under kopiering.
Destination
Gå til fanen Destination for at konfigurere destinationen for kopiaktiviteten. Se følgende indhold for at få den detaljerede konfiguration.
Følgende egenskaber er påkrævet:
- Datalagertype: Vælg ekstern.
- Forbind ion: Vælg en eksisterende Dataverse-forbindelse på forbindelseslisten. Hvis der ikke findes nogen forbindelse, skal du oprette en ny Dataverse-forbindelse ved at vælge Ny.
- Forbind ionstype: Vælg Dataverse.
- Objektnavn: Angiv navnet på den enhed, der skal skrive data. Vælg dit objektnavn på rullelisten, eller vælg Rediger for at angive det manuelt. Dette er det logiske navn på det objekt, der skal hentes.
Under Avanceret kan du angive følgende felter:
- Skrivefunktion: Handlingens skrivefunktionsmåde. Denne egenskab er påkrævet, og du skal vælge Upsert. Hvis du bruger Tilføj dynamisk indhold, skal du angive værdien til Upsert.
- Alternativt nøglenavn: Angiv det alternative nøglenavn, der er defineret i objektet, for at oprette poster.
- Ignorer null-værdier: Angiver, om null-værdier fra inputdata skal ignoreres under skrivehandlingen. Den er valgt som standard.
- Når den er valgt: Lad dataene i destinationsobjektet være uændrede, når du udfører handlingen upsert/update, og indsæt den definerede standardværdi, når du udfører indsætningshandlingen.
- Når den ikke er markeret: Opdater dataene i destinationsobjektet til NULL, når du udfører upsert/update-handling, og indsæt NULL-værdi, når du udfører indsætningshandlingen.
- Skriv batchstørrelse: Angiv rækkeantallet af data, der skrives til Dataverse i hvert batch.
- 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
For Konfiguration af fanen Tilknytning skal du gå til Konfigurer dine tilknytninger under fanen Tilknytning. Hvis du vælger Binær som filformat, understøttes tilknytning ikke.
Indstillinger
For konfigurationen af fanen Indstillinger skal du gå til Konfigurer dine andre indstillinger under fanen Indstillinger.
Tabeloversigt
Se følgende tabel for at få en oversigt og flere oplysninger om kopieringsaktiviteten Dataverse.
Kildeoplysninger
| Navn | Beskrivelse | Værdi | Obligatorisk | JSON-scriptegenskab |
|---|---|---|---|---|
| Datalagertype | Datalagertypen. | Eksternt | Ja | / |
| Forbind ion | Din forbindelse til datakilden. | < din forbindelse > | Ja | Forbindelse |
| Forbind ionstype | Din forbindelsestype. | Dataverse | Ja | type (under typeProperties ->source ->datasetSettings):CommonDataServiceForAppsEntity |
| Brug forespørgsel | Måden at læse data fra Dataverse på | *Tabeller *Forespørgsel |
Ja | / |
| Enhedsnavn | Det logiske navn på det objekt, der skal hentes. | < dit enhedsnavn > | Ja | entityName |
| Forespørgsel | Brug FetchXML til at læse data fra Dataverse. FetchXML er et beskyttet forespørgselssprog, der bruges i Dynamics online og i det lokale miljø. Du kan få mere at vide under Opret forespørgsler med FetchXML. | < din forespørgsel > | Ja | query |
| Flere kolonner | Tilføj yderligere datakolonner for at gemme kildefilernes relative sti eller statiske værdi. Udtrykket understøttes for sidstnævnte. Du kan finde flere oplysninger ved at gå til Tilføj flere kolonner under kopiering. | *Navn *Værdi |
Nr. | additionalColumns: *Navn *Værdi |
Destinationsoplysninger
| Navn | Beskrivelse | Værdi | Obligatorisk | JSON-scriptegenskab |
|---|---|---|---|---|
| Datalagertype | Datalagertypen. | Eksternt | Ja | / |
| Forbind ion | Din forbindelse til destinationsdataverse. | < din forbindelse > | Ja | Forbindelse |
| Forbind ionstype | Din forbindelsestype. | Dataverse | Ja | type (under typeProperties ->sink ->datasetSettings):CommonDataServiceForAppsEntity |
| Enhedsnavn | Det logiske navn på det objekt, der skal hentes. | < din enhed > | Ja | entityName |
| Skrivefunktionsmåde | Handlingens skrivefunktionsmåde. Værdien skal være Upsert. | Upsert | Ja | writeBehavior: upsert |
| Alternativt nøglenavn | Det alternative nøglenavn, der er defineret i objektet til upsert-poster. | < alternativt nøglenavn > | Nr. | alternateKeyName |
| Ignorer null-værdier | Angiver, om null-værdier skal ignoreres fra inputdata under skrivehandlingen. – Markeret (sand): Lad dataene i destinationsobjektet være uændrede, når du udfører handlingen upsert/update, og indsæt den definerede standardværdi, når du udfører indsætningshandlingen. – Ikke markeret (falsk): Opdater dataene i destinationsobjektet til NULL, når du udfører upsert/update-handling, og indsæt NULL-værdi, når du udfører indsætningshandlingen. |
markeret eller ikke markeret (standard) | Nr. | ignoreNullValues: true eller false (standard) |
| Skriv batchstørrelse | Rækkeantallet af data, der skrives til Dataverse i hvert batch. | < din skrivebatchstørrelse > Standardværdien er 10 |
Nr. | 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. | maxConcurrent Forbind ions |