在 KQL 数据库中查看实体关系图(预览版)

在 Real-Time Intelligence 中,可以查看 KQL 数据库项的世系和关系。 该视图允许你直观地浏览数据库实体之间的关系,并帮助了解从源到目标的数据流,从而提供清晰的图形表示形式。 通过使用实体关系图,可以有效地管理数据库,并更深入地了解这些实体的交互方式。 实体的这种可视表示简化了数据库管理,并有助于优化数据结构,从而更轻松地跟踪依赖项并快速采取措施。

有关 Fabric 中工作区世系的信息,请参阅 世系

重要

此功能目前为预览版

先决条件

对于想要打开数据摄取详细信息的用户:

  • 拥有数据库管理员或数据库监视器权限即可在实体关系图中查看摄入详细信息。 有关详细信息,请参阅基于角色的访问控制

打开实体关系图视图

若要访问视图,请浏览到所需的 KQL 数据库并选择 “实体图”。

显示实体关系图视图按钮的屏幕截图。

实体关系图视图中可以看到什么?

打开实体关系图视图时,可以看到 KQL 数据库中所有项之间的依赖关系。

显示 KQL 数据库中的实体关系图视图的屏幕截图。

实体关系图视图显示以下信息:

可以选择一个项以查看其与数据库中其他项的关系。 实体图突出显示与该项相关的所有项,并将其余项变暗。

查看引入详细信息

还可以查看每个表和物化视图的引入详细信息。 若要查看引入详细信息,请在功能区右侧选择 引入 ,然后选择所需的时间范围。 信息将添加到相关实体的卡片中。

实体关系图的屏幕截图,其中显示了引入详细信息视图。

查看事件流引入的详细信息

还可以查看源自 Eventstream 的每个表的引入详细信息。

实体图的屏幕截图,其中显示了从事件流详细信息视图中导入的数据。

除了事件流的名称之外,还可以通过选择绿色流图标来查看其他信息,该图标显示 派生流 的名称和 引入映射的名称。 如果未显示任何映射,则使用 默认的(标识)映射“显示详细信息”下启用引入详细信息时,你将看到从所有源(包括 Eventstreams)引入到每个表中的记录数。

实体图的屏幕截图,其中显示了单击绿色图标后显示的详细信息。

注释

实体关系图视图中仅显示事件流作为外部源。 实体关系图中不显示其他外部源。

模式违规

架构冲突有助于识别数据库实体之间的不一致或损坏的引用。 下面是架构冲突的一些示例:

  • 函数引用不再存在的表或列。
  • 函数引用不再存在的另一个函数。
  • 函数引用的另一个函数参数数量或类型不正确。
  • 函数引用其数据类型已更改的列。
  • 更新策略引用不再存在的函数或源表。
  • 更新策略引用其输出架构与目标表架构不匹配的函数。
  • 无效的引入映射(例如映射中定义的一个或多个列)不存在于目标表中。
  • 连续导出无效(例如找不到引用的表或列)。
  • 无法访问外部表,因为存储位置可能不存在,或者没有足够的权限访问它。

注释

在架构冲突功能中,快捷方式称为“外部表”。

启用“架构违规”显示功能以直接在图中突出显示受影响的实体。 单击“架构冲突”实例会打开一个侧窗格,其中包含有关冲突的详细信息。

使用此功能可以快速查找和解决损坏的依赖项,确保 Eventhouse 数据库保持一致且可靠。

实体图的屏幕截图,其中用红色突出显示了架构违规。

可以针对哪些方案使用实体关系图?

本部分探讨可在 KQL 数据库中使用实体关系图视图的各种方案:

主动管理依赖项

使用世系管理实体(如表和函数)之间的依赖关系变得非常简单。 例如,如果重命名表或更改其架构,则可以立即标识哪些函数在其 KQL 查询中依赖于该表。 这种主动方法有助于避免意外问题,并确保无缝更新数据库结构。

跟踪具体化视图和源表之间的关系

实体关系图允许跟踪具体化视图与其基础源表之间的关系。 这使你能够更轻松地识别原始数据源,从而更有效地跟踪和排查数据流问题。

与元素交互并采取行动

可以选择图形中的任何元素来突出显示其相关项,而图形的其余部分则灰显,以便更轻松地专注于特定关系。 对于表和外部表,在省略号 [...]中,可以选择其他选项,例如查询表、基于表创建 Power BI 报表等。

实体关系图表的屏幕截图,其中显示了更多菜单。

跟踪记录引入

通过实体关系图,可以跟踪每个表和具体化视图中引入的记录数。 这种清晰的数据流视图有助于您实时掌握数据导入的大小和数量,确保您的数据库正确处理数据。