Sincronizar valores de datos de referencia

En este artículo se proporciona información general sobre los valores de datos de referencia en la plataforma de datos OSDU y se explica cómo Azure Data Manager for Energy le ayuda a sincronizarlos con los estándares de la comunidad OSDU.

¿Qué son los valores de datos de referencia y por qué son importantes?

Dentro del marco de la plataforma de datos OSDU, los valores de datos de referencia desempeñan un papel fundamental para garantizar la coherencia y la estandarización de los datos. Los datos de referencia hacen referencia al conjunto de valores permitidos para que los atributos se usen en varios campos de datos, como los datos maestros o los componentes del producto de trabajo. Por ejemplo, degree Celsius es un atributo UnitofMeasure permitido y Billing Address es un atributo AddressType permitido.

Además de habilitar la interpretación y la colaboración de datos, se requieren datos de referencia para la ingesta de datos a través del flujo de trabajo de ingesta de manifiestos OSDU. Los manifiestos proporcionan un contenedor específico para los valores de datos de referencia, que se usan para validar los datos ingeridos y generar metadatos para su posterior detección y uso. Para obtener más información sobre la ingesta basada en manifiestos, consulte Conceptos de ingesta basados en manifiestos.

La plataforma de datos OSDU clasifica los valores de datos de referencia en los tres depósitos siguientes:

• Valores FIXED: este conjunto de valores de referencia es universalmente conocido y se usa en implementaciones OSDU y en el sector energético. Estos valores no se pueden ampliar ni cambiar, excepto en las actualizaciones de gobernanza de la comunidad OSDU
• Valores OPEN: la comunidad OSDU proporciona una lista inicial de valores OPEN que puede ampliar (pero no puede modificar)
• Valores LOCAL: la comunidad OSDU proporciona una lista inicial de valores LOCAL que puede cambiar, extender o reemplazar libremente

Para obtener más información sobre los valores de datos de referencia de OSDU y sus diferentes tipos, consulte Definiciones de datos OSDU / Definiciones de datos / Datos de referencia.

Configurar sincronización de valores en Azure Data Manager for Energy

Para ayudarle a mantener la integridad de los datos y facilitar la interoperabilidad, las nuevas instancias de Azure Data Manager for Energy se crean automáticamente con los valores de datos de referencia FIXED y OPEN sincronizados según el conjunto más reciente de la comunidad OSDU para el hito actual admitido por Azure Data Manager for Energy. Además, puede optar por crear nuevas instancias con valores LOCAL sincronizados también.

Más adelante, si crea nuevas particiones de datos en la instancia de Azure Data Manager for Energy, también se crearán con los valores de referencia FIXED y OPEN sincronizados. Si ha elegido sincronizar además los valores LOCAL al crear la instancia por primera vez, las nuevas particiones también sincronizarán los valores LOCALES de la comunidad.

Como se describe en el artículo Inicio rápido: Crear una instancia de Azure Data Manager for Energy, puede optar por habilitar la sincronización de valores LOCAL al crear una nueva instancia de Azure Data Manager for Energy. Al implementar a través de Azure Portal, puede habilitar la sincronización de valores LOCAL en la pestaña "Configuración avanzada". Los valores de referencia FIXED y OPEN siempre se sincronizarán cuando se creen nuevas instancias.

Al implementar mediante plantillas de ARM, puede habilitar la sincronización de valores LOCAL estableciendo la propiedad ReferenceDataProperties en All. Para restringir la sincronización solo con valores FIXED y OPEN, establezca su valor en NonLocal.

Etiquetas legales y derechos para valores de referencia sincronizados

Azure Data Manager for Energy establece automáticamente etiquetas legales y derechos para los valores de datos de referencia a medida que se sincronizan.

Para todos los valores de datos de referencia sincronizados, ya sea FIXED, OPEN o LOCAL, las etiquetas legales se establecen en {data-partition-id}-referencedata-legal, donde {data-partition-id} corresponde al nombre de partición de datos que proporcionó al configurar la creación de una nueva partición de datos.

Para Derechos, Azure Data Manager for Energy crea automáticamente grupos de derechos que puede usar para los controles de acceso. Los grupos se crean para OWNERS y VIEWERS en los valores FIXED, OPEN y LOCAL:

Los grupos LOCAL anteriores solo se crean si decide sincronizar valores LOCAL.

Si amplía los valores OPEN después de la creación de la instancia, se recomienda crear y usar diferentes listas de control de acceso (ACL) para controlar su acceso. Por ejemplo, data.referencedata-{ORG}.owners@{data_partition_id}.{osdu_domain} y data.referencedata-{ORG}.viewers@{data_partition_id}.{osdu_domain}, donde {ORG} diferencia la ACL de la usada para los valores OPEN estándar sincronizados al crearse.

Las actualizaciones de NameAlias no requieren un derecho independiente. Las actualizaciones del campo NameAlias se rigen por los mismos mecanismos de control de acceso que las actualizaciones de cualquier otra parte de un registro de almacenamiento. En efecto, el acceso OWNER concede el derecho a actualizar el campo NameAlias.

Ámbito actual de la sincronización de valores de datos de referencia de Azure Data Manager for Energy

Actualmente, Azure Data Manager for Energy sincroniza los valores de datos de referencia en la creación de una instancia y en la creación de una nueva partición para instancias recién creadas tras la habilitación de la característica. Los valores de referencia se sincronizan con los de la comunidad de OSDU, correspondientes al hito de OSDU admitido por Azure Data Manager for Energy en el momento de la creación de la instancia o de la partición. Para obtener información sobre el hito actual que admite y el servicio OSDU disponible en Azure Data Manager for Energy, consulte Servicios OSDU disponibles en Azure Data Manager for Energy.

Pasos siguientes

• Inicio rápido: creación de instancias de Azure Data Manager for Energy
• Tutorial: Pasos de ejemplo para realizar una ingesta de archivos basada en manifiesto
• Guía de inicio rápido de carga de datos del operador OSDU