你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

从 Azure 逻辑应用连接到本地数据源

适用范围:Azure 逻辑应用(消耗型 + 标准型)

有时,工作流必须连接到本地数据源,并且只能使用通过本地数据网关提供此访问权限的连接器。 若要设置此本地数据网关,必须完成以下任务:安装本地本地数据网关并在 Azure 中为本地数据网关创建本地数据网关资源。 从需要数据网关的连接器向工作流添加触发器或操作时,可以选择要用于连接的数据网关资源。

在消耗逻辑应用工作流中,只能使用通过 本地数据网关提供访问权限的连接器连接到本地数据源。 在标准逻辑应用工作流中,可以直接访问 Azure 虚拟网络中的本地资源,或使用 不需要数据网关访问本地数据源的内置服务提供商连接器 。 而你要提供用于验证身份并授权对数据源的访问的信息。 但是,如果内置服务提供商连接器不适用于数据源,但托管连接器可用,则需要使用本地数据网关。

本指南演示如何在本地计算机上安装本地网关后创建 Azure 数据网关资源。

有关详细信息,请参阅以下文档:

有关如何将网关用于其他服务的信息,请参阅以下文档:

支持的数据源

在Azure 逻辑应用中,本地数据网关支持以下数据源的本地连接器

也可以创建自定义连接器,以便使用 REST 或 SOAP 通过 HTTP 或 HTTPS 连接到数据源。 虽然网关本身不额外收费,但 Azure 逻辑应用定价模型适用于连接器以及其他 Azure 逻辑应用操作。

限制

Azure 逻辑应用支持通过数据网关执行读取和写入操作,但这些操作存在有效负载大小限制

先决条件

  • 已经在本地计算机上安装本地数据网关。 必须先存在此数据网关安装,然后才能创建链接到此安装的数据网关资源。 在每台本地计算机上只能安装一个数据网关。

  • 使用用于网关安装的同一 Azure 帐户和订阅。 此 Azure 帐户必须仅属于单个 Microsoft Entra 租户或目录。 必须使用同一 Azure 帐户和订阅在 Azure 中创建网关资源,因为只有网关管理员才能在 Azure 中创建网关资源。 当前不支持服务主体。

    • 在 Azure 中创建数据网关资源时,选择数据网关安装以与网关资源链接,并仅链接到该网关资源。 每个网关资源只能链接到一个网关安装。 不能选择已与另一个网关资源关联的网关安装。

    • 逻辑应用资源和网关资源不必存在于同一 Azure 订阅中。 在使用网关资源的触发器和操作中,可以选择具有网关资源的其他 Azure 订阅,但前提是该订阅与逻辑应用资源位于同一 Microsoft Entra 租户或目录中。 此外,你还必须拥有对网关的管理员权限,其他管理员可以为你设置该权限。 有关详细信息,请参阅数据网关:使用 PowerShell 自动化操作 - 第 1 部分PowerShell:数据网关 - Add-DataGatewayClusterUser

      注意

      目前,不能跨多个订阅共享数据网关资源或安装。 若要提交产品反馈,请参阅 Microsoft Azure 反馈论坛

创建 Azure 网关资源

在本地计算机上安装数据网关后,为数据网关创建 Azure 资源。

  1. 使用安装网关时所使用的 Azure 帐户登录到 Azure 门户

  2. 在 Azure 门户搜索框中输入“本地数据网关”,然后选择“本地数据网关”。

    Screenshot shows Azure portal search box with the words, on-premises data gateway. The results list shows the selected option, On-premises data gateways.

  3. 在“本地数据网关”下,选择“创建”。

    Screenshot shows the page for On-premises data gateways with the selected option for Create.

  4. 在“创建网关”下,提供网关资源的以下信息。 完成操作后,选择“查看 + 创建”。

    属性 说明
    订阅 选择用于网关安装的 Azure 帐户的 Azure 订阅。 默认订阅取决于用来登录的 Azure 帐户。
    资源组 选择要使用的 Azure 资源组
    名称 输入网关资源的名称,其中只包含字母、数字、连字符 (-)、下划线 (_)、括号(())或句点 (.)。
    区域 选择在网关安装期间为网关云服务选择的区域或位置。 否则,网关安装不会显示在“安装名称”列表中。 逻辑应用资源位置可以不同于网关资源位置。
    安装名称 选择一个网关安装,该安装仅在以下条件满足的情况下显示在列表中:

    - 网关安装使用的区域与要创建的网关资源所在的区域相同。
    - 网关安装未关联到另一 Azure 网关资源。
    - 网关安装关联到要用来创建网关资源的 Azure 帐户。
    - Azure 帐户属于单个 Microsoft Entra 租户或目录 ,并且与用于网关安装的帐户相同。

    有关详细信息,请参阅常见问题解答

    以下示例显示了与网关资源位于同一区域并已链接到同一 Azure 帐户的网关安装:

    Screenshot shows the page for Create a gateway. The Name, Region, and other boxes contain values. The button, Review + create, appears selected.

  5. 在出现的验证页面上,确认你提供的所有信息,并选择“创建”。

连接到本地数据

创建网关资源并将 Azure 订阅与此资源相关联后,可以使用该网关在逻辑应用工作流与本地数据源之间创建连接。

  1. 在 Azure 门户上的设计器中,创建或打开逻辑应用工作流。

  2. 从支持通过数据网关进行本地连接的连接器添加触发器或操作。

    注意

    在消耗逻辑应用工作流中,如果连接器既有托管版本也有内置版本,请使用包含网关选择功能的托管版本。 在标准逻辑应用工作流中,连接到本地数据源的内置连接器不需要使用网关。

  3. 对于触发器或操作,请提供以下信息:

    1. 如果存在通过本地数据网关进行连接的选项,请选择该选项。

    2. 在“网关”下,从“订阅”列表中选择包含你的网关资源的 Azure 订阅。

      逻辑应用资源和网关资源不必存在于同一 Azure 订阅中。 可以选择包含网关资源的其他每个 Azure 订阅,但前提是:

      • 这些订阅与逻辑应用资源位于同一个 Microsoft Entra 租户或目录中。
      • 你拥有对网关的管理员权限,其他管理员可为你设置该权限。

      有关详细信息,请参阅数据网关:使用 PowerShell 自动化操作 - 第 1 部分PowerShell:数据网关 - Add-DataGatewayClusterUser

    3. 从“连接网关”列表中选择要使用的网关资源。 此列表显示所选订阅中的可用网关资源。 每个网关资源关联到单个网关安装。

      注意

      “连接网关”列表包含其他区域的网关资源,因为逻辑应用资源的位置可能不同于网关资源的位置。

    4. 提供唯一的连接名称和其他所需信息,具体取决于要创建的连接。

      唯一的连接名称有助于在以后轻松查找该连接,尤其是在创建多个连接的情况下。 另请包括用户名的限定域(如果适用)。

      以下消耗工作流示例显示了 SQL Server 连接的示例信息:

      Screenshot of a SQL Server connector. The 'Subscription,' 'Connection Gateway,' 'Connection name,' and other boxes have values.

  4. 完成操作后,选择“创建”。

网关连接现已准备就绪,可供逻辑应用工作流使用。

编辑连接

若要更新网关连接的设置,可以编辑连接。 本部分继续使用消耗工作流作为示例。

  1. 若要查找你的逻辑应用资源的所有 API 连接,请在逻辑应用菜单中的“开发工具”下,选择“API 连接”。

    Screenshot of a logic app resource in the Azure portal. On the logic app navigation menu, 'API connections' is highlighted.

  2. 选择要编辑的网关连接,然后选择“编辑 API 连接”。

    提示

    如果更新未生效,请尝试针对网关安装停止网关 Windows 服务帐户,然后重启该帐户

若要查找与 Azure 订阅关联的所有 API 连接,请使用以下选项之一:

  • 在Azure 门户搜索框中,输入 API 连接,然后选择 API 连接。
  • 从 Azure 门户菜单中,选择“所有资源”。 将“类型”筛选器设置为“API 连接”。

删除网关资源

若要创建其他网关资源、将网关安装与其他网关资源相关联,或者移除网关资源,则可删除网关资源,不影响网关安装。

  1. 在 Azure 门户中打开你的网关资源。

  2. 在网关资源工具栏上,选择“删除”。

    Screenshot shows on-premises data gateway resource in the Azure portal. On the toolbar, Delete is selected.

常见问题

:在 Azure 中创建我的网关资源时,为何不显示我的网关安装?
:此问题的可能原因如下:

  • 你的 Azure 帐户不是在本地计算机上进行网关安装所使用的帐户。 请检查是否使用了网关安装所使用的身份登录到 Azure 门户。 只有网关管理员才能在 Azure 中创建网关资源。 当前不支持服务主体。

  • Azure 帐户不属于单个 Microsoft Entra 租户或目录。 检查你使用的是在网关安装过程中使用的同一个 Microsoft Entra 租户或目录。

  • 网关资源和网关安装不在同一区域中。 在 Azure 中,请确保网关安装使用的区域与要在其中创建网关资源的区域相同。 但是,逻辑应用资源的位置可以不同于网关资源的位置。

  • 网关安装已关联到其他网关资源。 每个网关资源只能链接到一个网关安装,且后者只能链接到一个 Azure 帐户和订阅。 因此,不能选择已与另一个网关资源关联的网关安装。 这些安装不会显示在“安装名称”列表中。

    若要在 Azure 门户中查看网关注册,请找到所有 Azure 订阅中“本地数据网关”资源类型的所有 Azure 资源。 若要取消网关安装与其他网关资源的链接,请参阅删除网关资源

:我的现有网关的位置为何发生了更改?
:在 2017 年 5 月 3 日之前创建的网关资源已移动到创建这些网关的工作或学校帐户的 Microsoft Entra 租户的原始位置。 但是,这些更改应当不会影响当前正在运行的逻辑应用,这些应用应当继续照常运行。 随着该网关在五月份的正式发布,网关资源的位置可能不同于逻辑应用位置。

后续步骤