Freigeben über

Konfigurieren von Dataverse in einer Kopieraktivität

  • Artikel

In diesem Artikel wird beschrieben, wie Sie die Kopieraktivität in einer Datenpipeline verwenden, um Daten von und nach Dataverse zu kopieren.

Voraussetzungen

Wenn Sie sich mit diesem Connector bei einem Microsoft Entra-Dienstprinzipal authentifizieren möchten, müssen Sie die Server-zu-Server-Authentifizierung (S2S) in Dataverse einrichten. Registrieren Sie zunächst den Anwendungsbenutzer (Dienstprinzipal) in Microsoft Entra. Weitere Informationen finden Sie unter Erstellen einer Microsoft Entra-Anwendung und eines Dienstprinzipals mit Zugriff auf Ressourcen.

Bei der Anwendungsregistrierung müssen Sie diese/n Benutzer*in in Dataverse erstellen und Berechtigungen erteilen. Diese Berechtigungen können direkt oder indirekt gewährt werden, indem der/die Anwendungsbenutzer*in, dem oder der Berechtigungen in Dataverse erteilt wurden, einem Team hinzugefügt wird. Weitere Informationen zum Einrichten eines Anwendungsbenutzers für die Authentifizierung bei Dataverse finden Sie unter Verwenden der Server-zu-Server-Authentifizierung für einen einzelnen Mandanten.

Unterstützte Konfiguration

Die Konfiguration der einzelnen Registerkarten unter der Kopieraktivität finden Sie in den folgenden Abschnitten.

Allgemein

Wechseln Sie für die Konfiguration der Registerkarte Allgemein zu Allgemeine Einstellungen.

`Source`

Wechseln Sie zur Registerkarte Quelle, um die Quelle der Kopieraktivität zu konfigurieren. Die ausführliche Konfiguration finden Sie im Folgenden.

Screenshot showing source tab and the list of properties.

Die folgenden Eigenschaften sind erforderlich:

  • Datenspeichertyp: Wählen Sie Extern aus.
  • Verbindung: Wählen Sie eine Dataverse-Verbindung in der Verbindungsliste aus. Wenn keine Verbindung vorhanden ist, erstellen Sie eine neue Dataverse-Verbindung, indem Sie Neu auswählen.
  • Verbindungstyp: Wählen Sie Dataverse aus.
  • Abfrage verwenden: Geben Sie die Methode zum Lesen von Daten an. Sie können Entitätsname auswählen, um Daten mithilfe des Entitätsnamens zu lesen, oder Abfrage, um Abfragen zum Lesen von Daten zu verwenden.

    • Entitätsname: Wählen Sie in der Dropdownliste Ihren Entitätsnamen aus, oder wählen Sie Bearbeiten aus, um ihn manuell einzugeben. Es handelt sich um den logischen Namen der abzurufenden Entität.

    • Abfrage: Verwenden von FetchXML zum Lesen von Daten aus Dataverse. FetchXML ist eine proprietäre Abfragesprache, die in Dynamics (online und lokal) verwendet wird. Siehe folgendes Beispiel. Weitere Informationen finden Sie unter Erstellen von Abfragen mit FetchXML.

      FetchXML-Beispielabfrage:

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

Unter Erweitert können Sie die folgenden Felder angeben:

Destination

Wechseln Sie zur Registerkarte Ziel, um das Ziel der Kopieraktivität zu konfigurieren. Die ausführliche Konfiguration finden Sie im Folgenden.

Screenshot showing destination tab and the list of properties.

Die folgenden Eigenschaften sind erforderlich:

  • Datenspeichertyp: Wählen Sie Extern aus.
  • Verbindung: Wählen Sie eine Dataverse-Verbindung in der Verbindungsliste aus. Wenn keine Verbindung vorhanden ist, erstellen Sie eine neue Dataverse-Verbindung, indem Sie Neu auswählen.
  • Verbindungstyp: Wählen Sie Dataverse aus.
  • Entitätsname: Geben Sie den Namen der Entität an, die Daten schreiben soll. Wählen Sie in der Dropdownliste Ihren Entitätsnamen aus, oder wählen Sie Bearbeiten aus, um ihn manuell einzugeben. Es handelt sich um den logischen Namen der abzurufenden Entität.

Unter Erweitert können Sie die folgenden Felder angeben:

  • Verhalten bei Schreibvorgang: Das Schreibverhalten des Vorgangs. Diese Eigenschaft ist erforderlich, und Sie müssen Upsert auswählen. Wenn Sie Dynamischen Inhalt hinzufügen verwenden, geben Sie den Wert für den Upsertvorgang an.
  • Name des Alternativschlüssels: Geben Sie den alternativen Schlüsselnamen an, der in Ihrer Entität für Upsertvorgänge von Datensätzen definiert ist.
  • NULL-Werte ignorieren: gibt an, ob NULL-Werte aus Eingabedaten beim Schreibvorgang ignoriert werden sollen. Standardmäßig ist diese Option aktiviert.
    • Bei aktivierter Option: keine Änderung an den Daten im Zielobjekt, wenn ein Upsert- oder Aktualisierungsvorgang stattfindet, und Einfügen eines definierten Standardwerts, wenn ein Einfügevorgang stattfindet.
    • Bei deaktivierter Option: Aktualisieren der Daten im Zielobjekt in NULL, wenn ein Upsert- oder Aktualisierungsvorgang stattfindet, und Einfügen von NULL, wenn ein Einfügevorgang stattfindet.
  • Schreibbatchgröße: Geben Sie die Zeilenanzahl der Daten an, die in jedem Batch in Dataverse geschrieben werden.
  • Maximale Anzahl gleichzeitiger Verbindungen: Die Obergrenze der gleichzeitigen Verbindungen zum Datenspeicher, die während des Ausführens der Aktivität hergestellt werden. Geben Sie diesen Wert nur an, wenn Sie die Anzahl der gleichzeitigen Verbindungen begrenzen möchten.

Zuordnung

Für die Konfiguration der Registerkarte Zuordnung wechseln Sie zu Konfigurieren der Zuordnungen auf der Registerkarte „Zuordnung“. Wenn Sie „Binär“ als Dateiformat auswählen, wird die Zuordnung nicht unterstützt.

Einstellungen

Wechseln Sie für die Konfiguration der Registerkarte Einstellungen zu Konfigurieren der anderen Einstellungen auf der Registerkarte „Einstellungen“.

Tabellenzusammenfassung

Die Zusammenfassung und weitere Informationen zur Dataverse-Kopieraktivität finden Sie in der folgenden Tabelle.

Quellinformationen

Name Beschreibung Wert Erforderlich JSON-Skripteigenschaft
Datenspeichertyp Ihr Datenspeichertyp Extern Ja /
Verbindung Ihre Verbindung mit der Dataverse-Quelle. < Ihre Verbindung > Ja Verbindung
Verbindungstyp Ihr Verbindungstyp. Dataverse Ja Typ (unter typeProperties ->source ->datasetSettings):
CommonDataServiceForAppsEntity
Verwendungsabfrage Die Methode zum Lesen von Daten aus Dataverse * Tabellen
* Abfrage		 Ja /
Entitätsname Der logische Name der abzurufenden Entität. <Entitätsname> Ja entityName
Abfrage Verwenden von FetchXML zum Lesen von Daten aus Dataverse. FetchXML ist eine proprietäre Abfragesprache, die in Dynamics (online und lokal) verwendet wird. Weitere Informationen finden Sie unter Erstellen von Abfragen mit FetchXML. <Abfrage> Ja Abfrage
Zusätzliche Spalten Fügen Sie zusätzliche Datenspalten hinzu, um den relativen Pfad oder statischen Wert der Quelldateien zu speichern. Für Letzteres wird ein Ausdruck unterstützt. Weitere Informationen finden Sie unter Hinzufügen zusätzlicher Spalten während des Kopiervorgangs. * Name
* Wert		 Nein additionalColumns:
* Name
* Wert

Zielinformationen

Name Beschreibung Wert Erforderlich JSON-Skripteigenschaft
Datenspeichertyp Ihr Datenspeichertyp Extern Ja /
Verbindung Ihre Verbindung mit dem Dataverse-Ziel. < Ihre Verbindung > Ja Verbindung
Verbindungstyp Ihr Verbindungstyp. Dataverse Ja Typ (unter typeProperties ->sink ->datasetSettings):
CommonDataServiceForAppsEntity
Entitätsname Der logische Name der abzurufenden Entität. <Entität> Ja entityName
Verhalten bei Schreibvorgang Das Schreibverhalten des Vorgangs. Der Wert muss Upsert lauten. Upsert Ja writeBehavior: Upsert
Name des Alternativschlüssels Der Name des Alternativschlüssels, der in Ihrer Entität für Upsertvorgänge von Datensätzen definiert ist. <Name des Alternativschlüssels> Nein alternateKeyName
NULL-Werte ignorieren Gibt an, ob Nullwerte aus Eingabedaten während des Schreibvorgangs ignoriert werden sollen.
Aktiviert (TRUE): keine Änderung an den Daten im Zielobjekt, wenn ein Upsert- oder Aktualisierungsvorgang stattfindet, und Einfügen eines definierten Standardwerts, wenn ein Einfügevorgang stattfindet.
Deaktiviert (FALSE): Aktualisieren der Daten im Zielobjekt in NULL, wenn ein Upsert- oder Aktualisierungsvorgang stattfindet, und Einfügen von NULL, wenn ein Einfügevorgang stattfindet.		 Aktiviert oder deaktiviert (Standardwert) Nein ignoreNullValues:
TRUE oder FALSE (Standardwert)
Schreibbatchgröße Die Zeilenanzahl der Daten, die in jedem Batch in Dataverse geschrieben werden. <Schreibbatchgröße>
Der Standardwert ist 10.		 Nein writeBatchSize
Maximal zulässige Anzahl paralleler Verbindungen Die Obergrenze gleichzeitiger Verbindungen mit dem Datenspeicher während der Aktivitätsausführung. Geben Sie diesen Wert nur an, wenn Sie die Anzahl der gleichzeitigen Verbindungen begrenzen möchten. <Maximal zulässige Anzahl gleichzeitiger Verbindungen> Nein maxConcurrentConnections

Zugehöriger Inhalt