Управление типами сущностей и сопоставлениями

Функция сопоставления в построителе цифровых двойников (предварительная версия) позволяет пользователям приступить к созданию онтологии с семантически богатыми типами сущностей и гидратировать их с помощью данных из различных исходных систем. Концептуальные сведения о функции сопоставления в построителе цифровых двойников см. в разделе "Сопоставление данных с типами сущностей" в построителе цифровых двойников (предварительная версия). После сопоставления данных можно завершить онтологию, выполнив контекстуализацию.

В этом документе описывается создание типов сущностей и управление их сопоставлениями данных в построителе цифровых двойников (предварительная версия).

Prerequisites

• Рабочая область с емкостью , поддерживающей Microsoft Fabric.

• Ваши желанные данные в озере данных Fabric с необходимыми выполненными ETL процессами.

  • Данные временных рядов должны находиться в формате columnar . Данные временных рядов столбцов структурированы таким образом, чтобы каждый столбец представлял собой другую переменную или атрибут, а каждая строка соответствует определенной метке времени.

  • Построитель цифровых двойников поддерживает исходные столбцы со следующими типами данных: bigint, boolean, char, date, datetime, decimal, double, float, integer, long, short, smallint, string, timestamp, timestampint64, tinyint.

    Note

    Точность десятичного типа в исходных данных не полностью сохраняется при импорте данных в построитель цифровых двойников.

• Элемент построителя цифровых двойников (предварительная версия).

Создание типа сущности

1. Выберите "Добавить сущность " на семантическом холсте построителя цифровых двойников (предварительная версия).

   

2. Выберите системный тип или выберите "Универсальный ", чтобы создать пользовательский тип сущности. Затем выберите имя для типа сущности. Каждый тип сущности в пространстве имен должен иметь уникальное имя.

   Note

   Имена типов сущностей должны быть 1–26 символов, содержать только буквенно-цифровые символы, дефисы и символы подчеркивания, а также начинать и заканчиваться буквенно-цифровым символом.

   

3. Просмотрите пустой тип сущности на семантическом холсте.

   

Сопоставление данных, отличных от временных рядов, с типом сущности

Сначала сопоставляйте несерийные временные данные. Сопоставления непо-временным рядам должны выполняться перед сопоставлениями временных рядов.

1. При выборе типа сущности на панели "Сущности " отображается область конфигурации сущности для типа сущности. Перейдите на вкладку "Сопоставления" и нажмите кнопку "Добавить данные".

   

2. Выберите таблицу Lakehouse из вашего OneLake, чтобы использовать её в качестве исходной таблицы для сопоставления. Выберите "Выбрать источник данных".

   

3. В новом сопоставлении рядом с исходной таблицей выберите "Нет фильтра ", чтобы добавить фильтр в исходную таблицу.

   Введите параметры для создания условия, например "Имя >> содержит танк ", чтобы отфильтровать только строки, в которых имя содержит танк. Фильтры чувствительны к регистру.

   

   Нажмите кнопку "Применить".

4. Выберите тип свойства исходных данных. Для сопоставления можно выбрать только один тип свойства. Например, предположим, что contoso_sample_data содержит описательные атрибуты о танках. Сопоставление этих данных содержит свойства не временные ряды.

   

5. Настройте уникальный идентификатор для каждой записи приема данных. Для уникального идентификатора можно выбрать один или несколько столбцов, но рекомендуется минимальный набор столбцов.

   

6. Для сопоставленных свойств настройте столбцы из исходной таблицы, которые вы хотите использовать для моделирования типа сущности.

   

   Помните следующие заметки:

   • При необходимости можно сопоставить столбец в исходной таблице данных со свойством DisplayName . Этот шаг предоставляет понятное имя для каждого экземпляра сущности в последующих опытах.

   • При необходимости можно выбрать новое имя исходного столбца, которое будет отображаться, когда он моделируется на основе экземпляров сущностей.

     Note

     Пользовательские имена столбцов должны быть 1–26 символами, содержать только буквенно-цифровые символы, дефисы и подчеркивания, а также начинать и заканчиваться буквенно-цифровым символом.

   • При выборе исходного столбца список параметров сгруппирован в два раздела: доступный и недоступный. Доступные столбцы — это столбцы в исходной таблице, которые соответствуют типу данных свойства, которое вы пытаетесь сопоставить. Недоступные столбцы — это столбцы, которые не соответствуют типу, поэтому их невозможно сопоставить с этим свойством.

7. Нажмите Сохранить, чтобы сохранить не временное сопоставление.

   

8. Перейдите на вкладку "Планирование " и выберите "Выполнить ", чтобы запустить сопоставление. Запуск моделей сопоставления определённых свойств на ваших экземплярах сущностей. После моделирования свойств их нельзя удалить, и их имена не могут быть изменены.

   

Сопоставление данных временных рядов с типом сущности

1. Выберите вкладку "Сопоставления" в области конфигурации сущности и нажмите кнопку "Добавить данные ", чтобы начать создание сопоставления.

2. Выберите таблицу Lakehouse из вашего OneLake, чтобы использовать её в качестве исходной таблицы для сопоставления.

3. Для типа свойства этого сопоставления выберите свойства временных рядов.

4. Настройте сопоставленные свойства.

   Данные временных рядов должны находиться в формате столбцов в источнике данных Lakehouse, где каждый столбец представляет другую переменную или атрибут, а каждая строка соответствует определенной метке времени. Для этого сопоставления требуется столбец метки времени типа DateTime .

   

5. Настройте ссылку со свойством сущности , выбрав столбец из данных временных рядов, который точно соответствует типу свойства, определенному в типе сущности. Этот процесс позволяет конструктору цифровых двойников (предварительная версия) соотнести данные временных рядов с существующими экземплярами сущностей.

   Tip

   Если вы не видите используемое свойство, отличное от временных рядов, сначала необходимо сопоставить свойство, отличное от временных рядов, а затем вернуться к этому шагу.

   

6. Убедитесь, что включено добавочное сопоставление . После включения сопоставления временных рядов с добавочным сопоставлением невозможно изменить это сопоставление.

   Tip

   Если необходимо изменить добавочное сопоставление, создайте новое сопоставление. Если цель состоит в удалении свойства, удалите существующее сопоставление и создайте новое. Если ваша цель состоит в добавлении свойства, просто создайте дополнительное сопоставление с тем же источником и новыми свойствами.

7. Нажмите кнопку "Сохранить", чтобы сохранить сопоставление временных рядов.

   

8. Перейдите на вкладку "Планирование " и выберите "Выполнить ", чтобы запустить сопоставление.

Управление сопоставлениями

Ниже приведены действия, доступные для управления сопоставлением.

• Сопоставление представлений: все сопоставления, создаваемые для определенного типа сущности, можно просмотреть на вкладке "Сопоставления" в области конфигурации сущности при выборе этого типа сущности. Их также можно просмотреть в представлении потоков конструктора цифровых двойников (предварительная версия), выбрав на ленте пункт "Управление операциями".

  

• Изменение сопоставления. Чтобы изменить сопоставление, измените любую часть конфигурации в области конфигурации сущности. Проверьте все конфигурации, чтобы избежать непредвиденных результатов и сохранить изменения.

  Note

  Имена типов сущностей и имена свойств не редактируются. Однако можно удалить исходный столбец из сопоставления.

• Удаление сопоставления. Чтобы удалить сопоставление, выберите значок корзины в правом верхнем углу требуемой карты сопоставления. Удаление этого сопоставления не удаляет базовые данные, сопоставленные с этим заданием, или удаляет любые свойства из типа сущности, но удаляет сопоставление с семантического холста.

  

• Запланированное сопоставление: Чтобы запланировать сопоставление, перейдите на вкладку «Планирование» и создайте поток построения цифровых двойников. Включите поток расписания, создайте новый поток и настройте его сведения. Дополнительные сведения см. в потоке конструктора цифровых двойников (предварительная версия).

  

  

Деактивация типа сущности

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

При деактивации типов сущностей следует учитывать следующие примечания:

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

Чтобы отключить тип сущности, наведите указатель мыши на его имя на семантическом холсте и выберите ... рядом с его именем. Выберите "Деактивировать сущность".

Связанный контент

• Сопоставление данных с типами сущностей в конструкторе цифровых двойников (предварительная версия)
• Выполнение контекстуализации