Konfigurieren von Dataverse in einer Kopieraktivität

In diesem Artikel wird beschrieben, wie Sie die Kopieraktivität in einer Pipeline zum Kopieren von Daten aus und nach Dataverse verwenden.

Voraussetzungen

Um diesen Connector mit der Microsoft Entra-Dienstprinzipalauthentifizierung zu verwenden, müssen Sie die Server-zu-Server-Authentifizierung (S2S) in Dataverse einrichten. Registrieren Sie zuerst den Anwendungsbenutzer (Dienstprinzipal) in Microsoft Entra. Weitere Informationen finden Sie unter Erstellen einer Microsoft Entra-Anwendung und eines Dienstprinzipals, der auf Ressourcen zugreifen kann.

Während der Anwendungsregistrierung müssen Sie diesen Benutzer in Dataverse erstellen und Berechtigungen erteilen. Diese Berechtigungen können entweder direkt oder indirekt erteilt werden, indem der Anwendungsbenutzer zu einem Team hinzugefügt wird, das Berechtigungen in Dataverse erteilt hat. Weitere Informationen zum Einrichten eines Anwendungsbenutzers zur Authentifizierung bei Dataverse finden Sie unter Verwenden der Einzelmandanten-Server-zu-Server-Authentifizierung.

Unterstützte Konfiguration

Die Konfiguration der einzelnen Registerkarten unter der Copy-Aktivität finden Sie in den folgenden Abschnitten.

• Allgemein
• Quelle
• Ziel
• Abbildung
• Einstellungen

Allgemein

Um die Registerkarte Allgemein zu konfigurieren, gehen Sie zu den Allgemeinen Einstellungen.

Quelle

Wechseln Sie zur Registerkarte Quelle, um die Quelle der Kopieraktivität zu konfigurieren. Die detaillierte Konfiguration finden Sie in den folgenden Inhalten.

Die folgenden Eigenschaften sind erforderlich:

• Verbindung: Wählen Sie eine vorhandene Dataverse-Verbindung aus 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.
• Verwenden Sie die Abfrage: Geben Sie die Methode an, die zum Lesen von Daten verwendet wird. Sie können den Entitätsnamen auswählen, um Daten anhand des Entitätsnamens zu lesen, oder die Abfrage nutzen, um Daten zu lesen.

  • Entitätsname: Wählen Sie Ihren Entitätsnamen aus der Dropdownliste 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:

• 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 "Zusätzliche Spalten während der Kopie hinzufügen".

Bestimmungsort

Wechseln Sie zur Registerkarte "Ziel", um ihr Kopieraktivitätsziel zu konfigurieren. Die detaillierte Konfiguration finden Sie in den folgenden Inhalten.

Die folgenden Eigenschaften sind erforderlich:

• Verbindung: Wählen Sie eine vorhandene Dataverse-Verbindung aus 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, um Daten zu schreiben. Wählen Sie ihren Entitätsnamen aus der Dropdownliste aus, oder wählen Sie "Bearbeiten" aus, um ihn manuell einzugeben. Dies ist der logische Name der abzurufenden Entität.

Unter "Erweitert" können Sie die folgenden Felder angeben:

• Schreibverhalten: 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 Upsert an.
• Alternativer Schlüsselname: Geben Sie den alternativen Schlüsselnamen an, der in Ihrer Entität definiert ist, um Datensätze zu upsert.
• Nullwerte ignorieren: Gibt an, ob Nullwerte während des Schreibvorgangs von Eingabedaten ignoriert werden sollen. Sie ist standardmäßig ausgewählt.
  • Wenn sie ausgewählt ist: Lassen Sie die Daten im Zielobjekt beim Upsert/Update-Vorgang unverändert, und fügen Sie beim Einfügen einen definierten Standardwert ein.
  • Wenn dies nicht ausgewählt ist: Aktualisieren Sie die Daten im Zielobjekt beim Upsert/Update-Vorgang auf NULL, und fügen Sie BEIM Einfügen einen NULL-Wert ein.
• Batchgröße schreiben: Geben Sie die Zeilenanzahl der Daten an, die in jeden Batch in Dataverse geschrieben wurden.
• 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.

Kartierung

Wechseln Sie zur Registerkarte "Zuordnungskonfiguration", um Ihre Zuordnungen zu konfigurieren. Wenn Sie "Binary" als Dateiformat auswählen, wird die Zuordnung nicht unterstützt.

Einstellungen

Wechseln Sie für die Konfiguration der Registerkarte "Einstellungen" zu "Andere Einstellungen unter der Registerkarte konfigurieren".

Tabellenzusammenfassung

In der folgenden Tabelle finden Sie die Zusammenfassung und weitere Informationen für die Dataverse-Kopieraktivität.

Quellinformationen

Zielinformationen

Verwandte Inhalte

• Übersicht über Dataverse-Konnektor