Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Questo articolo offre una panoramica dei valori dei dati di riferimento in OSDU® Data Platform e spiega in che modo Azure Data Manager for Energy 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 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 FISSI : 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 su cui è possibile estendere ma non modificare altrimenti
- Valori LOCALI : la community OSDU® fornisce un elenco iniziale di valori LOCAL che è possibile modificare, 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 i valori dei 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 for Energy. Durante il provisioning, è anche possibile scegliere se creare nuove istanze con valori LOCAL anch'essi sincronizzati o rifiutare esplicitamente.
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.
Aggiornamenti automatizzati dei valori dei dati di riferimento per il Milestone OSDU®
Azure Data Manager for Energy updates Reference Data Values (RDV) applicando automaticamente i valori FIXED, OPEN e LOCAL più recenti allineati a OSDU® come parte del ciclo di aggiornamento standard di ogni istanza. Questi aggiornamenti mantengono le istanze allineate alle definizioni OSDU® in continua evoluzione mantenendo le configurazioni specifiche del cliente, se appropriato. Questo approccio garantisce che i valori FIXED rimangano interoperabili in tutti i sistemi basati su OSDU®, i valori OPEN continuano a supportare l'estendibilità senza perdere la finalità del cliente e i valori LOCAL mantengono il significato specifico dell'azienda da cui dipendono le organizzazioni. Gli aggiornamenti non richiedono alcuna azione da parte dell'utente e si verificano senza tempi di inattività. Azure Data Manager for Energy incorpora nuovi valori forniti da OSDU®, aggiorna i valori FIXED agli standard più recenti e mantiene le modifiche dei clienti per OPEN e LOCAL. Poiché il controllo delle versioni RDV è separato dalle versioni OSDU®, Azure Data Manager per l'energia applica gli aggiornamenti RDV solo durante l'aggiornamento cardine OSDU® all-up, garantendo un'implementazione prevedibile e regolamentata.
Riepilogo del comportamento di aggiornamento dei valori dei dati di riferimento
| Tipo RDV | Comportamento di aggiornamento | Motivazione |
|---|---|---|
| FISSO | Aggiornato allo standard OSDU® più recente; Le versioni precedenti rimangono accessibili nella cronologia. | Garantisce l'interoperabilità globale tra sistemi basati su OSDU®. |
| OPEN | Le voci estese o modificate dal cliente vengono mantenute; Vengono aggiunte nuove voci di base OSDU® senza sovrascrivere le modifiche dell'utente. | Bilancia la semantica condivisa con l'estendibilità basata sull'utente. |
| LOCAL | I comportamenti seguono la scelta di provisioning dell'istanza; i valori personalizzati rimangono invariati e vengono aggiunti nuovi suggerimenti OSDU® solo se LOCAL è stato abilitato. | Protegge il significato specifico dell'azienda ed evita modifiche impreviste. |
Per informazioni sul traguardo corrente supportato e sui servizi OSDU® disponibili in Azure Data Manager for Energy, vedere i servizi OSDU® disponibili in Azure Data Manager for Energy.