在本教程的这一部分中，你将在数字孪生生成器（预览版）中定义实体，并将数据映射到它们。 实体包括：
- 蒸馏器
- 冷凝器
- 重沸器
- 过程
- 技术员
- MaintenanceRequest
对于每个实体，将属性和/或时序数据从示例表映射到数字孪生生成器中的实体属性。
重要
此功能目前为预览版。
添加蒸馏器实体
在本部分中，你将在示例本体“ 酿酒器”中定义第一个实体。
在数字孪生生成器（预览版）的语义画布中，选择 “添加实体”。
选择 设备 系统类型。 系统类型是可在定义实体时选择的内置实体类型，可将其与此类型的对象通用的一组相关属性自动关联。
为实体名称输入 提取器 ，然后选择“ 添加实体”。
几分钟后， 提取器 实体现在在画布上可见。
将数据映射到酿酒器
接下来，将某些数据映射到 Distiller 实体。
数字孪生生成器（预览版）中的映射功能是创建具有语义丰富实体的本体学的第一步。 在映射期间，您将实体与来自各种源系统的数据填充。
可以将时序和非时序属性添加到实体。 将这两种类型的属性映射到实体时，必须先映射至少一个非时序属性，然后才能映射时序属性。 然后，通过将实体中的非时序属性与时序数据中的列匹配，将非时序和时序数据链接在一起。 时序列中的值必须与映射到实体属性的数据 完全 匹配。
映射非时序属性
首先映射资产元数据。
在画布上或实体列表窗格中选择实体以打开 “实体配置 ”窗格。
在窗格中，转到“ 映射 ”选项卡。选择 “添加数据 ”以创建新映射。
打开 Select Lakehouse 表 以选择映射的数据源。 在教程工作区中，选择 GettingStartedRawData lakehouse 和 assetdata 表。
（可选）等待数据预览加载。 选择 “选择要确认的数据源 ”。
在 “源表 ”选项旁边，选择“ 未应用筛选器 ”以向源表映射添加筛选器。 选择列 名称，操作 包含和值 蒸馏器（区分大小写）。 然后，选择应用。
按钮文本现在显示 应用了筛选器。
接下来，选择要映射的数据的属性 类型 。 此第一个映射处理 蒸馏器 实体的资产元数据，因此请选择 非时间序列属性。
在 “唯一 ID”下，选择编辑图标（形状为铅笔），为数据选择唯一 ID。 唯一 ID 是从源数据中的一列或多列创建的，由数字孪生构建工具用来唯一标识导入的每一行数据。 选择 ID 作为此数据的唯一 ID，然后选择“ 确定 ”以保存并关闭模式。
在 “映射属性”下，选择编辑图标以映射源表中的属性。
通过 “映射属性 ”窗格，可以从左侧的源数据中选择一列，并将其映射到右侧实体上的新属性。 默认情况下，从左侧的源数据中选择列名称会自动填充实体属性的匹配名称，但如果希望实体属性的名称不同于源数据中的名称，则可以在右侧输入该属性的新名称。
定义以下属性映射：
如果 DisplayName 自动在右侧作为映射属性提供，请选择左侧的源列“Name”。
使 制造商 和 SerialNumber 保持未映射。
选择 “+ 添加实体属性” 以添加新属性。 选择 ID 作为左侧的源列，并将右侧的属性编辑为 DistillerId。
添加新实体属性。 选择 SiteId 作为左侧的源列，并将自动填充为属性的 SiteId 在右侧进行映射。
添加新实体属性。 选择 NumberOfTrays 作为左侧的源列，并将其自动填充为需要在右侧映射的属性 NumberOfTrays。
选中此框以确认应用这些属性后，属性将无法重命名或从实体中删除。
选择 “应用” 以保存属性。 然后选择“ 保存” 以保存映射。
转到“ 计划 ”选项卡以运行映射作业。 在映射作业的名称下，选择“ 立即运行”。
在“ 管理作 ”选项卡中检查映射作业的状态。等待状态显示 “已完成 ”，然后再继续下一部分（可能需要多次刷新内容）。
完成映射运行后，将创建实体实例，并使用非时序数据填充实体实例。
映射时序属性
接下来，映射一些时序数据。 对于 提取器 实体，需要添加时序数据表中的四个时序属性。 在添加之后，你将时序数据链接到在前一步中映射的实体实例。为此，请指定一个链接属性，该属性值必须与时序数据和非时序数据的值完全匹配。
返回到 “配置 ”视图，然后重新选择 “提取器 ”实体。 在 “实体配置 ”窗格中，重新打开 “映射 ”选项卡。
选择 “添加数据 ”，为时序数据创建新映射。
打开 Select Lakehouse 表 以选择映射的数据源。 在教程工作区中，选择 GettingStartedRawData lakehouse 和 timeseries 表。
（可选）等待数据预览加载。 选择 “选择要确认的数据源 ”。
接下来，选择“未应用筛选器”以将筛选器添加到您的源表映射中（请确保您仍在编辑新映射，而不是第一个映射）。 选择列 assetId、操作 包含和值 D （区分大小写）。 然后，选择应用。
按钮文本现在显示 应用了筛选器。
对于 属性类型，请选择 Timeseries 属性。
在 “映射属性”下，选择编辑图标。
如果 时间戳 作为要映射的属性自动在右侧提供，请选择 sourceTimestamp 作为左侧的源列。
使用 + 添加实体属性 从这些源列添加四个时序属性： RefluxRatio、 MainTowerPressure、 FeedFlowRate 和 FeedTrayTemperature。 保留右侧显示的默认匹配名称。
选中此框以确认应用这些属性后，属性将无法重命名或从实体中删除。
选择应用。
接下来，将时序数据链接到实体数据。 在 “链接与实体属性”下，选择“编辑”图标。 此过程要求从时序数据表中选择实体属性和匹配列。 从时序数据中选择的源列必须与映射到所选实体属性的数据 完全匹配 。 此过程可确保实体和时序数据的正确语境化。
对于 选择实体属性，请选择 “DistillerId”。 在 “从时间序列数据中选择列...”下，从时序数据中选择 assetId 列。
选择 “应用” 以保存并关闭模式。
请确保已启用 增量映射 ，然后选择“ 保存” 以保存映射作业。 当系统提示你保存增量映射时，请确认。
转到“ 计划 ”选项卡以运行映射作业。 找到新的映射作业（以 TimeSeries 结尾），然后选择“ 立即运行”。
接下来，为时间周期映射添加计划，以便自动刷新数据。 在这里，你将创建每五分钟运行一次的计划。
转到调度选项卡。在时序运行的名称下，打开计划流开关。 这将显示计划选择器。 展开下拉菜单，然后选择“ 创建流”。
对于 流名称， 请输入每 5 分钟一次。 选择 创建。
选择新的 “更新流计划 ”按钮以配置计划的运行详细信息。
在 每 5 分钟 设置中，配置以下选项：
- 计划运行：开启
- 重复： 按分钟
- 每5 分钟（秒）
- 开始日期和时间：选取今天的日期和时间。
- 结束日期和时间：选择从现在起 10 分钟后的时间。
- 时区：选取时区。
选择 “应用 ”并关闭计划配置。
可以看到实体配置窗格中反映的时间表。
现在， 提取器 的所有属性都已映射。 若要验证，请选择“ 属性 ”选项卡，并确认实体在语义画布中如下所示：
在“ 管理作 ”选项卡中检查时序映射的状态。等待状态显示 “已完成 ”，然后再继续下一部分（可能需要多次刷新内容）。
小窍门
如果看到映射作业的状态 为“失败 ”，请尝试重新运行它。 如果继续遇到问题，请参阅 “数字孪生生成器故障排除”（预览版）， 获取帮助。
现在 蒸馏器 实体及其映射已完成。
添加其他本体实体
创建 提取器 实体后，即可使用源数据中的剩余实体填充本体： 压缩器、 Reboiler、 Process、 Technology 和 MaintenanceRequest。 实体创建步骤类似于 提取器 实体的步骤，但每个实体类型的属性细节有所不同。
冷凝器
若要创建 压缩器 实体，请执行以下作：
在语义画布中，从功能区中选择 “添加实体”。 使用 “设备” 实体类型创建名为 “压缩器”的实体。
在新实体的 “映射 ”选项卡中，选择“ 添加数据”。 此实体有两个映射：一个非时间序列映射和一个时间序列映射。
创建以下映射。 请记住，所有源表都在教程工作区和 GettingStartedRawData lakehouse 中。
源表 过滤器（区分大小写） 属性类型 链接/唯一 ID 映射的属性 保存和运行笔记 assetdata 名称包含压缩器的条件 非时间性属性 唯一 ID： ID - 将 名称 映射为 DisplayName
- 保持 制造商 和 序列号 未映射
- 将 ID 映射为 CondenserId
- 将 SiteId 映射为 SiteId
- 将 CoolingMedium 映射为 CoolingMedium
- 将 InstallationDate 映射为 InstallationDate创建并保存映射后，转到 “计划 ”选项卡并运行它，然后在“ 管理作 ”选项卡中验证其完成情况。
在创建以下时间序列化映射之前，必须运行此非时间级映射。timeseries Where assetId 包含 C 时间序列属性 链接实体属性： CondenserId
链接时间序列列： assetId- 将 sourceTimestamp 映射为 时间戳 （必需，区分大小写）
- 将 压力 映射为 压力
- 将 Power 映射为 Power
- 将 InletTemperature 映射为 温度请确保已启用增量映射，然后保存映射。 转到“ 计划 ”选项卡并运行它。 当你完成 冷凝器的映射后，它应如下所示：
再沸器
创建 Reboiler 实体：
在语义画布中，从功能区中选择 “添加实体”。 使用 设备 实体类型创建名为 Reboiler 的实体。
在新实体的 “映射 ”选项卡中，选择“ 添加数据”。 此实体有两个映射：一个非时间序列映射和一个时间序列映射。
创建以下映射：
源表 过滤器（区分大小写） 属性类型 链接/唯一 ID 映射的属性 保存和运行笔记 assetdata 名称包含再沸器的地方 非时间性属性 唯一 ID： ID - 将 名称 映射为 DisplayName
- 保持 制造商 和 序列号 未映射
- 将 ID 映射为 ReboilerId
- 将 SiteId 映射为 SiteId创建并保存映射后，转到 “计划 ”选项卡并运行它，然后在“ 管理作 ”选项卡中验证其完成情况。
在创建以下时间序列化映射之前，必须运行此非时间级映射。timeseries assetId 包含 R 的条件下 时间序列属性 链接实体属性： ReboilerId
链接时间序列列： assetId- 将 sourceTimestamp 映射为 时间戳 （必需，区分大小写）
- 将 压力 映射为 压力
- 将 InletTemperature 映射为 InletTemperature
- 将 OutletTemperature 映射为 OutletTemperature请确保已启用增量映射，然后保存映射。 转到“ 计划 ”选项卡并运行它。 完成 再沸器 的映射后，它应如下所示：
流程
若要创建 Process 实体，请执行以下作：
在语义画布中，从功能区中选择 “添加实体”。 使用 Process 实体类型创建名为 Process 的实体。
在新实体的 “映射 ”选项卡中，选择“ 添加数据”。 此实体有一个非时间序列映射。
创建以下映射：
源表 过滤器（区分大小写） 属性类型 链接/唯一 ID 映射的属性 保存和运行笔记 processdata 没有 非时间性属性 唯一 ID： processId - 保留 DisplayName 和 类型 未映射
- 将 siteName 映射为 siteName
- 将 processId 映射为 processId
- 将 siteId 映射为 SiteId创建并保存映射后，转到 “计划 ”选项卡并运行它。 完成 流程映射后，此过程应如下所示：
技术人员
若要创建 技术员 实体，请执行以下步骤：
在语义画布中，从功能区中选择 “添加实体”。 使用 泛型 实体类型，创建名为 “技术员”的实体。
在新实体的 “映射 ”选项卡中，选择“ 添加数据”。 此实体有一个非时间序列映射。
创建以下映射：
源表 过滤器（区分大小写） 属性类型 链接/唯一 ID 映射的属性 保存和运行笔记 技术人员 没有 非时间性属性 唯一 ID： Id - 将 名称 映射为 DisplayName
- 将 电子邮件 映射为 电子邮件
- 将 ID 映射为 技术员 Id创建并保存映射后，转到 “计划 ”选项卡并运行它。 完成将技术人员进行映射后，结果应如下所示：
维护请求
创建 MaintenanceRequest 实体：
在语义画布中，从功能区中选择 “添加实体”。 使用 泛型 实体类型，创建名为 MaintenanceRequest 的实体。
在新实体的 “映射 ”选项卡中，选择“ 添加数据”。 此实体有一个非时间序列映射。
创建以下映射：
源表 过滤器（区分大小写） 属性类型 链接/唯一 ID 映射的属性 保存和运行笔记 维护请求 没有 非时间性属性 唯一标识：工单编号 - 使 DisplayName 属性保持未映射。
- 将 EquipmentId 映射为 EquipmentId
- 将 站点 映射为 SiteId
- 将 状态 映射为 状态
- 将 技术员 Id 映射为 技术员 Id
- 将 WorkorderId 映射为 WorkOrderId创建并保存映射后，转到 “计划 ”选项卡并运行它。 完成映射 MaintenanceRequest 后，它应如下所示：
现在，所有实体都已创建。 语义画布应包含以下六个实体： 提取器、 压缩器、 Reboiler、 Process、 技术员和维护 Request。
检查映射的状态
添加所有实体映射后，请检查映射作的状态以验证它们是否已成功完成。
选择管理操作按钮。
“管理操作”选项卡显示您的操作列表及其状态。 可以使用此页面了解所有映射操作是否已成功完成。
等待所有映射完成，再进入本教程的下一部分。
小窍门
如果看到映射作业的状态 为“失败 ”，请尝试重新运行它。 如果继续遇到问题，请参阅 “数字孪生生成器故障排除”（预览版）， 获取帮助。