Sincronizzazione dei valori dei dati di riferimento
Importante
La funzionalità per sincronizzare i valori di riferimento nella partizione di dati di Azure Data Manager per l'energia è attualmente in anteprima limitata. Se si è interessati a abilitare questa funzionalità per la sottoscrizione di Azure, contattare il contatto di Microsoft Sales o aprire un ticket di supporto per assistenza.
Questo articolo offre una panoramica dei valori dei dati di riferimento in OSDU Data Platform e spiega in che modo Azure Data Manager per l’energia consente di sincronizzarli con gli standard della community OSDU.
Quali sono i valori dei dati di riferimento e perché sono importanti?
All'interno del framework OSDU Data Platform, i valori dei dati di riferimento svolgono un ruolo fondamentale per garantire la coerenza e la standardizzazione dei dati. I dati di riferimento fanno riferimento al set di valori consentiti per gli attributi da usare in vari campi dati, ad esempio i dati master o i componenti del prodotto di lavoro. Ad esempio, degree Celsius è un UnitofMeasureconsentito e Billing Address è un consentitoAddressType.
Oltre ad abilitare l'interpretazione e la collaborazione dei dati, i dati di riferimento sono necessari per l'inserimento di dati tramite il flusso di lavoro di inserimento del manifesto OSDU. I manifesti forniscono un contenitore specifico per i valori dei dati di riferimento, che vengono quindi usati per convalidare i dati inseriti e generare metadati per l'individuazione e l'uso successivi. Per altre informazioni sull'inserimento basato su manifesto, vedere Concetti di inserimento basato su manifesto.
OSDU Data Platform classifica i valori dei dati di riferimento nei tre bucket seguenti:
- Valori FIXED: questo set di valori di riferimento viene riconosciuto e usato universalmente nelle distribuzioni OSDU e nel settore energetico. Questi valori non possono essere estesi o modificati ad eccezione degli aggiornamenti della governance della community OSDU
- Valori OPEN: la community OSDU fornisce un elenco iniziale di valori OPEN che è possibile estendere ma non modificare in alcun modo
- Valori LOCAL: la community OSDU fornisce un elenco iniziale di valori LOCAL che è possibile modificare liberamente, estendere o sostituire completamente
Per altre informazioni sui valori dei dati di riferimento OSDU e sui relativi tipi diversi, vedere Definizioni di dati OSDU/Definizioni di dati/Dati di riferimento.
Configurazione della sincronizzazione dei valori in Azure Data Manager per l'energia
Per mantenere l'integrità dei dati e facilitare l'interoperabilità, le nuove istanze di Azure Data Manager per l'energia vengono create automaticamente con valori di dati di riferimento FIXED e OPEN sincronizzati in base al set più recente della community OSDU per l' attività cardine corrente supportata da Azure Data Manager per l’energia. È anche possibile scegliere di creare nuove istanze con valori LOCAL anch’essi sincronizzati.
Successivamente, se si creano nuove partizioni di dati nell'istanza di Azure Data Manager per l'energia, anche tali partizioni verranno create con i valori di riferimento FIXED e OPEN sincronizzati. Se si è scelto di sincronizzare anche i valori LOCAL quando è stata creata per la prima volta l'istanza, le nuove partizioni sincronizzano anche i valori LOCAL dalla community.
Come illustrato in Guida introduttiva. Creare un'istanza di Azure Data Manager per l'energia, è possibile scegliere di abilitare la sincronizzazione dei valori LOCAL durante la creazione di una nuova istanza di Azure Data Manager per l'energia. Quando si esegue la distribuzione tramite il portale di Azure, è possibile abilitare la sincronizzazione dei valori LOCAL nella scheda "Impostazioni avanzate". I valori di riferimento FIXED e OPEN verranno sempre sincronizzati quando vengono create nuove istanze.
Quando si esegue la distribuzione tramite modelli di Azure Resource Manager, è possibile abilitare la sincronizzazione dei valori LOCAL impostando la proprietà ReferenceDataProperties su All. Per limitare la sincronizzazione solo ai valori FIXED e OPEN, impostarne il valore su NonLocal.
Tag legali ed entitlement per i valori di riferimento sincronizzati
Azure Data Manager per l’energia imposta automaticamente Tag legali ed Entitlement per i valori dei dati di riferimento durante la sincronizzazione.
Per tutti i valori dei dati di riferimento sincronizzati, sia FIXED, OPEN o LOCAL, i tag legali vengono impostati su {data-partition-id}-referencedata-legal, dove {data-partition-id} corrisponde al nome della partizione di dati specificato durante la configurazione della creazione della nuova partizione di dati.
Per Entitlement, Azure Data Manager per l’energia crea automaticamente gruppi di entitlement che è possibile usare per i controlli di accesso. I gruppi vengono creati per PROPRIETARI e VISUALIZZATORI per i valori FIXED, OPEN e LOCAL:
| Set di governance | Gruppo PROPRIETARI | Gruppo VISUALIZZATORI |
|---|---|---|
| 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} |
I gruppi LOCAL precedenti vengono creati solo se si sceglie di sincronizzare i valori LOCAL.
Se si estendono i valori OPEN dopo la creazione dell'istanza, è consigliabile creare e usare elenchi di controllo di accesso (ACL) diversi per gestire l'accesso. Ad esempio, data.referencedata-{ORG}.owners@{data_partition_id}.{osdu_domain} e data.referencedata-{ORG}.viewers@{data_partition_id}.{osdu_domain}, dove {ORG} differenzia l’elenco di controllo di accesso da quello usato per i valori OPEN standard sincronizzati al momento della creazione.
Gli aggiornamenti di NameAlias non richiedono un entitlement separato. Gli aggiornamenti del campo NameAlias sono regolati dagli stessi meccanismi di controllo di accesso degli aggiornamenti di qualsiasi altra parte di un record di archiviazione. In effetti, l'accesso PROPRIETARIO conferisce il diritto di aggiornare il campo NameAlias.
Ambito corrente della sincronizzazione dei valori dei dati di riferimento in Microsoft Azure Data Manager per l'energia
Attualmente, Azure Data Manager per l’energia sincronizza i valori dei dati di riferimento al momento della creazione dell'istanza e di nuove partizioni per le nuove istanze create dopo l'abilitazione delle funzionalità. I valori di riferimento vengono sincronizzati con quelli della community OSDU, corrispondente all'attività cardine OSDU supportata da Azure Data Manager per l’energia al momento della creazione dell'istanza o della partizione. Per informazioni sull'attività cardine corrente supportata dal servizio OSDU disponibile in Azure Data Manager per l'energia, vedere Servizi OSDU disponibili in Azure Data Manager per l'energia.