Configurer Dataverse dans une activité de copie

Cet article explique comment utiliser l’activité de copie dans un pipeline pour copier des données depuis et vers Dataverse.

Prerequisites

Pour utiliser ce connecteur avec l’authentification du principal de service Microsoft Entra, vous devez configurer l’authentification serveur à serveur (S2S) dans Dataverse. Inscrivez d’abord l’utilisateur d’application (principal de service) dans Microsoft Entra. Pour plus d’informations, consultez Créer une application Microsoft Entra et un principal de service qui peuvent accéder aux ressources.

Lors de l’inscription de l’application, vous devez créer cet utilisateur dans Dataverse et accorder des autorisations. Ces autorisations peuvent être accordées directement ou indirectement en ajoutant l’utilisateur de l’application à une équipe qui a reçu des autorisations dans Dataverse. Pour plus d’informations sur la configuration d’un utilisateur d’application pour s’authentifier auprès de Dataverse, consultez Utiliser l’authentification serveur à serveur unique.

Configuration prise en charge

Pour la configuration de chaque onglet sous activité de copie, accédez respectivement aux sections suivantes.

• Généralités
• Source
• Destination
• Cartographie
• Settings

General

Pour la configuration de l’onglet Général , accédez aux paramètres généraux.

Origine

Accédez à l’onglet Source pour configurer votre source d’activité de copie. Consultez le contenu suivant pour obtenir la configuration détaillée.

Les propriétés suivantes sont requises :

• Connexion : sélectionnez une connexion Dataverse existante dans la liste des connexions. Si aucune connexion n’existe, créez une connexion Dataverse en sélectionnant Nouveau.
• Type de connexion : sélectionnez Dataverse.
• Utiliser la requête : spécifiez la façon utilisée pour lire les données. Vous pouvez choisir le nom d’entité pour lire des données à l’aide du nom d’entité ou de la requête pour utiliser la requête pour lire les données.

  • Nom de l’entité : sélectionnez votre nom d’entité dans la liste déroulante, ou sélectionnez Modifier pour l’entrer manuellement. Il s’agit du nom logique de l’entité à récupérer.

  • Requête : utilisation de FetchXML pour lire des données à partir de Dataverse. FetchXML est un langage de requête propriétaire utilisé dans Dynamics online et localement. Consultez l’exemple qui suit. Pour plus d’informations, consultez Générer des requêtes avec FetchXML.

    Exemple de requête FetchXML :

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

Sous Avancé, vous pouvez spécifier les champs suivants :

• Colonnes supplémentaires: Ajoutez des colonnes de données supplémentaires pour stocker le chemin relatif ou la valeur statique des fichiers sources. L’expression est prise en charge pour ce dernier. Pour plus d’informations, accédez à Ajouter des colonnes supplémentaires pendant la copie.

Destination

Accédez à l’onglet Destination pour configurer votre destination d’activité de copie. Consultez le contenu suivant pour obtenir la configuration détaillée.

Les propriétés suivantes sont requises :

• Connexion : sélectionnez une connexion Dataverse existante dans la liste des connexions. Si aucune connexion n’existe, créez une connexion Dataverse en sélectionnant Nouveau.
• Type de connexion : sélectionnez Dataverse.
• Nom de l’entité : spécifiez le nom de l’entité à écrire des données. Sélectionnez votre nom d’entité dans la liste déroulante, ou sélectionnez Modifier pour l’entrer manuellement. Il s’agit du nom logique de l’entité à récupérer.

Sous Avancé, vous pouvez spécifier les champs suivants :

• Comportement d’écriture : comportement d’écriture de l’opération. Cette propriété est requise et vous devez sélectionner Upsert. Si vous utilisez Ajouter du contenu dynamique, spécifiez la valeur à Upsert.
• Autre nom de clé : spécifiez le nom de clé alternatif défini sur votre entité pour mettre à jour ou insérer des enregistrements.
• Ignorer les valeurs Null : indique s’il faut ignorer les valeurs Null des données d’entrée pendant l’opération d’écriture. Elle est sélectionnée par défaut.
  • Lorsqu’il est sélectionné : laissez les données dans l’objet de destination inchangés lors de l’opération upsert/update, puis insérez la valeur par défaut définie lors de l’opération d’insertion.
  • Lorsqu’il n’est pas sélectionné : Mettez à jour les données de l’objet de destination sur NULL lors de l’opération upsert/update, puis insérez une valeur NULL lors de l’opération d’insertion.
• Taille du lot d’écriture : spécifiez le nombre de lignes de données écrites dans Dataverse dans chaque lot.
• Nombre maximal de connexions simultanées : la limite supérieure de connexions simultanées établies au magasin de données pendant l’exécution de l’activité. Spécifiez une valeur uniquement lorsque vous souhaitez limiter les connexions simultanées.

Cartographie

Pour la configuration de l’onglet Mappage , accédez à Configurer vos mappages sous l’onglet Mappage. Si vous choisissez Binaire comme format de fichier, le mappage ne sera pas pris en charge.

Paramètres

Pour la configuration de l’onglet Paramètres , accédez à Configurer vos autres paramètres sous l’onglet Paramètres.

Résumé du tableau

Consultez le tableau suivant pour obtenir le résumé et plus d’informations sur l’activité de copie Dataverse.

Informations sur la source

Informations de destination

Contenu connexe

• Vue d’ensemble du connecteur Dataverse