Автоматическая синхронизация значений ссылочных данных в менеджере данных Azure для энергетики

В этой статье представлен обзор ссылочных значений данных на платформе данных OSDU и объясняется, как Azure Data Manager for Energy помогает синхронизировать их с стандартами сообщества OSDU®®.

Каковы значения ссылочных данных и почему они важны?

В платформе платформы® данных OSDU эталонные значения данных играют важную роль в обеспечении согласованности и стандартизации данных. Справочные данные относятся к набору допустимых значений атрибутов, используемых в различных полях данных, таких как основные данные или рабочие компоненты продукта. Например, degree Celsius — разрешенный UnitofMeasure, и Billing Address — разрешенный AddressType.

Помимо обеспечения интерпретации данных и совместной работы, эталонные данные требуются для загрузки данных с помощью процесса загрузки манифеста OSDU®. Манифесты предоставляют определенный контейнер для ссылочных значений данных, которые затем используются для проверки приема данных и создания метаданных для последующего обнаружения и использования. Чтобы узнать больше о загрузке на основе манифеста, см. Концепции загрузки на основе манифеста.

Платформа® данных OSDU классифицирует значения ссылочных данных в следующие три сегмента:

  • Фиксированные значения: этот набор ссылочных значений широко распознается и используется в развертываниях OSDU® и энергетическом секторе. Эти значения не могут быть расширены или изменены, за исключением обновлений системы управления сообществом OSDU®
  • Значения OPEN: сообщество OSDU® предоставляет начальный список значений OPEN, на основе которых можно расширять, но не иначе изменять.
  • Локальные значения: сообщество OSDU® предоставляет начальный список локальных значений, которые можно свободно изменять, расширять или полностью заменять.

Дополнительные сведения о значениях ссылочных данных OSDU и их различных типах см. в разделе "Определения данных OSDU® ®", "Определения данных" и "Справочные данные".

Настройка синхронизации значений в диспетчере данных Azure для энергии

Для обеспечения целостности данных и упрощения взаимодействия новые экземпляры Azure Data Manager для Energy автоматически создаются с FIXED и OPEN справочными значениями данных, синхронизированными по последнему набору сообщества OSDU®, поддерживаемому текущей вехой Azure Data Manager for Energy. При развертывании можно также выбрать создание новых экземпляров с синхронизированными локальными значениями или использовать значения по умолчанию.

Позже, если вы создадите новые разделы данных в экземпляре службы Azure Data Manager for Energy, они также будут созданы с синхронизированными значениями ссылок FIXED и OPEN. Если при первоначальном создании экземпляра вы выбрали опциональную синхронизацию локальных значений, то новые разделы также будут синхронизировать локальные значения из сообщества.

Как описано в статье Quickstart: создание экземпляра Azure Data Manager for Energy, вы можете включить синхронизацию локальных значений при создании нового экземпляра Azure Data Manager for Energy. При развертывании на портале Azure можно включить локальную синхронизацию на вкладке "Дополнительные параметры". Фиксированные и открытые эталонные значения всегда будут синхронизированы при создании новых экземпляров.

При развертывании через шаблоны ARM можно включить локальную ReferenceDataProperties синхронизацию, задав для свойства значение All. Чтобы ограничить синхронизацию только фиксированными и ОТКРЫТЫМи значениями, задайте для нее значение NonLocal.

диспетчер данных Azure для энергетики автоматически задает Legal Tags и Entitlements для ссылочных значений данных по мере их синхронизации.

Для всех синхронизированных значений ссылочных данных, будь то FIXED, OPEN или LOCAL, юридические теги устанавливаются как , где {data-partition-id}-referencedata-legal соответствует имени раздела данных, предоставленному при настройке создания нового раздела данных.

Для Entitlements Azure Data Manager для энергетики автоматически создает группы прав, которые затем можно использовать для управления доступом. Группы создаются для ВЛАДЕЛЬЦЕВ и ПРОСМОТРЩИКОВ в фиксированных, открытых и локальных категориях.

Набор управления Группа "ВЛАДЕЛЬЦЫ" Группа VIEWERS
ИСПРАВЛЕНО data.referencedata.owners@{data_partition_id}.{osdu_domain} data.referencedata.viewers@{data_partition_id}.{osdu_domain}
ОТКРЫТО data.referencedata.owners@{data_partition_id}.{osdu_domain} data.referencedata.viewers@{data_partition_id}.{osdu_domain}
ЛОКАЛЬНО data.referencedata-local.owners@{data_partition_id}.{osdu_domain} data.referencedata-local.viewers@{data_partition_id}.{osdu_domain}

Приведенные выше локальные группы создаются только в том случае, если вы решили синхронизировать значения LOCAL.

Если вы расширяете значения OPEN после создания экземпляра, мы рекомендуем создавать и использовать различные списки управления доступом (ACL) для управления их доступом. Например, data.referencedata-{ORG}.owners@{data_partition_id}.{osdu_domain} и data.referencedata-{ORG}.viewers@{data_partition_id}.{osdu_domain}, где {ORG} различает ACL от того, который используется для стандартных значений OPEN, синхронизированных при создании.

Обновления NameAlias не требуют отдельного права. NameAlias Обновления поля управляются теми же механизмами управления доступом, что и обновления любой другой части записи хранения. В действительности доступ OWNER предоставляет право на обновление поля NameAlias.

Автоматические обновления значений справочных данных OSDU®

Azure Диспетчер данных для энергетической отрасли обновляет ссылочные значения данных (RDVs) путем автоматического применения последних значений, согласованных со стандартами OSDU®: ФИКСИРОВАННЫХ, ОТКРЫТЫХ и ЛОКАЛЬНЫХ, в рамках стандартного цикла обновлений каждого экземпляра. Эти обновления синхронизируют экземпляры с изменяющимися определениями OSDU®, при этом сохраняются конфигурации, специфичные для клиентов, где это уместно. Этот подход гарантирует, что фиксированные значения остаются совместимыми во всех системах на основе OSDU®, значения OPEN продолжают поддерживать расширяемость, не теряя намерения клиента, и локальные значения сохраняют бизнес-значения, от которые зависят организации. Обновления не требуют никаких действий пользователя и выполняются беспрепятственно, без простоя — Azure Data Manager for Energy включает новые значения, предоставленные OSDU®, обновляет фиксированные значения в соответствии с последними стандартами и сохраняет изменения клиента для OPEN и LOCAL. Так как управление версиями RDV отличается от версий OSDU®, Azure Data Manager for Energy выполняет обновления RDV только при обновлении OSDU® до вехи, обеспечивая прогнозируемое и управляемое развертывание.

Сводка об обновлении поведения значений справочных данных

Тип RDV Поведение обновления Логическое обоснование
ИСПРАВЛЕНО Обновлено до последнего стандарта OSDU®; предыдущие версии остаются доступными в истории. Обеспечивает глобальное взаимодействие между системами на основе OSDU®.
OPEN Сохраняются расширенные или измененные записи клиента; Новые базовые записи OSDU® добавляются без перезаписи изменений пользователей. Балансирует общую семантику с расширяемостью, управляемой пользователями.
LOCAL Поведение следует выбору типа предоставления экземпляра; пользовательские значения остаются неизменными, а новые предложения OSDU® добавляются только в том случае, если параметр LOCAL включен. Защищает конкретное бизнес-значение и избегает непреднамеренного изменения.

Во время автоматического обновления RDV Диспетчер данных Azure для энергетики проверяет юридические теги, связанные с существующими записями ссылочных данных перед применением обновлений. Если раздел данных содержит записи с истекшим сроком действия юридических тегов, применяется следующее поведение:

  • Существующие RDV с истекшим сроком действия юридических тегов пропускаются. Процесс обновления пропускает обновления для записей, юридические теги которых истекли, а не завершается сбоем всего обновления для раздела данных. Эти записи остаются в текущей версии до устранения проблемы с юридическим тегом.
  • Новые RDVs по-прежнему добавляются. Новые эталонные значения данных, представленные в последней вехе OSDU®, добавляются успешно, так как они получают новые юридические теги и не влияют на существующие теги с истекшим сроком действия.
  • Потеря данных не возникает . Пропущенные записи не удаляются или не изменяются. После продления или замены истекших юридических меток, записи могут быть обновлены в следующем цикле контрольных точек.

Замечание

Чтобы убедиться, что все значения ссылочных данных обновляются в ходе обновлений этапов, проверьте, что срок действия юридических тегов в ваших разделах данных не истек. Вы можете определить сбои проверки истечения срока действия юридического тега в журналах службы хранилища для вашего экземпляра Azure Data Manager для Energy.

Сведения о поддерживаемой в настоящий момент вехе и доступных службах OSDU® в Azure Data Manager for Energy см. в разделе OSDU® услуги, доступные в Azure Data Manager для энергетики.

Следующие шаги