Konfigurera Dataverse i en kopieringsaktivitet
Den här artikeln beskriver hur du använder kopieringsaktiviteten i en datapipeline för att kopiera data från och till Dataverse.
Förutsättningar
Om du vill använda den här anslutningsappen med Microsoft Entra-tjänstens huvudnamnsautentisering måste du konfigurera S2S-autentisering (server-till-server) i Dataverse. Registrera först programanvändaren (tjänstens huvudnamn) i Microsoft Entra. Mer information finns i Skapa ett Microsoft Entra-program och tjänstens huvudnamn som kan komma åt resurser.
Under programregistreringen måste du skapa den användaren i Dataverse och bevilja behörigheter. Dessa behörigheter kan antingen beviljas direkt eller indirekt genom att lägga till programanvändaren i ett team som har beviljats behörigheter i Dataverse. Mer information om hur du konfigurerar en programanvändare att autentisera med Dataverse finns i Använda server-till-server-autentisering med en klientorganisation.
Konfiguration som stöds
För konfigurationen av varje flik under kopieringsaktivitet går du till följande avsnitt.
Allmänt
För Allmän flikkonfiguration går du till Allmänna inställningar.
Källa
Gå till fliken Källa för att konfigurera kopieringsaktivitetskällan. Se följande innehåll för den detaljerade konfigurationen.
Följande egenskaper krävs:
- Datalagertyp: Välj Extern.
- Anslut ion: Välj en befintlig Dataverse-anslutning i anslutningslistan. Om det inte finns någon anslutning skapar du en ny Dataverse-anslutning genom att välja Ny.
- Anslut ionstyp: Välj Dataverse.
- Använd fråga: Ange hur data ska läsas. Du kan välja Entitetsnamn för att läsa data med hjälp av entitetsnamn eller Fråga för att använda frågan för att läsa data.
Entitetsnamn: Välj ditt entitetsnamn i listrutan eller välj Redigera för att ange det manuellt. Det är det logiska namnet på entiteten som ska hämtas.
Fråga: Använda FetchXML för att läsa data från Dataverse. FetchXML är ett proprietärt frågespråk som används i Dynamics online och lokalt. Se följande exempel. Mer information finns i Skapa frågor med FetchXML.
Exempel på FetchXML-fråga:
<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 Avancerat kan du ange följande fält:
- 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. Mer information finns i Lägg till ytterligare kolumner under kopiering.
Mål
Gå till fliken Mål för att konfigurera kopieringsaktivitetens mål. Se följande innehåll för den detaljerade konfigurationen.
Följande egenskaper krävs:
- Datalagertyp: Välj Extern.
- Anslut ion: Välj en befintlig Dataverse-anslutning i anslutningslistan. Om det inte finns någon anslutning skapar du en ny Dataverse-anslutning genom att välja Ny.
- Anslut ionstyp: Välj Dataverse.
- Entitetsnamn: Ange namnet på entiteten för att skriva data. Välj ett entitetsnamn i listrutan eller välj Redigera för att ange det manuellt. Det här är det logiska namnet på entiteten som ska hämtas.
Under Avancerat kan du ange följande fält:
- Skrivbeteende: Skrivbeteendet för åtgärden. Den här egenskapen krävs och du måste välja Upsert. Om du använder Lägg till dynamiskt innehåll anger du värdet till Upsert.
- Alternativt nyckelnamn: Ange det alternativa nyckelnamnet som definierats för din entitet till upsert-poster.
- Ignorera null-värden: Anger om nullvärden ska ignoreras från indata under skrivåtgärden. Den är markerad som standard.
- När den är markerad: Lämna data i målobjektet oförändrade när du utför upsert/update-åtgärden och infoga det definierade standardvärdet när du utför infogningsåtgärden.
- När den är avmarkerad: Uppdatera data i målobjektet till NULL när du utför upsert/update-åtgärden och infoga NULL-värdet när du utför infogningsåtgärden.
- Skriv batchstorlek: Ange radantalet data som skrivits till Dataverse i varje batch.
- 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
För Konfiguration av fliken Mappning går du till Konfigurera dina mappningar under mappningsfliken. Om du väljer Binärt som filformat stöds inte mappning.
Inställningar
För Inställningar flikkonfiguration går du till Konfigurera dina andra inställningar under fliken Inställningar.
Tabellsammanfattning
Se följande tabell för sammanfattningen och mer information om kopieringsaktiviteten Dataverse.
Källinformation
| Name | Beskrivning | Värde | Obligatoriskt | JSON-skriptegenskap |
|---|---|---|---|---|
| Typ av datalager | Din datalagertyp. | Externt | Ja | / |
| Anslutning | Din anslutning till dataversumkällan. | < din anslutning > | Ja | anslutning |
| Anslutningstyp | Din anslutningstyp. | Dataverse | Ja | typ (under typeProperties ->source ->datasetSettings):CommonDataServiceForAppsEntity |
| Använda fråga | Sättet att läsa data från Dataverse | *Tabeller *Fråga |
Ja | / |
| Entitetsnamn | Det logiska namnet på den entitet som ska hämtas. | < ditt entitetsnamn > | Ja | entityName |
| Fråga | Använd FetchXML för att läsa data från Dataverse. FetchXML är ett proprietärt frågespråk som används i Dynamics online och lokalt. Mer information finns i Skapa frågor med FetchXML. | < din fråga > | Ja | query |
| 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. Mer information finns i Lägg till ytterligare kolumner under kopiering. | *Namn *Värde |
Nej | additionalColumns: *Namn *Värde |
Målinformation
| Name | Beskrivning | Värde | Obligatoriskt | JSON-skriptegenskap |
|---|---|---|---|---|
| Typ av datalager | Din datalagertyp. | Externt | Ja | / |
| Anslutning | Din anslutning till måldataversum. | < din anslutning > | Ja | anslutning |
| Anslutningstyp | Din anslutningstyp. | Dataverse | Ja | typ (under typeProperties ->sink ->datasetSettings):CommonDataServiceForAppsEntity |
| Entitetsnamn | Det logiska namnet på den entitet som ska hämtas. | < din entitet > | Ja | entityName |
| Skrivbeteende | Skrivbeteendet för åtgärden. Värdet måste vara Upsert. | Upsert | Ja | writeBehavior: upsert |
| Alternativt nyckelnamn | Det alternativa nyckelnamnet som definierats för din entitet till upsert-poster. | < alternativt nyckelnamn > | Nej | alternateKeyName |
| Ignorera null-värden | Anger om null-värden ska ignoreras från indata under skrivåtgärden. – Markerat (sant): Lämna data i målobjektet oförändrade när du utför upsert/update-åtgärden och infoga det definierade standardvärdet när du utför infogningsåtgärden. – Omarkerad (falskt): Uppdatera data i målobjektet till NULL när du utför upsert/update-åtgärden och infoga NULL-värdet när du utför infogningsåtgärden. |
markerad eller omarkerad (standard) | Nej | ignoreNullValues: sant eller falskt (standard) |
| Skriv batchstorlek | Radantalet data som skrivits till Dataverse i varje batch. | < din skriv batchstorlek > Standardvärdet är 10 |
Nej | 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 | maxConcurrent Anslut ions |