Synchronisation des valeurs de données de référence
Important
La fonctionnalité de synchronisation des valeurs de référence dans votre partition de données Azure Data Manager for Energy est actuellement en préversion limitée. Si vous souhaitez activer cette fonctionnalité pour votre abonnement Azure, contactez votre interlocuteur Microsoft Sales ou ouvrez un ticket de support pour obtenir de l’aide.
Cet article fournit une vue d’ensemble des valeurs de données de référence dans la plateforme de données OSDU 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 de la plateforme de données OSDU, les valeurs de données de référence jouent un rôle crucial pour garantir 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é.
En plus de faciliter l’interprétation et la collaboration des données, les données de référence sont requises pour l’ingestion des données via le workflow 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 FIXED : cet ensemble de valeurs de référence est universellement reconnu et utilisé 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 que vous pouvez étendre (mais vous ne pouvez pas les modifier).
- Valeurs LOCAL : la communauté OSDU fournit une liste initiale de valeurs LOCAL 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 des données OSDU / Définitions des 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é, de nouvelles instances Azure Data Manager for Energy sont automatiquement créées avec des valeurs de données de référence FIXED et OPEN synchronisées avec le dernier ensemble de la communauté OSDU pour le jalon actuel pris en charge par Azure Data Manager for Energy. Vous pouvez également choisir de créer des instances avec des valeurs LOCAL synchronisées.
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.
Étendue actuelle de la synchronisation des valeurs de données de référence d’Azure Data Manager for Energy
Actuellement, Azure Data Manager for Energy synchronise les valeurs de données de référence lors de la création d’une instance et lors de la création d’une partition pour les instances créées après l’activation de la fonctionnalité. Les valeurs de référence sont synchronisées avec celles de la communauté OSDU correspondant au jalon OSDU pris en charge par Azure Data Manager for Energy au moment de la création de l’instance ou de la partition. Pour plus d’informations sur le jalon actuel pris en charge et le service OSDU disponible dans Azure Data Manager for Energy, consultez Services OSDU disponibles dans Azure Data Manager for Energy.