在 Power Platform 数据流中使用本地数据网关

可安装本地数据网关,以便在 Power Platform 数据流与非云中数据源(如本地 SQL Server 数据库或本地 SharePoint 站点)之间快速、安全地传输数据。 可查看拥有管理权限的所有网关,并管理这些网关的权限和连接。

先决条件

Power BI 服务

  • Power BI Pro 许可证或 PPU 许可证。 没有帐户? 注册 60 天免费使用

  • 要创建查询本地数据源的数据流,需要满足以下条件之一:

    • 网关上的管理员权限。
    • 网关上的连接创建者权限。
    • 想要使用的数据源的网关连接已在你作为用户的网关上创建。

Power Apps

  • Power Apps 帐户。 没有帐户? 注册 30 天免费使用

  • 网关的管理权限。 默认情况下,会为安装的网关提供这些权限。 管理员可向其他人授予网关权限。

  • 一份支持使用本地网关访问本地数据的许可证。 详细信息:Power Apps 定价页面中“浏览 Power Apps 计划”表内的“连接到数据”行。

安装网关

可直接从联机服务安装本地数据网关。

注意

  • 其中一个推荐的常规做法是:确保使用的是受支持版本的本地数据网关。 我们每个月都会发布本地数据网关的新更新。 当前,Microsoft 仅主动支持本地数据网关的六个最新版本。
  • 从 2022 年 4 月开始,所需最低网关版本为 2021 年 2 月。 使用早期版本的网关刷新的数据流可能会停止刷新。

从 Power BI 服务安装网关

若要从 Power BI 服务安装网关:

  1. 选择 Power BI 服务右上角的“下载”按钮,然后选择数据网关

    图像,其中显示 Power Bi 服务中的数据网关选择。

  2. 使用安装本地数据网关中提供的说明来安装网关。

从 Power Apps 安装网关

若要从 Power Apps 安装网关:

  1. powerapps.com 的左侧导航窗格中,选择数据>网关

    左侧导航栏中的网关。

  2. 选择新建网关

    图像,其中显示 Power Apps 中的新网关按钮。

  3. 本地数据网关部分,选择下载

  4. 使用安装本地数据网关中提供的说明来安装网关。

在数据流中使用本地数据源

  1. 有关如何创建新数据流的说明,请转到从数据源创建数据流

  2. 从数据源列表选择本地数据源。

    选择本地数据源。

  3. 提供将用于访问本地数据的企业网关的连接详细信息。 必须选择网关自身,并为所选网关提供凭据。 只有你属于其管理员的网关才会出现在列表中。

    提供连接详细信息。

可更改用于给定数据流的企业网关,并使用数据流创作工具更改分配给所有查询的网关。

注意

数据流会尝试使用新网关查找或创建所需的数据源。 如果无法执行此操作,则在所选网关提供所有所需的数据流之前,将无法更改网关。

查看和管理网关权限

Power BI 服务网关权限

  1. 选择 Power BI 服务的右上角的设置按钮,选择管理网关,然后选择所需网关。

    图像,其中显示 Power BI 服务中的管理网关选择。

  2. 若要将用户添加到网关,请选择管理员表,然后输入要添加为管理员的用户的电子邮件地址。 在数据流中创建或修改数据源需具有网关的管理员权限。 管理员可完全控制网关,包括添加用户、设置权限、创建与所有可用数据源的连接以及删除网关。

将用户添加到网关时,以下条件适用:

  1. 如果我们检测到现有数据源可用于所选网关,则会预填充用户名密码字段。

    1. 如果此时选择下一步,则会视为使用该现有数据源,因此只需拥有该数据源的权限。

    2. 如果编辑任一凭据字段并选择下一步,则会视为编辑现有数据源,而此时需为网关的管理员。

  2. 如果未检测到现有数据源可用于所选网关,用户名密码字段将为空。与此同时,如果编辑凭据字段并选择下一步,则会视为在网关上创建新数据源,而此时需为网关的管理员。

如果仅拥有网关的数据源用户权限,则无法实现 1.b 和 2,且无法创建数据流。

Power Apps 网关权限

  1. powerapps.com 的左侧导航窗格中,选择网关,然后选择所需网关。

  2. 若要将用户添加到网关,请选择用户,指定用户或组,然后指定权限级别。 在数据流中使用网关创建新数据源需拥有网关的管理员权限。 管理员可完全控制网关,包括添加用户、设置权限、创建与所有可用数据源的连接以及删除网关。

查看和管理网关连接

Power BI 服务网关连接

  1. 选择 Power BI 服务的右上角的设置按钮,选择管理网关,然后选择所需网关。

  2. 执行所需操作:

    • 若要查看详细信息并编辑设置,请选择网关群集设置
    • 若要将用户添加为网关管理员,请选择管理员
    • 若要将数据源添加到网关,请选择添加数据源,输入数据源名称,然后在数据源设置下选择数据源类型,接着输入将使用数据源的人员的电子邮件地址。
    • 若要删除网关,请选择网关名称右侧的省略号,然后选择删除

Power Apps 网关连接

  1. powerapps.com 的左侧导航栏中,选择网关,然后选择所需网关。

  2. 执行所需操作:

    • 若要查看详细信息,请编辑设置或删除网关,选择连接,然后选择某一连接。

    • 若要共享连接,请选择共享,然后添加或删除用户。

      注意

      可仅共享某些类型的连接,如 SQL Server 连接。 有关详细信息,请参阅 Power Apps 中的共享画布应用

      有关如何管理连接的详细信息,请参阅在 Power Apps 中管理画布应用连接

限制

使用企业网关和数据流时存在一些已知限制。

  • 如果使用过时的数据网关,数据流刷新可能会失败。 从 2022 年 4 月开始,所需最低数据网关版本为 2021 年 2 月。

  • 每个数据流只能使用一个网关。 因此,应使用相同的网关配置所有查询。

  • 更改网关会影响整个数据流。

  • 如果需要多个网关,最佳做法是构建多个数据流(每个网关各一个)。 然后,使用计算或表引用功能来统一数据。

  • 数据流仅支持使用企业网关。 个人网关无法用于下拉列表和设置屏幕中的选择。

  • 只有具有管理员权限的人员才支持在数据流中使用网关来创建新数据源。

  • 具有可以使用可以使用 + 共享权限的用户可在创建数据流时使用现有连接。

  • 支持以下连接器:

疑难解答

尝试使用本地数据源来发布数据流时,可能会遇到以下 MashupException 错误:

AzureDataLakeStorage failed to get the response:
'The underlying connection was closed: An unexpected error occurred on a send.'

此错误通常是因为尝试通过代理连接到 Azure Data Lake Storage 终结点,但尚未正确配置本地数据网关的代理设置。 若要详细了解如何配置这些代理设置,请转到为本地数据网关配置代理设置

有关排查网关问题或为网络配置网关服务的详细信息,请转到本地数据网关文档

如果你使用的网关版本遇到问题,请尝试升级到最新版本,因为此问题可能已在最新版本中解决。 有关更新网关的详细信息,请转到更新本地数据网关

后续步骤