Sincronização dos Valores de Dados de Referência
Importante
O recurso para sincronizar valores de referência em sua partição de dados do Azure Data Manager for Energy está atualmente em Versão Prévia Limitada. Se estiver interessado em habilitar esse recurso para sua assinatura do Azure, entre em contato com seu contato de Vendas da Microsoft ou abra um tíquete de suporte para obter assistência.
Este artigo fornece uma visão geral dos valores de dados de referência na plataforma de Dados OSDU e explica como o Azure Data Manager for Energy ajuda você a sincronizá-los com os padrões da comunidade OSDU.
O que são valores de dados de referência e por que eles são importantes?
Na estrutura da Plataforma de Dados OSDU, os valores de dados de referência desempenham um papel crucial para garantir a consistência e a padronização dos dados. Os dados de referência referem-se ao conjunto de valores permitidos para atributos a serem usados em vários campos de dados, como dados mestres ou componentes de produtos de trabalho. Por exemplo, degree Celsius é um UnitofMeasure permitido e Billing Address é um AddressType permitido.
Além de permitir a interpretação e a colaboração de dados, os dados de referência são necessários para a ingestão de dados por meio do fluxo de trabalho de ingestão de manifesto da OSDU. Os manifestos fornecem um contêiner específico para valores de dados de referência, usados para validar os dados ingeridos e gerar metadados para descoberta e uso posteriores. Para saber mais sobre a ingestão baseada em manifesto, consulte Conceitos de ingestão baseada em manifesto.
A Plataforma de Dados OSDU categoriza os valores de dados de referência nos três grupos a seguir:
- Valores FIXED: Esse conjunto de valores de referência é universalmente reconhecido e usado nas implantações da OSDU e no setor de energia. Esses valores não podem ser estendidos ou alterados, exceto por atualizações de governança da comunidade OSDU
- Valores OPEN: A comunidade OSDU fornece uma lista inicial de valores OPEN sobre os quais você pode estender, mas não alterar de outra forma
- Valores LOCAL: A comunidade OSDU fornece uma lista inicial de valores LOCAL que podem ser livremente alterados, ampliados ou totalmente substituídos
Para obter mais informações sobre os valores de dados de referência da OSDU e seus diferentes tipos, consulte Definições de Dados da OSDU / Definições de Dados / Dados de Referência.
Configurando a sincronização de valor no Azure Data Manager for Energy
Para ajudá-lo a manter a integridade dos dados e facilitar a interoperabilidade, as novas instâncias do Azure Data Manager for Energy são criadas automaticamente com valores de dados de referência FIXED e OPEN sincronizados de acordo com o conjunto mais recente da comunidade OSDU para o marco atual suportado pelo Azure Data Manager for Energy. Além disso, você pode optar por criar novas instâncias com valores LOCAL sincronizados também.
Posteriormente, se você criar novas partições de dados na instância do Azure Data Manager for Energy, elas também serão criadas com os valores de referência FIXED e OPEN sincronizados. Se você tiver optado por sincronizar adicionalmente os valores LOCAL quando criou a instância pela primeira vez, as novas partições também sincronizarão os valores LOCAL da comunidade.
Conforme abordado no Início Rápido: Criar uma instância do Azure Data Manager for Energy, você pode optar por habilitar a sincronização de valores LOCAL ao criar uma nova instância do Azure Data Manager for Energy. Ao implantar por meio do portal do Azure, você pode habilitar a sincronização LOCAL na guia "Configurações Avançadas". Os valores de referência FIXED e OPEN sempre serão sincronizados quando novas instâncias forem criadas.
Ao implantar por meio de modelos ARM, você pode habilitar a sincronização LOCAL definindo a propriedade ReferenceDataProperties como All. Para restringir a sincronização apenas aos valores FIXED e OPEN, defina seu valor como NonLocal.
Informações jurídicas e direitos para valores de referência sincronizados
O Azure Data Manager for Energy define automaticamente os rótulos Jurídicos e Direitos para valores de dados de referência à medida que são sincronizados.
Para todos os valores de dados de referência sincronizados, sejam eles FIXED, OPEN ou LOCAL, os Rótulos Jurídicos são definidas como {data-partition-id}-referencedata-legal, onde {data-partition-id} corresponde ao nome da partição de dados que você forneceu ao configurar a criação de uma nova partição de dados.
Para Direitos, o Azure Data Manager for Energy cria automaticamente grupos de direitos que podem ser usados para controles de acesso. São criados grupos para OWNERS e VIEWERS nos valores FIXED, OPEN e LOCAL:
| Definir Governança | Grupo OWNERS | Grupo 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} |
Os grupos LOCAL acima são criados somente se você optar por sincronizar os valores LOCAL.
Se você estender os valores OPEN após a criação da instância, recomendamos a criação e o uso de listas de controle de acesso (ACLs) diferentes para controlar o acesso. Por exemplo, data.referencedata-{ORG}.owners@{data_partition_id}.{osdu_domain} e data.referencedata-{ORG}.viewers@{data_partition_id}.{osdu_domain}, em que {ORG} diferencia a ACL daquela usada para os valores OPEN padrão sincronizados na criação.
As atualizações de NameAlias não requerem um direito separado. As atualizações do campo NameAlias são regidas pelos mesmos mecanismos de controle de acesso que as atualizações de qualquer outra parte de um registro de armazenamento. De fato, o acesso OWNER confere o direito de atualizar o campo NameAlias.
Escopo atual da sincronização de valores de dados de referência do Azure Data Manager for Energy
Atualmente, o Azure Data Manager for Energy sincroniza os valores dos dados de referência na criação da instância e na criação de uma nova partição para instâncias recém-criadas após a habilitação do recurso. Os valores de referência são sincronizados com aqueles da comunidade OSDU, correspondendo ao marco OSDU com suporte do Azure Data Manager for Energy no momento da criação da instância ou da partição. Para obter informações sobre o marco atual com suporte do serviço OSDU disponível no Azure Data Manager for Energy, consulte Serviços OSDU disponíveis no Azure Data Manager for Energy.