Dataverse configureren in een kopieeractiviteit
In dit artikel wordt beschreven hoe u de kopieeractiviteit in een gegevenspijplijn gebruikt om gegevens van en naar Dataverse te kopiëren.
Vereisten
Als u deze connector wilt gebruiken met verificatie van de Microsoft Entra-service-principal, moet u server-naar-serververificatie (S2S) instellen in Dataverse. Registreer eerst de toepassingsgebruiker (service-principal) in Microsoft Entra. Zie Een Microsoft Entra-toepassing en service-principal maken die toegang hebben tot resources voor meer informatie.
Tijdens de registratie van de toepassing moet u die gebruiker maken in Dataverse en machtigingen verlenen. Deze machtigingen kunnen direct of indirect worden verleend door de toepassingsgebruiker toe te voegen aan een team waaraan machtigingen zijn verleend in Dataverse. Zie Server-naar-serververificatie met één tenant gebruiken voor meer informatie over het instellen van een toepassingsgebruiker voor verificatie met Dataverse.
Ondersteunde configuratie
Voor de configuratie van elk tabblad onder kopieeractiviteit gaat u respectievelijk naar de volgende secties.
Algemeen
Ga voor de configuratie van het tabblad Algemeen naar Algemene instellingen.
Bron
Ga naar het tabblad Bron om de bron van de kopieeractiviteit te configureren. Zie de volgende inhoud voor de gedetailleerde configuratie.
De volgende eigenschappen zijn vereist:
- Gegevensarchieftype: Selecteer Extern.
- Verbinding maken ion: selecteer een bestaande Dataverse-verbinding in de lijst met verbindingen. Als er geen verbinding bestaat, maakt u een nieuwe Dataverse-verbinding door Nieuw te selecteren.
- Verbinding maken iontype: Selecteer Dataverse.
- Query gebruiken: geef de manier op waarop gegevens worden gelezen. U kunt entiteitsnaam kiezen om gegevens te lezen met behulp van de entiteitsnaam of Query om query te gebruiken om gegevens te lezen.
Entiteitsnaam: Selecteer uw entiteitsnaam in de vervolgkeuzelijst of selecteer Bewerken om deze handmatig in te voeren. Dit is de logische naam van de entiteit die moet worden opgehaald.
Query: FetchXML gebruiken om gegevens uit Dataverse te lezen. FetchXML is een eigen querytaal die wordt gebruikt in Dynamics Online en on-premises. Zie het volgende voorbeeld. Zie Query's bouwen met FetchXML voor meer informatie.
Voorbeeld van FetchXML-query:
<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>
Onder Geavanceerd kunt u de volgende velden opgeven:
- Aanvullende kolommen: voeg extra gegevenskolommen toe om het relatieve pad of de statische waarde van bronbestanden op te slaan. Expressie wordt ondersteund voor de laatste. Ga naar Extra kolommen toevoegen tijdens het kopiëren voor meer informatie.
Doel
Ga naar het tabblad Bestemming om de bestemming van uw kopieeractiviteit te configureren. Zie de volgende inhoud voor de gedetailleerde configuratie.
De volgende eigenschappen zijn vereist:
- Gegevensarchieftype: Selecteer Extern.
- Verbinding maken ion: selecteer een bestaande Dataverse-verbinding in de lijst met verbindingen. Als er geen verbinding bestaat, maakt u een nieuwe Dataverse-verbinding door Nieuw te selecteren.
- Verbinding maken iontype: Selecteer Dataverse.
- Entiteitsnaam: Geef de naam op van de entiteit om gegevens te schrijven. Selecteer de naam van uw entiteit in de vervolgkeuzelijst of selecteer Bewerken om deze handmatig in te voeren. Dit is de logische naam van de entiteit die moet worden opgehaald.
Onder Geavanceerd kunt u de volgende velden opgeven:
- Schrijfgedrag: het schrijfgedrag van de bewerking. Deze eigenschap is vereist en u moet Upsert selecteren. Als u dynamische inhoud toevoegen gebruikt, geeft u de waarde op voor Upsert.
- Alternatieve sleutelnaam: geef de alternatieve sleutelnaam op die is gedefinieerd op uw entiteit om records te upsert.
- Null-waarden negeren: hiermee wordt aangegeven of null-waarden van invoergegevens tijdens de schrijfbewerking moeten worden genegeerd. Deze is standaard geselecteerd.
- Wanneer deze optie is geselecteerd: laat de gegevens in het doelobject ongewijzigd wanneer u een upsert-/updatebewerking uitvoert en voeg gedefinieerde standaardwaarde in wanneer u de invoegbewerking uitvoert.
- Wanneer deze optie niet is geselecteerd: werk de gegevens in het doelobject bij naar NULL bij het uitvoeren van upsert-/bijwerkbewerkingen en voeg NULL-waarde in wanneer u de invoegbewerking uitvoert.
- Grootte van schrijfbatch: Geef het aantal gegevens op dat in elke batch naar Dataverse is geschreven.
- Maximum aantal gelijktijdige verbindingen: de bovengrens van gelijktijdige verbindingen die tijdens de uitvoering van de activiteit tot stand zijn gebracht met het gegevensarchief. Geef alleen een waarde op wanneer u gelijktijdige verbindingen wilt beperken.
Toewijzing
Voor de configuratie van het tabblad Toewijzing gaat u naar De toewijzingen configureren onder het tabblad Toewijzing. Als u Binair als bestandsindeling kiest, wordt toewijzing niet ondersteund.
Instellingen
Ga voor de configuratie van het tabblad Instellingen naar De andere instellingen configureren op het tabblad Instellingen.
Tabelsamenvatting
Zie de volgende tabel voor de samenvatting en meer informatie voor de Dataverse-kopieeractiviteit.
Brongegevens
| Name | Beschrijving | Waarde | Vereist | JSON-scripteigenschap |
|---|---|---|---|---|
| Gegevensarchieftype | Het gegevensarchieftype. | External | Ja | / |
| Verbinding | Uw verbinding met de bron dataverse. | < uw verbinding > | Ja | verbinding |
| Verbindingstype | Uw verbindingstype. | Dataverse | Ja | type (onder typeProperties ->source ->datasetSettings):CommonDataServiceForAppsEntity |
| Query gebruiken | De manier om gegevens uit Dataverse te lezen | *Tabellen *Query |
Ja | / |
| Naam entiteit | De logische naam van de entiteit die moet worden opgehaald. | < uw entiteitsnaam > | Ja | entityName |
| Query | Gebruik FetchXML om gegevens uit Dataverse te lezen. FetchXML is een eigen querytaal die wordt gebruikt in Dynamics Online en on-premises. Zie Query's bouwen met FetchXML voor meer informatie. | < uw query > | Ja | query |
| Aanvullende kolommen | Voeg extra gegevenskolommen toe om het relatieve pad of de statische waarde van bronbestanden op te slaan. Expressie wordt ondersteund voor de laatste. Ga naar Extra kolommen toevoegen tijdens het kopiëren voor meer informatie. | *Naam *Waarde |
Nee | additionalColumns: *Naam *Waarde |
Doelgegevens
| Name | Beschrijving | Waarde | Vereist | JSON-scripteigenschap |
|---|---|---|---|---|
| Gegevensarchieftype | Het gegevensarchieftype. | External | Ja | / |
| Verbinding | Uw verbinding met de doeldataverse. | < uw verbinding > | Ja | verbinding |
| Verbindingstype | Uw verbindingstype. | Dataverse | Ja | type (onder typeProperties ->sink ->datasetSettings):CommonDataServiceForAppsEntity |
| Naam entiteit | De logische naam van de entiteit die moet worden opgehaald. | < uw entiteit > | Ja | entityName |
| Schrijfgedrag | Het schrijfgedrag van de bewerking. De waarde moet Upsert zijn. | Upsert | Ja | writeBehavior: upsert |
| Alternatieve sleutelnaam | De alternatieve sleutelnaam die voor uw entiteit is gedefinieerd voor upsert-records. | < alternatieve sleutelnaam > | Nee | alternateKeyName |
| Null-waarden negeren | Hiermee wordt aangegeven of null-waarden van invoergegevens tijdens de schrijfbewerking moeten worden genegeerd. - Geselecteerd (true): laat de gegevens in het doelobject ongewijzigd wanneer u een upsert-/updatebewerking uitvoert en voeg gedefinieerde standaardwaarde in wanneer u de invoegbewerking uitvoert. - Niet geselecteerd (onwaar): Werk de gegevens in het doelobject bij naar NULL bij het uitvoeren van upsert-/bijwerkbewerkingen en voeg NULL-waarde in bij het uitvoeren van de invoegbewerking. |
geselecteerd of niet geselecteerd (standaard) | Nee | ignoreNullValues: waar of onwaar (standaard) |
| Grootte van schrijfbatch | Het aantal rijen van gegevens dat in elke batch naar Dataverse is geschreven. | < de grootte van uw schrijfbatch > De standaardwaarde is 10 |
Nee | writeBatchSize |
| Maximum aantal gelijktijdige verbindingen | De bovengrens van gelijktijdige verbindingen die tijdens de uitvoering van de activiteit tot stand zijn gebracht met het gegevensarchief. Geef alleen een waarde op wanneer u gelijktijdige verbindingen wilt beperken. | < maximum aantal gelijktijdige verbindingen > | Nee | maxConcurrent Verbinding maken ions |