Partager via


Déterminer l’unicité des enregistrements

Microsoft Cloud for Sustainability Sommet technologique novembre 2024.

Cet article fournit des informations sur les règles utilisées afin de déterminer l’unicité des enregistrements dans Microsoft Sustainability Manager dans Microsoft Cloud for Sustainability. Sustainability Manager fournit deux façons de déterminer l’unicité des enregistrements :

  • Utiliser l’ID de corrélation d’origine (OCID)
  • Génération automatique d’une clé primaire basée sur les attributs clés

L’OCID est un identifiant facultatif pour corréler un enregistrement avec son origine des données. Il figure dans notre modèle de données en tant qu’attribut facultatif pour les enregistrements de données de référence, d’activité et d’émissions. L’OCID est fourni lors de la création de l’enregistrement pour un enregistrement de données d’activité ou d’émissions. Si vous fournissez un OCID, Sustainability Manager l’utilise pour générer la clé primaire pour cet enregistrement.

L’OCID doit être unique pour chaque enregistrement, vous ne pouvez donc pas l’utiliser pour associer plusieurs enregistrements dans une seule entité/table. Si vous ne fournissez pas d’OCID, Sustainability Manager utilise l’approche de génération d’une clé primaire basée sur les attributs de clé, ce qui implique l’utilisation d’un certain ensemble d’attributs par entité pour générer la clé primaire.

Important

Une fois que vous avez défini la valeur OCID sur les enregistrements d’activité, vous ne pouvez plus la modifier.

Les données de Sustainability Manager entrent dans les trois catégories suivantes :

  • Données d’activité : les enregistrements de portée 1 à 3 capturent les activités productrices d’émissions telles que l’électricité achetée ou combustion mobile. Les émissions précalculées ingérées sont considérées comme des données d’activité et sont traitées de la même manière.

  • Données de référence : Les enregistrements d’appui sont généralement utilisés lors du calcul et de la classification des données d’activité. Les exemples incluent les bibliothèques de facteurs d’émission, le mode de transport ou le type de déplacement professionnel.

  • Données système : enregistrements opérationnels communs qui font généralement partie de normes plus larges telles que les facteurs de gaz à effet de serre (GES), les unités par défaut et les mappages de codes pays/région.

Ces catégories utilisent des règles différentes pour déterminer le comportement d’unicité d’un enregistrement. Par conséquent, les mises à jour peuvent se comporter différemment selon les catégories. Utilisez le tableau suivant pour déterminer comment gérer votre système.

Type d’enregistrement Règle d’évaluation de la clé primaire Résultat Méthode de mise à jour
Données d’activité Si OriginCorrelationID est fourni, il est utilisé pour générer la clé primaire pour cet enregistrement. Si un enregistrement avec le même OriginCorrelatinID existe déjà, l’enregistrement est mis à jour. Si un enregistrement avec le même OriginCorrelationID pour le type d’entité n’existe pas, l’enregistrement est inséré.

Si OriginCorrelationID n’est pas fourni, tous les champs de l’enregistrement accessibles à l’utilisateur constituent la clé d’enregistrement unique, à l’exception de Connexion, ConnectionRefresh, Preuve et Description.
Si l’un des champs par règle d’évaluation est différent et que vous n’avez pas spécifié de OriginCorrelationID, l’enregistrement est considéré comme différent et est inséré. Utilisez OriginCorrelationID pour les mises à jour.
Données de référence Nom : Doit être unique. Si l’enregistrement ingéré porte un nom identique, l’enregistrement est considéré comme un doublon.

OriginCorrelationID : s’il est spécifié, doit être unique. Si un enregistrement avec le même OriginCorrelatinID existe déjà, l’enregistrement est mis à jour. Si un enregistrement avec le même OriginCorrelationID pour le type d’entité n’existe pas, l’enregistrement est inséré.

Clé primaire : Nom et OriginCorrelationID (si spécifié).

Si Nom est différent et que OriginCorrelationID correspond, l’enregistrement est considéré comme une mise à jour et le Nom est écrasé par les données d’enregistrement entrantes.

Les noms d’estimation et facteur d’émission sont uniques au sein de leur bibliothèque.

Nom de la bibliothèque plus Nom est la clé des facteurs.
Si le nom d’un enregistrement existe déjà, l’enregistrement est considéré comme un doublon, sauf si vous spécifiez un OriginCorrelationID. Utilisez OriginCorrelationID pour les mises à jour.
Données système Nom : Doit être unique. Si l’enregistrement ingéré porte un nom identique, l’enregistrement est considéré comme un doublon.

OriginCorrelationID : s’il est spécifié, doit être unique. Utilisé pour les mises à jour.
Si le nom d’un enregistrement existe déjà, l’enregistrement est considéré comme un doublon, sauf si vous spécifiez un OriginCorrelationID. S’il est fourni, utilisez OriginCorrelationID pour les mises à jour.

Sinon, si une mise à jour est requise, vous devez suivre la méthode delete-insert.

Remarque : nous ne recommandons pas de mettre à jour les données système.

Importer des données
Microsoft Cloud for Sustainability modèle de données