Подключение к базе данных SQL из рабочих процессов в Azure Logic Apps

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

В этом руководстве показано, как получить доступ к базе данных SQL из рабочего процесса в Azure Logic Apps с помощью соединителя SQL Server. Затем можно создать автоматизированные рабочие процессы, которые выполняются при активации событий в базе данных SQL или в других системах, а также выполнять действия для управления данными и ресурсами SQL.

Например, рабочий процесс может выполнять действия, которые получают, вставлять и удалять данные или могут выполнять запросы SQL и хранимые процедуры. Рабочий процесс может проверка для новых записей в базе данных, отличных от SQL, выполнять некоторые операции обработки, использовать результаты для создания новых записей в базе данных SQL и отправки оповещений электронной почты о новых записях.

Если вы не знакомы с Azure Logic Apps, ознакомьтесь со следующей документацией по началу работы:

Поддерживаемые выпуски SQL

Соединитель SQL Server поддерживает следующие выпуски SQL:

технический справочник по Подключение or

Соединитель SQL Server имеет разные версии, основанные на типе приложения логики и среде узла.

Приложение логики Среда Версия соединителя
Потребление Мультитенантные Azure Logic Apps Управляемый соединитель, который отображается в конструкторе под меткой "Стандартный". Дополнительные сведения см. в следующей документации:

- Справочник по управляемому соединителю SQL Server
- Управляемые соединители в Azure Logic Apps
Потребление Среда службы интеграции (ISE) Управляемый соединитель, который отображается в конструкторе под меткой "Стандартный " и версией ISE, которая имеет разные ограничения сообщений, отличные от класса Standard. Дополнительные сведения см. в следующей документации:

- Справочник по управляемому соединителю SQL Server
- Ограничения для сообщений ISE
- Управляемые соединители в Azure Logic Apps
Стандартные Azure Logic Apps с одним клиентом и Среда службы приложений версии 3 (только планы Windows) Управляемый соединитель, который отображается в коллекции соединителей в разделе "Общая среда выполнения" и встроенный соединитель, который отображается в коллекции соединителей в разделе "Среда выполнения>>в приложении" и является поставщиком услуг. Встроенный соединитель отличается следующим образом:

— Встроенный соединитель может напрямую подключаться к базе данных SQL и получать доступ к виртуальным сетям Azure с помощью строка подключения без локального шлюза данных.

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

- Справочник по управляемому соединителю SQL Server
- Справочник по встроенному соединителю SQL Server
- Встроенные соединители в Azure Logic Apps

Ограничения

Дополнительные сведения см. в справочнике по управляемому соединителю SQL Server или встроенному соединителю SQL Server.

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

  • Учетная запись и подписка Azure. Если у вас нет ее, вы можете зарегистрироваться для получения бесплатной учетной записи Azure.

  • База данных SQL Server, База данных SQL Azure или Управляемый экземпляр SQL.

    Соединитель SQL Server требует, чтобы таблицы содержали данные, чтобы операции соединителя могли возвращать результаты при вызове. Например, если вы используете База данных SQL Azure, можно использовать включенные примеры баз данных, чтобы попробовать операции соединителя SQL Server.

  • Сведения, необходимые для создания подключения к базе данных SQL, например имя сервера SQL и базы данных. Если вы используете проверку подлинности Windows или проверку подлинности SQL Server для проверки подлинности, вам также потребуется имя пользователя и пароль. Обычно эти сведения можно найти в строка подключения.

    Важно!

    Если вы используете строка подключения SQL Server, скопированные непосредственно из портал Azure, необходимо вручную добавить пароль в строка подключения.

    • Для базы данных SQL в Azure строка подключения имеет следующий формат:

      Server=tcp:{your-server-name}.database.windows.net,1433;Initial Catalog={your-database-name};Persist Security Info=False;User ID={your-user-name};Password={your-password};MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;

      1. Чтобы найти эту строку в портал Azure, откройте базу данных.

      2. В меню базы данных в разделе "Свойства" выберите строки Подключение ion.

    • Для локального СЕРВЕРА SQL Server строка подключения имеет следующий формат:

      Server={your-server-address};Database={your-database-name};User Id={your-user-name};Password={your-password};

  • В стандартных рабочих процессах для использования встроенных триггеров SQL необходимо включить отслеживание изменений в таблице, в которой требуется использовать триггер. Дополнительные сведения см. в разделе "Включение и отключение отслеживания изменений".

  • Рабочий процесс приложения логики, в котором требуется получить доступ к базе данных SQL. Чтобы запустить рабочий процесс с триггером SQL Server, необходимо начать с пустого рабочего процесса. Чтобы использовать действие SQL Server, запустите рабочий процесс с любым триггером.

  • Чтобы подключиться к локальному серверу SQL Server, применяются следующие дополнительные требования, основанные на наличии рабочего процесса приложения логики "Потребление" или "Стандартный".

    • Рабочий процесс потребления

      • В нескольких клиентах Azure Logic Apps требуется локальный шлюз данных, установленный на локальном компьютере и ресурс шлюза данных, который уже создан в Azure.

      • В isE не требуется локальный шлюз данных для проверки подлинности SQL Server и подключений проверки подлинности, отличных от Windows, и вы можете использовать соединитель SQL Server с версией ISE. Для проверки подлинности Windows требуется локальный шлюз данных на локальном компьютере и ресурс шлюза данных, который уже создан в Azure. Соединитель версии ISE не поддерживает проверку подлинности Windows, поэтому необходимо использовать обычный управляемый соединитель SQL Server.

    • Стандартный рабочий процесс

      Вы можете использовать встроенный соединитель SQL Server или управляемый соединитель.

      • Чтобы использовать проверку подлинности Microsoft Entra или проверку подлинности управляемого удостоверения с приложением логики, необходимо настроить SQL Server для работы с этими типами проверки подлинности. Дополнительные сведения см. в справочнике по управляемому соединителю SQL Server.

      • Чтобы использовать встроенный соединитель, можно выполнить проверку подлинности подключения с помощью управляемого удостоверения, идентификатора Microsoft Entra или строка подключения. Вы можете настроить пул подключений, указав параметры в строка подключения. Дополнительные сведения см. в разделе Подключение пулов.

      • Чтобы использовать управляемый соединитель SQL Server, следуйте тем же требованиям, что и рабочий процесс приложения логики потребления в мультитенантных Azure Logic Apps. Дополнительные сведения о требованиях к соединителю см. в справочнике по управляемому соединителю SQL Server.

Добавление триггера SQL Server

Следующие шаги используют портал Azure, но с соответствующим расширением Azure Logic Apps можно также использовать следующие средства для создания рабочих процессов приложения логики:

  1. В портал Azure откройте приложение логики потребления и пустой рабочий процесс в конструкторе.

  2. В конструкторе в поле поиска выберите "Стандартный". Затем выполните следующие общие действия, чтобы добавить нужный триггер SQL Server.

    Этот пример продолжается с триггером с именем "При создании элемента".

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

  4. После появления поля сведений о триггере укажите необходимые сведения, необходимые выбранному триггеру.

    В этом примере в триггере с именем "При создании элемента" укажите значения для имени сервера SQL Server и имени базы данных, если вы ранее их не предоставили. В противном случае в списке имен таблицы выберите нужную таблицу. Выберите частоту и интервал, чтобы задать расписание для триггера проверка для новых элементов.

    Screenshot shows Consumption workflow designer and managed action named When an item is created.

  5. Если для этого триггера доступны другие свойства, откройте список новых параметров и выберите эти свойства, относящиеся к вашему сценарию.

    Этот триггер возвращает только одну строку из выбранной таблицы. Чтобы выполнить другие задачи, добавьте действие соединителя SQL Server или другое действие, которое выполняет следующую задачу в рабочем процессе приложения логики.

    Например, чтобы просмотреть данные в этой строке, можно добавить другие действия, которые создают файл, содержащий поля из возвращенной строки, а затем отправляют оповещения по электронной почте. Дополнительные сведения о других доступных действиях для этого соединителя см. в справочнике по управляемому соединителю SQL Server.

  6. Закончив работу, сохраните свой рабочий процесс. На панели инструментов конструктора выберите Сохранить.

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

Добавление действия SQL Server

Следующие действия используют портал Azure, но с соответствующим расширением Azure Logic Apps можно также использовать Visual Studio для редактирования рабочих процессов приложений логики потребления или Visual Studio Code на следующие средства для редактирования рабочих процессов приложения логики:

В этом примере рабочий процесс приложения логики начинается с триггера повторения и вызывает действие, которое получает строку из базы данных SQL.

  1. В портал Azure откройте приложение логики потребления и рабочий процесс в конструкторе.

  2. В конструкторе выполните следующие общие действия, чтобы добавить нужное управляемое действие SQL Server.

    Этот пример продолжается с действием Get row, которое получает одну запись.

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

  4. После появления поля сведений о действии в списке имен таблицы выберите таблицу, которую вы хотите использовать. В свойстве идентификатора строки введите идентификатор нужной записи.

    В этом примере имя таблицы — SalesLT.Customer.

    Screenshot shows Consumption workflow designer and action named Get row with the example table name and empty row ID.

    Это действие возвращает только одну строку из выбранной таблицы и больше ничего. Чтобы просмотреть данные в этой строке, добавьте другие действия. Например, такие действия могут создать файл, включить поля из возвращаемой строки и сохранить файл в облачной учетной записи хранения. Дополнительные сведения о других доступных действиях для этого соединителя см. на странице справочных материалов по соединителю.

  5. Закончив работу, сохраните свой рабочий процесс. На панели инструментов конструктора выберите Сохранить.

Подключение к базе данных

При добавлении триггера или действия, которое подключается к службе или системе, и у вас нет существующего или активного подключения, Azure Logic Apps предложит предоставить сведения о подключении, которые зависят от типа подключения, например:

  • Учетные данные учетной записи
  • Имя, используемое для подключения
  • Имя сервера или системы
  • Тип проверки подлинности
  • Строка подключения

После предоставления этих сведений выполните следующие действия на основе целевой базы данных:

Подключение База данных SQL Azure или Управляемый экземпляр SQL

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

В поле сведений о подключении выполните следующие действия:

  1. Для имени Подключение ion укажите имя, используемое для подключения.

  2. Для типа проверки подлинности выберите необходимую и включенную проверку подлинности в базе данных в База данных SQL Azure или Управляемый экземпляр SQL:

    Проверка подлинности Description
    Строка соединения — Поддерживается только в стандартных рабочих процессах со встроенным соединителем SQL Server.

    — требуется строка подключения на сервер SQL Server и базу данных.
    Active Directory OAuth — Поддерживается только в стандартных рабочих процессах со встроенным соединителем SQL Server. Дополнительные сведения см. в следующей документации:

    - Проверка подлинности для соединителя SQL Server
    - Включение открытой проверки подлинности идентификатора Microsoft Entra (Идентификатор Microsoft Entra ID OAuth)
    - Открытая проверка подлинности Идентификатора Microsoft Entra
    Управляемое удостоверение Logic Apps — Поддерживается управляемым соединителем SQL Server и соединителем с версиями ISE. В стандартных рабочих процессах этот тип проверки подлинности доступен для встроенного соединителя SQL Server, но вместо этого параметр называется Управляемым удостоверением .

    — требует следующих элементов:

    --- допустимое управляемое удостоверение, которое включено в ресурсе приложения логики и имеет доступ к базе данных.

    --- Доступ к ресурсу SQL Server участника базы данных SQL

    --- Доступ участника к группе ресурсов, включающей ресурс SQL Server.

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

    - Проверка подлинности управляемого удостоверения для соединителя SQL Server
    - SQL — роли уровня сервера
    Субъект-служба (приложение Microsoft Entra) — поддерживается управляемым соединителем SQL Server.

    — требуется приложение Microsoft Entra и субъект-служба. Дополнительные сведения см. в статье "Создание приложения Microsoft Entra и субъекта-службы" с доступом к ресурсам с помощью портал Azure.
    Интегрированная microsoft Entra — Поддерживается управляемым соединителем SQL Server и соединителем с версиями ISE.

    — требуется допустимое управляемое удостоверение в Microsoft Entra, которое включено в ресурсе приложения логики и имеет доступ к базе данных. Дополнительные сведения см. в следующих разделах:

    - Общие сведения о безопасности Azure SQL — Проверка подлинности
    - Авторизация доступа к базе данных в Azure SQL — Проверка подлинности и авторизация
    - Azure SQL — встроенная проверка подлинности Microsoft Entra
    Проверка подлинности SQL Server — Поддерживается управляемым соединителем SQL Server и соединителем с версиями ISE.

    — требует следующих элементов:

    --- ресурс шлюза данных, созданный ранее в Azure для подключения, независимо от того, находится ли ваше приложение логики в нескольких клиентах Azure Logic Apps или isE.

    --- допустимое имя пользователя и надежный пароль, созданные и хранящиеся в базе данных SQL Server. Дополнительные сведения см. в следующих разделах:

    - Общие сведения о безопасности Azure SQL — Проверка подлинности
    - Авторизация доступа к базе данных в Azure SQL — Проверка подлинности и авторизация

    В следующих примерах показано, как может появиться поле сведений о подключении, если вы используете управляемый соединитель SQL Server и выберите встроенную проверку подлинности Microsoft Entra:

    Рабочие процессы потребления

    Screenshot shows Azure portal, Consumption workflow, and SQL Server cloud connection information with selected authentication type.

    Стандартные рабочие процессы

    Screenshot shows Azure portal, Standard workflow, and SQL Server cloud connection information with selected authentication type.

  3. После выбора интегрированной интеграции Microsoft Entra нажмите кнопку "Войти". В зависимости от того, используете ли вы База данных SQL Azure или Управляемый экземпляр SQL, выберите учетные данные пользователя для проверки подлинности.

  4. Выберите следующие значения для базы данных:

    Свойство Обязательное поле Description
    Имя сервера Да Адрес сервера SQL Server, например Fabrikam-Azure-SQL.database.windows.net
    Имя базы данных Да Имя базы данных SQL, например Fabrikam-Azure-SQL-DB
    Имя таблицы Да Таблица, которую вы хотите использовать, например SalesLT.Customer

    Совет

    Чтобы предоставить сведения о базе данных и таблице, воспользуйтесь следующими возможностями:

    • Эту информацию можно найти в строке подключения для базы данных. Например, найдите и откройте свою базу данных на портале Azure. В меню базы данных выберите строки Подключение ion или Properties, где можно найти следующую строку:

      Server=tcp:{your-server-address}.database.windows.net,1433;Initial Catalog={your-database-name};Persist Security Info=False;User ID={your-user-name};Password={your-password};MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;

    • По умолчанию таблицы в системных базах данных отфильтровываются, поэтому они могут не отображаться автоматически, когда вы выбираете такую базу данных. В качестве альтернативы можно выбрать в списке таблиц базы данных пункт Введите пользовательское значение и вручную ввести имя таблицы.

    Это поле сведений о базе данных выглядит примерно так:

    Рабочие процессы потребления

    Screenshot shows SQL cloud database cloud information with sample values for Consumption.

    Стандартные рабочие процессы

    Screenshot shows SQL cloud database information with sample values for Standard.

  5. Теперь перейдите к еще не выполненным действиям из раздела Добавление триггера SQL или Добавление действия SQL.

Подключение к локальному экземпляру SQL Server

В поле сведений о подключении выполните следующие действия:

  1. В случае подключений к локальному серверу SQL, для которых требуется локальный шлюз данных, выполните все необходимые условия.

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

  2. В поле Тип проверки подлинности выберите требуемую проверку подлинности, включенную на сервере SQL Server:

    Проверка подлинности Description
    Проверка подлинности SQL Server — Поддерживается управляемым соединителем SQL Server, встроенным соединителем SQL Server и соединителем с версиями ISE.

    — требует следующих элементов:

    --- ресурс шлюза данных, созданный ранее в Azure для подключения, независимо от того, находится ли ваше приложение логики в нескольких клиентах Azure Logic Apps или isE.

    --- допустимое имя пользователя и надежный пароль, созданные и хранящиеся в SQL Server.

    Дополнительные сведения см. в разделе Соединение с использованием проверки подлинности SQL Server.
    Проверка подлинности Windows. — поддерживается управляемым соединителем SQL Server.

    — требует следующих элементов:

    --- ресурс шлюза данных, созданный ранее в Azure для подключения, независимо от того, находится ли ваше приложение логики в нескольких клиентах Azure Logic Apps или isE.

    --- допустимое имя пользователя и пароль Windows, чтобы подтвердить удостоверение с помощью учетной записи Windows.

    Дополнительные сведения: Проверка подлинности Windows.
  3. Выберите или укажите следующие значения для базы данных SQL:

    Свойство Обязательное поле Description
    Имя сервера SQL Да Адрес сервера SQL, например Fabrikam-Azure-SQL.database.windows.net
    Имя базы данных SQL Да Имя базы данных SQL Server, например Fabrikam-Azure-SQL-DB
    Username Да Ваше имя пользователя для сервера SQL и базы данных
    Пароль Да Ваш пароль для сервера SQL и базы данных
    Подписка Да (для проверки подлинности Windows) Подписка Azure для ресурса шлюза данных, созданного ранее в Azure
    Шлюз для подключения Да (для проверки подлинности Windows) Имя ресурса шлюза данных, созданного ранее в Azure



    Совет. Если шлюз не отображается в списке, проверьте, правильно ли вы его настроили.

    Совет

    Эту информацию можно найти в строке подключения к базе данных.

    • Server={your-server-address}
    • Database={your-database-name}
    • User ID={your-user-name}
    • Password={your-password}

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

    Рабочие процессы потребления

    Screenshot shows Azure portal, Consumption workflow, and SQL Server on-premises connection information with selected authentication.

    Стандартные рабочие процессы

    Screenshot shows Azure portal, Standard workflow, and SQL Server on-premises connection information with selected authentication.

  4. Когда будете готовы, нажмите Создать.

  5. Теперь перейдите к еще не выполненным действиям из раздела Добавление триггера SQL или Добавление действия SQL.

Обработка больших данных

Иногда вы работаете с результирующих наборами, чтобы соединитель не возвращал все результаты одновременно. Кроме того, вы хотите лучше контролировать размер и структуру результирующих наборов. В следующем списке приведены некоторые способы обработки таких больших результирующих наборов:

Обработка динамических больших данных

При вызове хранимой процедуры с помощью соединителя SQL Server возвращаемые выходные данные иногда могут быть динамическими. В этом случае выполните следующее.

  1. В портал Azure откройте приложение логики и рабочий процесс в конструкторе.

  2. Просмотрите формат выходных данных, выполнив тестовый запуск. Скопируйте и сохраните пример выходных данных.

  3. В конструкторе в действии, в котором вызывается хранимая процедура, добавьте встроенное действие с именем Parse JSON.

  4. В действии Анализ JSON выберите Использовать образец полезных данных для создания схемы.

  5. В окне Введите или вставьте пример полезной нагрузки JSON вставьте пример выходных данных, а затем нажмите Готово.

    Примечание.

    Если вы получите сообщение об ошибке, что Azure Logic Apps не может создать схему, проверка правильно отформатирован синтаксис примера выходных данных. Если вы по-прежнему не можете создать схему, введите ее вручную в поле Схема.

  6. Закончив работу, сохраните свой рабочий процесс.

  7. Чтобы ссылаться на свойства содержимого JSON, выберите в полях редактирования, где нужно ссылаться на эти свойства, чтобы появиться динамический список содержимого. В списке под заголовком Анализ JSON выберите токены данных для нужных свойств содержимого JSON.

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