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

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

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

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

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

• Что такое Azure Logic Apps?
• Краткое руководство. Создание примера рабочего процесса приложения логики потребления с помощью портала Azure
• Создание примера рабочего процесса приложения логики уровня "Стандартный" с помощью портала Azure

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

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

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

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

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

Ограничения

Дополнительные сведения см. в справочнике по управляемому соединителю 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, необходимо вручную добавить пароль в строку подключения. Для конфиденциальной информации, такой как эта строка, обязательно используйте самый безопасный поток проверки подлинности. Корпорация Майкрософт рекомендует пройти проверку подлинности доступа к ресурсам Azure с помощью управляемого удостоверения , если это возможно, и назначить роль с минимальными привилегиями.

  Если эта возможность недоступна, обязательно защитите строка подключения с помощью других мер, таких как Azure Key Vault, которые можно использовать с параметрами приложения в стандартных рабочих процессах. Потом можно напрямую ссылаться на такие защищенные строки, как строки подключения и ключи. Как и шаблоны ARM, где можно определить переменные среды во время развертывания, можно определить параметры приложения в определении рабочего процесса приложения логики "Стандартный". Затем можно захватывать динамически генерируемые значения инфраструктуры, такие как конечные точки подключения, строки хранения и другие. Дополнительные сведения см. в разделе "Типы приложений" для платформа удостоверений Майкрософт.

  • Для базы данных 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. В меню базы данных в разделе "Свойства" выберите строки подключения.

  • Для локального СЕРВЕРА 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.

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

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

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

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

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

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

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

• Рабочие процессы потребления: Visual Studio Code
• Стандартные рабочие процессы: Visual Studio Code

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

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

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

• Рабочие процессы потребления: Visual Studio Code
• Стандартные рабочие процессы: Visual Studio Code

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

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

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

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

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

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

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

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

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

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

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

   Проверка подлинности	Описание
   Строка соединения	Поддерживается только в стандартных рабочих процессах со встроенным соединителем SQL Server. Требуется строка подключения к серверу SQL Server и базе данных.
   Active Directory OAuth	Поддерживается только в стандартных рабочих процессах со встроенным соединителем SQL Server. Дополнительные сведения см. в следующей документации: - Проверка подлинности для соединителя SQL Server - Включение OAuth 2.0 с идентификатором Microsoft Entra
   Управляемое удостоверение Logic Apps	Поддерживается управляемым соединителем SQL Server. В стандартных рабочих процессах этот тип проверки подлинности доступен для встроенного соединителя SQL Server, но вместо этого параметр называется Управляемым удостоверением . Требуется следующее: — Допустимое управляемое удостоверение, которое включено в ресурсе приложения логики и имеет доступ к базе данных. - Доступ к ресурсу SQL Server участника базы данных SQL --- Доступ участника к группе ресурсов, включающей ресурс SQL Server. Дополнительные сведения см. в следующей документации: - Проверка подлинности управляемого удостоверения для соединителя SQL Server - Server-Level Роли
   Субъект-служба (приложение Microsoft Entra)	Поддерживается управляемым соединителем SQL Server. Требуется приложение Microsoft Entra и учетная запись службы. Дополнительные сведения см. в статье "Создание приложения Microsoft Entra и субъекта-службы" с доступом к ресурсам с помощью портал Azure.
   Интегрированная microsoft Entra	Поддерживается управляемым соединителем SQL Server. Требуется валидное управляемое удостоверение в Microsoft Entra, которое включено в вашем ресурсе приложения логики и имеет доступ к вашей базе данных. Дополнительные сведения см. в следующих статьях: - Общие сведения о безопасности Azure SQL — Проверка подлинности - Авторизация доступа к базе данных в Azure SQL — Проверка подлинности и авторизация - Проверка подлинности Microsoft Entra для SQL Azure
   Проверка подлинности SQL Server	Поддерживается управляемым соединителем SQL Server. Требуется следующее: — Ресурс шлюза данных, созданный ранее в Azure для вашего подключения, независимо от того, находится ваше приложение логики в мультитенантной среде Azure Logic Apps. — Допустимое имя пользователя и надежный пароль, созданные и хранящиеся в базе данных SQL Server. Дополнительные сведения см. в следующих статьях: - Общие сведения о безопасности Azure SQL — Проверка подлинности - Авторизация доступа к базе данных в Azure SQL — Проверка подлинности и авторизация

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

   

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

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

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

   Совет

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

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

     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;

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

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

   

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

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

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

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

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

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

   Проверка подлинности	Описание
   Проверка подлинности SQL Server	Поддерживается управляемым соединителем SQL Server и встроенным соединителем SQL Server. Требуется следующее: — Ресурс шлюза данных, созданный ранее в Azure для вашего подключения, независимо от того, находится ваше приложение логики в мультитенантной среде Azure Logic Apps. — Допустимое имя пользователя и надежный пароль, созданные и хранящиеся в SQL Server. Дополнительные сведения см. в разделе Соединение с использованием проверки подлинности SQL Server.
   Проверка подлинности Windows.	Поддерживается управляемым соединителем SQL Server. Требуется следующее: — Ресурс шлюза данных, созданный ранее в Azure для вашего подключения, независимо от того, находится ваше приложение логики в мультитенантной среде Azure Logic Apps. — Действительное имя пользователя и пароль Windows для подтверждения вашей личности с помощью учетной записи Windows. Дополнительные сведения: Проверка подлинности Windows.

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

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

   Совет

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

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

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

   

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

5. Продолжайте действия, которые вы еще не выполнили, в разделе "Добавление триггера SQL " или "Добавление действия SQL".

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

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

• Чтобы упростить управление результатами в виде небольших наборов, включите разбиение на страницы. Дополнительные сведения см. в статье "Получение дополнительных данных, элементов или записей с помощью разбиения на страницы в Azure Logic Apps". Дополнительные сведения см. в статье Разбиение на страницы в SQL для массовой передачи данных с помощью Logic Apps.

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

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

  Чтобы упорядочить результаты таким образом, можно создать хранимую процедуру, которая выполняется в экземпляре SQL и использует инструкцию SELECT - ORDER BY . Это решение позволяет управлять размером и структурой полученных результатов. Приложение логики вызывает хранимую процедуру с помощью действия выполнения хранимой процедуры соединителя SQL Server. Дополнительные сведения см. в статье SELECT — предложение ORDER BY.

  Примечание.

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

  Для этой задачи можно использовать агент заданий обработки эластичных баз данных Azure для Базы данных SQL Azure. Для локальной среды и Управляемый экземпляр SQL SQL Server можно использовать агент SQL Server. Дополнительные сведения см. в статье "Обработка длительных тайм-аутов хранимых процедур" в соединителе SQL Server для Azure Logic Apps.

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

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

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

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

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

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

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

   Примечание.

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

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

7. Чтобы ссылаться на свойства содержимого JSON, выполните следующие действия.

   1. Выберите в текстовых полях редактирования, где вы хотите ссылаться на свойства JSON.
   2. Щелкните значок молнии, чтобы открыть список динамического содержимого.
   3. В списке в разделе "Анализ JSON " выберите маркеры данных для нужных свойств содержимого JSON.

Связанный контент

• Управляемые соединители для Azure Logic Apps.
• Встроенные соединители в Azure Logic Apps