管理实体类型和映射

2025-07-02

数字孪生生成器（预览版）中的映射功能允许用户开始使用语义丰富的实体类型创建本体，并将其与来自各种源系统的数据填充。有关数字孪生生成器中映射功能的概念信息，请参阅将数据映射到数字孪生生成器中的实体类型（预览版）。映射数据后，可以通过执行语境化来完成本体结构。

重要

此功能目前为预览版。

本文档介绍如何在数字孪生生成器中创建实体类型和管理其数据映射（预览版）。

先决条件

具有支持 Microsoft Fabric 的容量的工作区。
您希望获得的数据已在 Fabric lakehouse 中完成了必要的 ETL 处理。
- 时序数据应采用 列格式 。列式时序数据是结构化的，以便每个列表示不同的变量或属性，而每一行对应于特定的时间戳。
- 数字孪生生成器支持具有以下数据类型的源列：bigint、boolean、char、date、datetime、decimal、double、float、integer、long、short、smallint、string、timestamp、timestampint64、tinyint。
数字孪生生成器（预览）项。

创建实体类型

在数字孪生生成器的语义画布中选择“添加实体”（预览版）。
选择系统类型，或选择 “通用 ”以创建自定义实体类型。然后，为实体类型选择一个名称。命名空间中的每个实体类型都必须具有唯一的名称。

注释

实体类型名称必须为 1-26 个字符，仅包含字母数字字符、连字符和下划线，以字母数字字符开头和结尾。
在语义画布上查看空实体类型。

将非时序数据映射到实体类型

首先，映射非时序数据。非时序映射必须在时序映射之前运行。

在“ 实体 ”窗格中选择实体类型后，可以看到实体类型的 “实体配置 ”窗格。选择“ 映射 ”选项卡，然后选择“ 添加数据”。
从 OneLake 中选择一个湖仓表，以用作映射的源表。选择 “选择数据源”。
在“源表”旁边的“新建映射”中，选择“未应用筛选器”以向源表添加筛选器。

填写用于创建条件的选项，例如 “名称 > 包含 > 坦克 ”，以仅筛选名称包含坦克的行。筛选器区分大小写。

选择应用。
选择源数据 的属性类型 。每次映射只能选择一种属性类型。例如，假设 contoso_sample_data 包含有关坦克的描述性属性。该数据的映射包含 非时序 属性。
为每个引入数据记录配置 唯一 ID 。可以为唯一 ID 选择一个或多个列，但建议至少选择一组列。
对于映射属性，请配置源表中的列，以便对您希望在实体类型中进行建模的元素进行设置。

请注意以下事项：
- （可选）可以将源数据表中的列映射到 DisplayName 属性。此步骤为下游体验中的每个实体实例提供友好名称。
- （可选）您可以选择为您的源列指定一个新名称，以便在对实体实例进行建模时显示。
  
  注释
  
  自定义列名必须为 1-26 个字符，仅包含字母数字字符、连字符和下划线，以字母数字字符开头和结尾。
- 选择源列时，选项列表分为两个部分：可用和不可用。可用列是源表中与要匹配的属性的数据类型匹配的列。不可用的列是那些与类型不匹配的列，因此无法映射到该属性。
选择 “保存” 以保存非时序映射。
转到“ 计划 ”选项卡，然后选择“ 立即运行 ”以运行映射。运行映射模型将标识的属性应用到您的实体实例上。 对属性进行建模后，将无法删除它们，并且无法更改其名称。

将时序数据映射到实体类型

重要

将时序数据映射到实体类型之前，请确保非时序映射已成功运行。

此外，请确保将一个非时序属性映射到实体类型上，以便为时序数据提供上下文。此非时序属性应与时序数据中的列完全匹配。

在实体配置窗格中选择“ 映射 ”选项卡，然后选择“ 添加数据 ”开始创建映射。
从 OneLake 中选择一个湖仓表，以用作映射的源表。
对于此映射的属性类型，请选择 时序属性。
配置 映射属性。

时序数据应采用 lakehouse 数据源中的列式格式，其中每个列表示不同的变量或属性，并且每行对应于特定的时间戳。 此映射需要类型的 DateTime 时间戳列。
通过在您的时序数据中选择与实体类型中定义的属性类型完全匹配的列，来配置‘与实体属性关联’。此过程允许数字孪生生成器（预览版）将时序数据与现有实体实例进行上下文关联。

小窍门

如果未看到可用的非时序属性，请确保先映射非时序属性，然后再返回到此步骤。
确保已启用 增量映射 。启用具有增量映射的时序映射后，无法编辑该映射。

小窍门

如果需要修改增量映射，请改为创建新的映射。如果目标是删除属性，请删除现有映射，然后创建新的映射。如果目标是添加属性，只需创建一个具有相同源和新属性的额外映射。
选择 “保存” 以保存时序映射。
转到“ 计划 ”选项卡，然后选择“ 立即运行 ”以运行映射。

管理映射

这里是可用于映射管理的操作。

视图映射：选择该实体类型时，可以在实体配置窗格中的 “映射 ”选项卡下查看为特定实体类型创建的所有映射。还可以通过从功能区中选择 “管理操作”，在数字孪生生成器（预览）中查看流视图中的它们。
编辑映射：若要编辑映射，请修改实体配置窗格中配置的任何部分。验证所有配置以避免意外的结果并保存更改。

注释

实体类型名称和属性名称不可编辑。但是，可以从映射中删除源列。
删除映射：若要删除映射，请选择所需映射卡片右上角的回收站图标。删除此映射不会删除使用该作业映射的基础数据，也不会从实体类型中删除任何属性，而是从语义画布中删除映射。
计划映射：若要计划映射，请转到 “计划 ”选项卡并创建数字孪生生成器流。启用 计划流、创建新流并配置其详细信息。有关详细信息，请参阅数字孪生生成器（预览版）流。