Définir des clés de remplacement pour référencer des lignes

Les clés de substitution fournissent un moyen efficace et précis d’intégrer des données avec des systèmes externes. Il est essentiel dans les cas où un système externe ne stocke pas les ID d’identificateur global unique (GUID) qui identifient de manière unique les lignes dans Microsoft Dataverse.

Un système d’intégration de données utilise des clés alternatives pour identifier des lignes à l’aide d’une ou de plusieurs valeurs de colonnes de table qui représentent une combinaison unique. Chaque clé de remplacement porte un nom unique.

Par exemple, pour identifier une ligne de compte avec une clé de remplacement, vous pouvez utiliser le numéro de compte ou la colonne du numéro de compte en combinaison avec quelques autres colonnes qui contiennent des valeurs qui ne doivent pas changer.

Note

Bien que vous puissiez définir des clés secondaires avec Power Apps, vous ne pouvez les utiliser que par programmation dans le code. Pour en savoir plus sur l’utilisation des clés de substitution par programme, voir :

Voici quelques avantages de la fonctionnalité des touches secondaires :

  • Recherche plus rapide des lignes.
  • Opérations groupées sur les données plus robustes.
  • Programmation simplifiée avec des données importées à partir de systèmes externes sans ID de ligne.

Création d’une clé de substitution

Il existe deux outils que vous pouvez utiliser pour créer des clés secondaires :

Designer Description
Portail Power Apps Fournit une expérience simple et fluide, mais certaines options ne sont pas disponibles.
Pour plus d’informations, voir : Définir des clés secondaires à l’aide du portail Power Apps
Explorateur de solutions Pas aussi facile, mais fournit davantage de flexibilité pour des besoins moins courants.
Pour plus d’informations : Définir des clés secondaires à l’aide de l’explorateur de solutions

Note

Vous pouvez également créer une clé secondaire dans votre environnement comme suit :

Les informations de cet article vous permettent de choisir l’éditeur de conception à utiliser.

Vous devez utiliser le portail Power Apps pour créer des clés alternatives sauf si vous devez traiter l’une des exigences suivantes :

  • Créer une clé secondaire dans une solution autre que Common Data Service Default Solution.
  • Vous souhaitez suivre facilement la tâche système créée pour le suivi de la progression de la création des index de support.

Limites de la création de clés de substitution

Il existe des contraintes à la création de clés de remplacement.

Champs qui peuvent être utilisés pour les clés alternatives

Seuls ces types de colonnes peuvent être utilisés pour créer des clés de substitution :

  • Décimal
  • Nombre entier (entier)
  • Une seule ligne de texte (Chaîne)
  • Date et heure
  • Rechercher
  • Option

Note

  • Les colonnes sur lesquelles la propriété Activer la sécurité des colonnes activée ne peuvent pas être utilisées comme autre clé. Pour plus d’informations : Tables de sécurité des champs
  • Lorsque des valeurs NULL sont utilisées dans les colonnes de clé de remplacement, l’unicité ne sera pas appliquée. Pour éviter les enregistrements en double, n’utilisez pas de valeurs nulles dans les colonnes définies dans la contrainte unique de la clé de remplacement.

Nombre de clés

Vous pouvez définir jusqu’à 10 clés différentes pour une table.

Taille de clé valide

Lorsqu’une clé est créée, le système valide que la clé peut être prise en charge par la plateforme, notamment le fait que la taille totale de la clé n’enfreint pas les contraintes des index SQL, à savoir 900 octets par clé et 16 colonnes par clé. Si la taille de la clé ne répond pas aux contraintes, un message d’erreur s’affiche.

Caractères Unicode en valeur de clé

Si les données d’une colonne utilisée dans une clé secondaire contiennent l’un des caractères suivants <,>,*,%,&,:,/,\\,#, alors les actions de mise à jour ou d’upsert (PATCH) ne fonctionneront pas.

Si vous n’avez besoin que d’unicité, cette approche fonctionnera, mais si vous devez utiliser ces clés dans le cadre de l’intégration de données, il est préférable de créer la clé pour les colonnes qui ne contiennent pas de données avec ces caractères.

Suivez le statut de la création de la clé alternative

Lorsqu’une clé alternative est créée, elle lance une tâche système pour créer des index sur les tables de la base de données afin d’appliquer des contraintes uniques sur les colonnes utilisées pour la clé alternative. La clé alternative ne prendra pas effet tant que ces index ne seront pas créés. La création de ces index peut prendre un certain temps en fonction de la quantité de données dans le système.

Le statut de la tâche système détermine l’état de la clé alternative. La clé secondaire peut avoir les états suivants :

  • En attente
  • En cours
  • Active
  • Échec

Lorsque la tâche système est terminée, le statut de la clé secondaire est Actif et elle est disponible en vue de son utilisation.

Si la tâche système échoue, recherchez la tâche système pour afficher toutes les erreurs. La tâche système aura un nom qui suit ce modèle : Create index for {0} for table {1} où 0 est le Nom d’affichage de la clé de remplacement et 1 est le nom de la table.

Note

Si vous voulez surveiller le statut de la tâche système vous devez utiliser l’explorateur de solutions pour créer l’index. Il doit contenir un lien vers la tâche système afin de pouvoir la surveiller. Informations complémentaires : (Facultatif) Afficher le suivi des tâches système pour la création d’index

Voir aussi

Définir des clés secondaires à l’aide du portail Power Apps
Définir les clés secondaires à l’aide de l’Explorateur de solution
Documentation du développeur : Utiliser d’autres clés
Documentation du développeur : Utiliser une autre clé pour référencer un enregistrement
Documentation du développeur : Récupérer un enregistrement à l’aide d’une autre clé

  • Dernière mise à jour :