在 Fabric 实时中心获取 OneLake 事件

2025-05-19

本文介绍如何在 Fabric 实时中心将 OneLake 事件作为事件流获取。

Real-Time Hub 允许你发现并订阅 OneLake 中文件和文件夹的更改，从而可以实时对这些更改做出反应。例如，您可以对 Lakehouse 中的文件和文件夹变动做出反应，并利用 Activator 的警报功能根据条件设置警报，同时指定在满足条件时要执行的操作。本文介绍如何在实时中心浏览 OneLake 事件。

使用 Fabric 事件流，可以捕获这些 OneLake 事件、转换事件并将其路由到 Fabric 中的各种目标，以便进一步分析。在 Fabric 事件流中无缝集成 OneLake 事件可让你更灵活地监视和分析 OneLake 中的活动。

事件类型

以下是支持的 OneLake 事件：

事件类型名称	描述
Microsoft.Fabric.OneLake.FileCreated	在 OneLake 中创建或替换文件时触发。
Microsoft。 Fabric.OneLake.文件已删除	在 OneLake 中删除文件时引发。
Microsoft。 Fabric.OneLake.文件已重命名	在 OneLake 中重命名文件时引发。
Microsoft.Fabric.OneLake.FolderCreated	在 OneLake 中创建文件夹时引发。
Microsoft。 Fabric.OneLake.文件夹已删除	在 OneLake 中删除文件夹时引发。
Microsoft。 Fabric.OneLake.文件夹重命名	在 OneLake 中重命名文件夹时引发。

有关详细信息，请参阅探索 OneLake 事件。

注意事项

如果事件流或激活器的容量区域位于以下区域，则不支持通过 Eventstream 或 Fabric 激活器使用 Fabric 和 Azure 事件：印度西部、以色列中部、韩国中部、卡塔尔中部、新加坡、阿联酋中部、西班牙中部、巴西东南部、美国中部、美国中南部、美国西部 2、美国西部 3。

先决条件

使用参与者或更高权限在 Fabric 容量许可证模式（或）试用许可证模式下访问工作区。
对数据源的 SubscribeOneLakeEvent 权限。

为 OneLake 事件创建流

可以在 Real-Time 中心为 OneLake 事件创建数据流，使用以下方法之一：

使用“数据源”页
使用“Fabric 事件”页面

“数据源”页

登录 Microsoft Fabric。
如果页面左下角显示了“Power BI”，请依次选择“Power BI”、“Fabric”切换到“Fabric”工作负载。
选择左侧导航栏上的“实时”。
在“实时中心”页上，选择左侧导航菜单上“连接到”下的“+ 数据源”。

还可以从 所有数据流 或 “我的数据流” 页访问 数据源 页，方法是选择右上角的“+ 连接数据源”按钮。

在“数据源”页上，选择顶部的“OneLake 事件”类别，然后在“OneLake 事件”磁贴上选择“连接”。还可以使用搜索栏搜索 OneLake 事件。

现在，使用“配置和创建事件流”部分中的说明。

“Fabric 事件”页

在实时中心，选择左侧菜单中的“Fabric 事件”。可以使用 Fabric 事件的列表视图或 OneLake 事件的详细信息视图为 OneLake 事件创建事件流。

使用列表视图

将鼠标指针悬停在“OneLake 事件”上，选择“创建事件流”链接或选择“...”（省略号），然后选择“创建事件流”。

使用详细信息视图

在“Fabric 事件”页上，从支持的 Fabric 事件列表中选择“OneLake 事件”。
在 详细信息 页上，从菜单中选择 + 创建事件流。

现在，请参照配置和创建事件流部分的说明，跳过使用 添加源 页的第一步。

配置和创建事件流

在 Connect 页上，对于 事件类型，请选择要监视的事件类型。
此步骤是可选的。若要查看事件类型的架构，请选择 查看所选事件类型架构。如果选择它，请浏览事件的架构，然后通过选择顶部的向后箭头按钮导航回上一页。
在“为事件选择数据源”下选择“添加 OneLake 源”。
在“选择要连接的数据”页面上：
1. 使用顶部的类别按钮查看所有可用的数据源或仅查看数据源（我的数据）或你喜欢的数据源。可以使用“按关键字筛选”文本框来搜索特定源。还可以使用“筛选器”按钮根据资源类型（KQL 数据库、Lakehouse、SQL 数据库、仓库）进行筛选。以下示例使用“我的数据”选项。
2. 从列表中选择数据源。
3. 选择页面底部的“下一步”。
选择你感兴趣的所有表或特定表，然后选择添加。

注意事项

OneLake 事件支持 OneLake 中的数据。但尚无法通过快捷方式针对 OneLake 中的数据应用事件。
现在，在 配置连接设置 页上，可以通过选择要监视的字段和警报值来添加筛选器来设置筛选条件。添加筛选器：
1. 选择 + 筛选。
2. 选择一个字段。
3. 选择一个运算符。
4. 选择要匹配的一个或多个值。
在右侧的“流详细信息”部分，执行以下步骤。
1. 选择要在其中保存事件流的 工作区。
2. 为事件流输入一个名称。 流名称会自动为你生成。
然后，选择页面底部的“下一步”。
在“查看 + 连接”页上，查看设置，然后选择“连接”。
当向导成功创建流时，请使用 Open eventstream 链接打开已为你创建的事件流。选择“完成”关闭向导。