Referentiegegevenswaarden synchroniseren
Belangrijk
De functie voor het synchroniseren van referentiewaarden in uw Azure Data Manager for Energy-gegevenspartitie is momenteel in beperkte preview. Als u deze functie wilt inschakelen voor uw Azure-abonnement, neemt u contact op met uw Microsoft Sales-contactpersoon of opent u een ondersteuningsticket voor hulp.
Dit artikel bevat een overzicht van referentiegegevenswaarden in OSDU Data Platform en legt uit hoe Azure Data Manager for Energy u helpt deze te synchroniseren met osDU-communitystandaarden.
Wat zijn referentiegegevenswaarden en waarom zijn ze belangrijk?
Binnen het OSDU Data Platform-framework spelen referentiegegevenswaarden een cruciale rol bij het waarborgen van gegevensconsistentie en standaardisatie. Referentiegegevens verwijzen naar de set toegestane waarden voor kenmerken die moeten worden gebruikt in verschillende gegevensvelden, zoals hoofdgegevens of werkproductonderdelen. Is bijvoorbeeld degree Celsius toegestaan UnitofMeasureen Billing Address is toegestaan AddressType.
Naast het inschakelen van gegevensinterpretatie en samenwerking, zijn referentiegegevens vereist voor gegevensopname via de osDU-manifestopnamewerkstroom. Manifesten bieden een specifieke container voor referentiegegevenswaarden, die vervolgens worden gebruikt om de opgenomen gegevens te valideren en metagegevens te genereren voor latere detectie en gebruik. Zie concepten voor op manifest gebaseerde opname voor meer informatie over op manifest gebaseerde opnameconcepten.
Het OSDU-gegevensplatform categoriseert referentiegegevenswaarden in de volgende drie buckets:
- VASTE waarden: Deze set referentiewaarden wordt universeel herkend en gebruikt in OSDU-implementaties en de energiesector. Deze waarden kunnen niet worden uitgebreid of gewijzigd, behalve door updates voor OSDU-communitybeheer
- OPEN-waarden : De OSDU-community biedt een eerste lijst met OPEN-waarden waarop u kunt uitbreiden, maar niet anders kunt wijzigen
- LOCAL-waarden : De OSDU-community biedt een initiële lijst met LOKALE waarden die u vrijelijk kunt wijzigen, uitbreiden of volledig kunt vervangen
Zie OSDU-gegevensdefinities/gegevensdefinities/gegevensdefinities/referentiegegevens voor meer informatie over OSDU-referentiegegevenswaarden en hun verschillende typen.
Waardesynchronisatie configureren in Azure Data Manager for Energy
Om u te helpen de gegevensintegriteit te behouden en interoperabiliteit te vergemakkelijken, worden nieuwe Instanties van Azure Data Manager for Energy automatisch gemaakt met VASTE en OPEN-referentiegegevens die zijn gesynchroniseerd volgens de meest recente set van de OSDU-community voor de huidige mijlpaal die wordt ondersteund door Azure Data Manager for Energy. U kunt er ook voor kiezen om nieuwe exemplaren te maken met LOKALE waarden die ook worden gesynchroniseerd.
Als u later nieuwe gegevenspartities maakt in het azure Data Manager for Energy-exemplaar, worden deze ook gemaakt met de gesynchroniseerde referentiewaarden FIXED en OPEN. Als u ervoor hebt gekozen om lokale waarden ook te synchroniseren toen u het exemplaar voor het eerst maakte, worden met nieuwe partities ook LOCAL-waarden uit de community gesynchroniseerd.
Zoals beschreven in de quickstart: Een azure Data Manager for Energy-exemplaarartikel maken, kunt u ervoor kiezen om LOCAL-waardesynchronisatie in te schakelen bij het maken van een nieuw Exemplaar van Azure Data Manager for Energy. Wanneer u implementeert via Azure Portal, kunt u LOKAAL synchroniseren inschakelen op het tabblad Geavanceerde instellingen. VASTE en OPEN-referentiewaarden worden altijd gesynchroniseerd wanneer er nieuwe exemplaren worden gemaakt.
Wanneer u implementeert via ARM-sjablonen, kunt u LOKAAL synchroniseren inschakelen door de ReferenceDataProperties eigenschap in te stellen op All. Als u synchronisatie wilt beperken tot alleen VASTE en OPEN-waarden, stelt u de waarde ervan in op NonLocal.
Juridische tags en rechten voor gesynchroniseerde referentiewaarden
Azure Data Manager for Energy stelt automatisch juridische tags en rechten in voor referentiegegevenswaarden wanneer ze worden gesynchroniseerd.
Voor alle gesynchroniseerde referentiegegevenswaarden, ongeacht of OPGELOST, OPEN of LOKAAL, juridische tags zijn ingesteld {data-partition-id}-referencedata-legalop, waar {data-partition-id} komt overeen met de naam van de gegevenspartitie die u hebt opgegeven bij het configureren van het maken van een nieuwe gegevenspartitie.
Voor rechten maakt Azure Data Manager for Energy automatisch rechtengroepen die u vervolgens kunt gebruiken voor toegangsbeheer. Groepen worden gemaakt voor EIGENAREN en VIEWERS voor VASTE, OPEN- en LOKALE waarden:
| Governanceset | GROEP EIGENAREN | VIEWERS-groep |
|---|---|---|
| VAST | data.referencedata.owners@{data_partition_id}. {osdu_domain} | data.referencedata.viewers@{data_partition_id}. {osdu_domain} |
| OPENEN | data.referencedata.owners@{data_partition_id}. {osdu_domain} | data.referencedata.viewers@{data_partition_id}. {osdu_domain} |
| LOKAAL | data.referencedata-local.owners@{data_partition_id}. {osdu_domain} | data.referencedata-local.viewers@{data_partition_id}. {osdu_domain} |
De bovenstaande LOKALE groepen worden alleen gemaakt als u ervoor kiest om LOCAL-waarden te synchroniseren.
Als u OPEN-waarden uitbreidt na het maken van een exemplaar, raden we u aan verschillende toegangsbeheerlijsten (ACL's) te maken en te gebruiken om hun toegang te beheren. En, data.referencedata-{ORG}.owners@{data_partition_id}.{osdu_domain} data.referencedata-{ORG}.viewers@{data_partition_id}.{osdu_domain}waarbij {ORG} de ACL bijvoorbeeld wordt onderscheiden van de ACL die wordt gebruikt voor standaard OPEN-waarden die tijdens het maken zijn gesynchroniseerd.
Voor NameAlias-updates is geen afzonderlijke rechten vereist. Updates voor het NameAlias veld worden beheerd door dezelfde mechanismen voor toegangsbeheer als updates voor elk ander deel van een opslagrecord. In feite verleent OWNER-toegang het recht om het NameAlias veld bij te werken.
Huidig bereik van Azure Data Manager for Energy reference data value syncing
Op dit moment synchroniseert Azure Data Manager for Energy referentiegegevenswaarden bij het maken van exemplaren en bij het maken van nieuwe partities voor nieuw gemaakte exemplaren na het inschakelen van functies. Referentiewaarden worden gesynchroniseerd met die van de OSDU-community, die overeenkomen met de OSDU-mijlpaal die wordt ondersteund door Azure Data Manager for Energy op het moment dat het exemplaar of de partitie is gemaakt. Voor informatie over de huidige mijlpaal die wordt ondersteund door en de beschikbare OSDU-service in Azure Data Manager for Energy, raadpleegt u OSDU-services die beschikbaar zijn in Azure Data Manager for Energy.