Microsoft Fabric：引入行

使用 Microsoft Fabric：引入行，通过 Fabric 引入 API，从旅程步骤将一行数据流式传输到 Eventhouse (KQL) 表中。与其他需要自带令牌的集成点不同，此集成点通过为整个账户一次性连接的 Entra ID 应用程序进行身份验证。该点本身没有令牌字段。

典型用途：

开始之前

在 设置 > 第三方集成 > Microsoft Azure 下连接一个 Entra ID 应用程序：

连接 Azure 后，安装集成，以便该点出现在旅程构建器中。

在 Eventhouse 端也需要准备好三件事，否则请求将失败：

目标表需要一个 JSON 引入映射——没有它，JSON 的流式引入将无法工作。
应用程序注册需要在 Eventhouse 上具有 ingestor 角色。Fabric UI 中没有此按钮——通过在 Eventhouse 的查询窗口中运行以下命令来授予它：

.add database ['<database name>'] ingestors ('aadapp=<Application (client) ID>;<Directory (tenant) ID>')

.alter database ['<database name>'] policy streamingingestion enable

如果数据库名称包含连字符，请在这些命令中保留 ['...'] ——一个裸露的带连字符的名称将无法解析。

将 Microsoft Fabric：引入行 从左侧面板的集成部分拖到画布上。
双击该点并输入 步骤名称。
在 查询 URI 主机 中，输入您的 Eventhouse 的主机，该主机位于 Eventhouse 的 系统概览 页面上的 查询 URI 中。不要包含 https://，例如 trd-abc123.z9.kusto.fabric.microsoft.com。

在列中，为要写入的每个 Eventhouse 列添加一行。输入列名和值。名称必须非空且唯一。值可以是固定文本或旅行者宏，例如 {{tag:Name}}，与 Webhook 主体中的宏相同。或者点击 插入动态值 来选择此旅程中先前步骤产生的属性，例如 LLM 响应或映射的 Webhook 值。

旅行者将继续前往您在画布上连接的下一个步骤。

此点不会将任何响应数据映射回旅程中。

在该点的抽屉中打开调用日志并检查响应：

401 或 403 — 连接的 Entra ID 应用程序的凭据或其 ingestor 角色错误或缺失。
520 并显示 StreamingIngestionException: Failed to initialize cursor tracker... — KQL 数据库的流式引入策略未启用。错误本身的 permanent: false 标志解读为“稍后重试”，但重试无法解决此问题。在 Eventhouse 的查询窗口中运行 .alter database ['<database name>'] policy streamingingestion enable（参见开始之前）。

失败的请求会将旅行者从旅程中移除。请参阅错误和失败的请求。

一个团队希望获得一个实时仪表板，显示活跃旅程中达到的每个步骤，而无需等待批量导出。

在您想要跟踪的步骤之后立即添加 Microsoft Fabric：引入行。将 KQL 数据库 设置为 am-test，表设置为 Events，引入映射 设置为 EventsJsonMapping。在列中，将 device_id 设置为 {{device:hwid}}。
点击保存。