Synkronisera referensdatavärden
Viktigt!
Funktionen för att synkronisera referensvärden i Azure Data Manager for Energy-datapartitionen finns för närvarande i begränsad förhandsversion. Om du är intresserad av att ha den här funktionen aktiverad för din Azure-prenumeration kontaktar du antingen din Microsoft Sales-kontakt eller öppnar ett supportärende för att få hjälp.
Den här artikeln innehåller en översikt över referensdatavärden i OSDU Data Platform och förklarar hur Azure Data Manager for Energy hjälper dig att synkronisera dem med OSDU-communitystandarder.
Vad är referensdatavärden och varför är de viktiga?
Inom OSDU Data Platform-ramverket spelar referensdatavärden en avgörande roll för att säkerställa datakonsekvens och standardisering. Referensdata refererar till uppsättningen tillåtna värden för attribut som ska användas i olika datafält, till exempel huvuddata eller arbetsproduktkomponenter. Till exempel degree Celsius är en tillåten UnitofMeasure, och Billing Address är en tillåten AddressType.
Förutom att aktivera datatolkning och samarbete krävs referensdata för datainmatning via OSDU-manifestets inmatningsarbetsflöde. Manifest tillhandahåller en specifik container för referensdatavärden, som sedan används för att verifiera inmatade data och generera metadata för senare identifiering och användning. Mer information om manifestbaserad inmatning finns i Manifestbaserade inmatningsbegrepp.
OSDU-dataplattformen kategoriserar referensdatavärden i följande tre bucketar:
- FASTA värden: Den här uppsättningen referensvärden känns igen universellt och används i OSDU-distributioner och energisektorn. Dessa värden kan inte utökas eller ändras förutom genom uppdateringar av OSDU-communityns styrning
- ÖPPNA värden: OSDU-communityn innehåller en inledande lista över ÖPPNA värden som du kan utöka men inte ändra på annat sätt
- LOKALA värden: OSDU-communityn innehåller en inledande lista över LOKALA värden som du fritt kan ändra, utöka eller helt ersätta
Mer information om OSDU-referensdatavärden och deras olika typer finns i OSDU-datadefinitioner/datadefinitioner/referensdata.
Konfigurera värdesynkronisering i Azure Data Manager for Energy
För att hjälpa dig att upprätthålla dataintegriteten och underlätta samverkan skapas automatiskt nya Azure Data Manager for Energy-instanser med fasta och ÖPPNA referensdatavärden synkroniserade enligt den senaste uppsättningen från OSDU-communityn för den aktuella milstolpen som stöds av Azure Data Manager for Energy. Du kan också välja att skapa nya instanser med LOKALA värden synkroniserade.
Senare, om du skapar nya datapartitioner i Azure Data Manager for Energy-instansen, skapas de också med fasta och ÖPPNA-referensvärden synkroniserade. Om du har valt att dessutom synkronisera LOKALA värden när du först skapade instansen synkroniserar nya partitioner även LOKALA värden från communityn.
Som beskrivs i artikeln Snabbstart: Skapa en Azure Data Manager for Energy-instans kan du välja att aktivera LOKAL värdesynkronisering när du skapar en ny Azure Data Manager för Energy-instans. När du distribuerar via Azure-portalen kan du aktivera LOKAL synkronisering på fliken Avancerade inställningar. FASTA och ÖPPNA-referensvärden synkroniseras alltid när nya instanser skapas.
När du distribuerar via ARM-mallar kan du aktivera LOKAL synkronisering genom att ange ReferenceDataProperties egenskapen till All. Om du vill begränsa synkroniseringen till endast FASTA och ÖPPNA värden anger du värdet till NonLocal.
Juridiska taggar och rättigheter för synkroniserade referensvärden
Azure Data Manager for Energy anger automatiskt juridiska taggar och rättigheter för referensdatavärden när de synkroniseras.
För alla synkroniserade referensdatavärden, oavsett om de är FASTA, ÖPPNA eller LOKALA, anges juridiska taggar till {data-partition-id}-referencedata-legal, där {data-partition-id} motsvarar det datapartitionsnamn som du angav när du konfigurerade skapandet av ny datapartition.
För Berättiganden skapar Azure Data Manager for Energy automatiskt berättigandegrupper som du sedan kan använda för åtkomstkontroller. Grupper skapas för ÄGARE och TITTARE för fasta, ÖPPNA och LOKALA värden:
| Styrningsuppsättning | ÄGARGRUPP | VISNINGSGRUPP |
|---|---|---|
| FAST | data.referencedata.owners@{data_partition_id}. {osdu_domain} | data.referencedata.viewers@{data_partition_id}. {osdu_domain} |
| ÖPPNA | data.referencedata.owners@{data_partition_id}. {osdu_domain} | data.referencedata.viewers@{data_partition_id}. {osdu_domain} |
| LOKAL | data.referencedata-local.owners@{data_partition_id}. {osdu_domain} | data.referencedata-local.viewers@{data_partition_id}. {osdu_domain} |
Ovanstående LOKALA grupper skapas bara om du väljer att synkronisera LOKALA värden.
Om du utökar OPEN-värden efter att instansen har skapats rekommenderar vi att du skapar och använder olika åtkomstkontrollistor (ACL: er) för att styra deras åtkomst. Till exempel data.referencedata-{ORG}.owners@{data_partition_id}.{osdu_domain} , och data.referencedata-{ORG}.viewers@{data_partition_id}.{osdu_domain}, där {ORG} skiljer ACL från den som används för standard OPEN-värden som synkroniseras när du skapar.
NameAlias-uppdateringar kräver ingen separat berättigande. Uppdateringar av fältet NameAlias styrs av samma mekanismer för åtkomstkontroll som uppdateringar av andra delar av en lagringspost. I själva verket ger OWNER-åtkomst behörigheten att uppdatera fältet NameAlias .
Aktuell omfångssynkronisering av Azure Data Manager for Energy-referensdatavärdessynkronisering
För närvarande refererar Azure Data Manager för Energy till datavärden när instansen skapas och när ny partition skapas för nyligen skapade instanser efter funktionsaktivering. Referensvärden synkroniseras med värden från OSDU-communityn, vilket motsvarar den OSDU-milstolpe som stöds av Azure Data Manager for Energy när instansen eller partitionen skapas. Information om den aktuella milstolpen som stöds av och tillgänglig OSDU-tjänst i Azure Data Manager for Energy finns i OSDU-tjänster som är tillgängliga i Azure Data Manager for Energy.