Подключение к локальным источникам данных из Azure Logic Apps с помощью локального шлюза данных

  • Статья

Область применения: Azure Logic Apps (Потребление + Стандартный)

Иногда рабочий процесс должен подключаться к локальному источнику данных и использовать только соединители, обеспечивающие этот доступ через локальный шлюз данных. Чтобы настроить локальный шлюз данных, необходимо выполнить следующие задачи: установите локальный локальный шлюз данных и создайте локальный ресурс шлюза данных в Azure для локального шлюза данных. При добавлении триггера или действия в рабочий процесс из соединителя, требующего шлюза данных, можно выбрать ресурс шлюза данных для использования с подключением.

В рабочих процессах приложения логики потребления можно подключаться к локальным источникам данных с помощью только соединителей, которые предоставляют доступ через локальный шлюз данных. В рабочих процессах приложения логики уровня "Стандартный" вы можете напрямую обращаться к локальным ресурсам в виртуальных сетях Azure или использовать встроенные соединители поставщика услуг, которые не нуждаются в шлюзе данных для доступа к локальному источнику данных. Вместо этого вы предоставляете информацию, которая проходит проверку подлинности удостоверения и разрешает доступ к источнику данных. Однако если встроенный соединитель поставщика услуг недоступен для источника данных, но управляемый соединитель доступен, необходимо использовать локальный шлюз данных.

В этом руководстве показано, как создать ресурс шлюза данных Azure после установки локального шлюза на локальном компьютере.

Дополнительные сведения см. в следующей документации:

Сведения об использовании шлюза с другими службами см. в следующей документации:

Поддерживаемые источники данных

В Azure Logic Apps локальный шлюз данных поддерживает локальные соединители для следующих источников данных:

Вы также можете создать настраиваемые соединители для подключения к источникам данных по протоколам HTTP или HTTPS с помощью REST или SOAP. Хотя сам шлюз не несет дополнительных затрат, модель ценообразования Azure Logic Apps применяется к соединителям и другим операциям Azure Logic Apps.

Ограничения

Azure Logic Apps поддерживает операции чтения и записи через шлюз данных, но эти операции имеют ограничения на их размер полезных данных.

Необходимые компоненты

  • Вы уже установили локальный шлюз данных на локальном компьютере. Эта установка шлюза данных должна существовать, прежде чем можно создать ресурс шлюза данных, который связывается с этой установкой. На локальный компьютер можно установить только один шлюз данных.

  • Следует использовать ту же учетную запись и подписку 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. В списке шлюзов Подключение ion выберите ресурс шлюза, который требуется использовать. В этом списке показаны доступные ресурсы шлюза в выбранной подписке. Каждый ресурс шлюза связан с одним установленным шлюзом.

      Примечание.

      Список шлюзов Подключение ion включает ресурсы шлюза в других регионах, так как расположение ресурса приложения логики может отличаться от расположения ресурса шлюза.

    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 шлюза для установленного шлюза.

Чтобы найти все подключения API, связанные с подпиской Azure, используйте один из следующих вариантов:

  • В поле поиска портал 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. Чтобы отменить связь с установкой шлюза из другого ресурса шлюза, см. статью "Удалить ресурс шлюза".

Вопрос. Почему расположение для существующего шлюза изменилось?
Ответ. Ресурсы шлюза, созданные до 3 мая 2017 года, были перемещены в исходные расположения клиента Microsoft Entra для рабочей или учебной учетной записи, которая создала эти шлюзы. Однако эти изменения не влияют на выполняющиеся сейчас приложения логики, которые должны работать в обычном режиме. После выпуска общедоступной версии шлюза в мае расположения ресурсов шлюза могут отличаться от расположений приложений логики.

Следующие шаги