Remarque
L’accès à cette page requiert une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page requiert une autorisation. Vous pouvez essayer de modifier des répertoires.
Cet article fournit une vue d’ensemble des valeurs de données de référence dans OSDU Data Platform et explique comment Azure Data Manager for Energy vous aide à les synchroniser avec les normes de la communauté OSDU®®.
Que sont les valeurs de données de référence et pourquoi sont-elles importantes ?
Dans l’infrastructure OSDU Data Platform®, les valeurs de données de référence jouent un rôle crucial dans la cohérence et la normalisation des données. Les données de référence désignent l’ensemble des valeurs d’attribut autorisées dans différents champs de données, tels que les données de base ou les composants d’un produit de travail. Par exemple, degree Celsius est un attribut UnitofMeasure autorisé et Billing Address un attribut AddressType autorisé.
Outre l’activation de l’interprétation et de la collaboration des données, les données de référence sont requises pour l’ingestion des données via le flux de travail d’ingestion du manifeste OSDU®. Les manifestes fournissent un conteneur spécifique pour les valeurs de données de référence, qui servent ensuite à valider les données ingérées et à générer des métadonnées à des fins de découverte et d’utilisation ultérieures. Pour en savoir plus sur l’ingestion basée sur un manifeste, consultez Concepts en lien avec l’ingestion basée sur un manifeste.
La plateforme® de données OSDU classe les valeurs de données de référence dans les trois compartiments suivants :
- Valeurs FIXEs : cet ensemble de valeurs de référence est reconnu et utilisé universellement dans les déploiements osDU® et le secteur de l’énergie. Ces valeurs ne peuvent pas être étendues ou modifiées, sauf par les mises à jour de gouvernance de la communauté OSDU®
- Valeurs OPEN : la communauté OSDU® fournit une liste initiale de valeurs OPEN sur lesquelles vous pouvez étendre, mais pas modifier autrement
- Valeurs LOCALES : la communauté OSDU® fournit une liste initiale de valeurs LOCALES que vous pouvez modifier, étendre ou remplacer entièrement
Pour plus d’informations sur les valeurs de données de référence OSDU® et leurs différents types, consultez Définitions de données OSDU® / Définitions de données / Données de référence.
Configuration de la synchronisation des valeurs dans Azure Data Manager for Energy
Pour vous aider à maintenir l’intégrité des données et à faciliter l’interopérabilité, les nouvelles instances Azure Data Manager for Energy sont créées automatiquement avec des valeurs de données de référence FIXE et OPEN synchronisées par la dernière version de la communauté OSDU® pour la jalon actuel prise en charge par Azure Data Manager for Energy. Lors de l’approvisionnement, vous pouvez également choisir de créer de nouvelles instances avec des valeurs LOCALES synchronisées ou de ne pas les synchroniser.
Par la suite, si vous créez des partitions de données dans l’instance Azure Data Manager for Energy, elles seront également créées avec des valeurs de référence FIXED et OPEN synchronisées. Si vous avez choisi de synchroniser également les valeurs LOCAL lors de la création initiale de l’instance, les nouvelles partitions synchronisent aussi les valeurs LOCAL de la communauté.
Comme indiqué dans l’article Démarrage rapide : créer une instance Azure Data Manager for Energy, vous pouvez choisir d’activer la synchronisation des valeurs LOCAL lors de la création d’une instance Azure Data Manager for Energy. Lors du déploiement via le Portail Azure, vous pouvez activer la synchronisation des données LOCAL sous l’onglet Paramètres avancés. Les valeurs de référence FIXED et OPEN sont toujours synchronisées lors de la création d’instances.
Lors du déploiement via des modèles ARM, vous pouvez activer la synchronisation des données LOCAL en définissant la propriété ReferenceDataProperties sur All. Pour restreindre la synchronisation aux valeurs FIXED et OPEN uniquement, définissez sa valeur sur NonLocal.
Balises légales et droits pour les valeurs de référence synchronisées
Azure Data Manager for Energy définit automatiquement des balises légales et des droits pour les valeurs de données de référence lors de leur synchronisation.
Pour toutes les valeurs de données de référence synchronisées, qu’il s’agisse de données FIXED, OPEN ou LOCAL, les balises légales sont définies sur {data-partition-id}-referencedata-legal, où {data-partition-id} correspond au nom de la partition de données que vous avez fourni lors de la configuration de la création d’une partition de données.
Pour les droits, Azure Data Manager for Energy crée automatiquement des groupes de droits que vous pouvez ensuite utiliser pour les contrôles d’accès. Des groupes OWNERS et VIEWERS sont créés pour les valeurs FIXED, OPEN et LOCAL :
| Ensemble de gouvernance | Groupe OWNERS | Groupe VIEWERS |
|---|---|---|
| FIXED | data.referencedata.owners@{data_partition_id}.{osdu_domain} | data.referencedata.viewers@{data_partition_id}.{osdu_domain} |
| OPEN | data.referencedata.owners@{data_partition_id}.{osdu_domain} | data.referencedata.viewers@{data_partition_id}.{osdu_domain} |
| LOCAL | data.referencedata-local.owners@{data_partition_id}.{osdu_domain} | data.referencedata-local.viewers@{data_partition_id}.{osdu_domain} |
Les groupes LOCAL ci-dessus sont créés uniquement si vous avez choisi de synchroniser les valeurs LOCAL.
Si vous étendez les valeurs OPEN après la création de l’instance, nous vous recommandons de créer et d’utiliser différentes listes de contrôle d’accès (ACL) pour régir leur accès. Par exemple, data.referencedata-{ORG}.owners@{data_partition_id}.{osdu_domain} et data.referencedata-{ORG}.viewers@{data_partition_id}.{osdu_domain}, où {ORG} différencie la liste de contrôle d’accès de celle utilisée pour les valeurs OPEN standard synchronisées lors de la création.
Les mises à jour de NameAlias ne nécessitent pas de droit distinct. Les mises à jour du champ NameAlias sont régies par les mêmes mécanismes de contrôle d’accès que les mises à jour de toute autre partie d’un enregistrement de stockage. En effet, l’accès OWNER confère le droit de mettre à jour le champ NameAlias.
Mises à niveau automatisées des valeurs de données de référence d'étape OSDU®
Azure Data Manager for Energy met à jour les valeurs de données de référence (RDV) en appliquant automatiquement les dernières valeurs fixes, OUVERTES et LOCALES alignées sur OSDU® dans le cadre du cycle de mise à niveau standard de chaque instance. Ces mises à jour permettent aux instances de s’aligner sur les définitions OSDU® en constante évolution tout en préservant les configurations spécifiques au client, le cas échéant. Cette approche garantit que les valeurs FIXED restent interopérables sur tous les systèmes OSDU®, les valeurs OPEN continuent de prendre en charge l’extensibilité sans perdre l’intention du client, et les valeurs LOCALES conservent le sens spécifique à l’entreprise sur lequel les organisations dépendent. Les mises à jour ne nécessitent aucune action utilisateur et ne se produisent en toute transparence sans temps d’arrêt : Azure Data Manager for Energy intègre de nouvelles valeurs fournies par OSDU®, met à jour les valeurs FIXEs aux dernières normes et conserve les modifications des clients pour OPEN et LOCAL. À mesure que le contrôle de version RDV est dissocié des versions OSDU®, Azure Data Manager for Energy applique les mises à jour RDV uniquement pendant la mise à niveau complète du jalon OSDU®, garantissant ainsi un déploiement prévisible et régi.
Résumé du comportement de mise à jour des valeurs de données de référence
| Type de RDV | Comportement de mise à niveau | Justification |
|---|---|---|
| FIXE | Mise à jour vers la dernière norme OSDU® ; les versions antérieures restent accessibles dans l’historique. | Garantit l’interopérabilité globale entre les systèmes basés sur OSDU®. |
| OPEN | Les entrées étendues ou modifiées par le client sont conservées ; De nouvelles entrées de base osDU® sont ajoutées sans remplacer les modifications de l’utilisateur. | Équilibre la sémantique partagée avec l’extensibilité pilotée par l’utilisateur. |
| LOCAL | Les comportements suivent le choix d’approvisionnement de l’instance ; Les valeurs personnalisées restent inchangées et les nouvelles suggestions OSDU® sont ajoutées uniquement si LOCAL a été activé. | Protège la signification propre à l’entreprise et évite toute modification involontaire. |
Pour plus d’informations sur le jalon actuel pris en charge par les services OSDU® disponibles dans Azure Data Manager for Energy, reportez-vous aux services OSDU® disponibles dans Azure Data Manager for Energy.