Delen via


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.

Screenshot showing source tab and the list of properties.

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.

Screenshot showing destination tab and the list of properties.

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