Получение доступа к ресурсам IBM DB2 и управление ими с помощью Azure Logic Apps
Область применения: Azure Logic Apps (потребление)
С помощью Azure Logic Apps и соединителя IBM DB2 можно создавать автоматизированные задачи и рабочие процессы на основе ресурсов, хранимых в базе данных DB2. Рабочие процессы могут подключаться к ресурсам в базе данных, считывать и выводить таблицы баз данных, добавлять, менять и удалять строки и т. д. В приложения логики можно включать действия, которые получают ответы от базы данных и делают выходные данные доступными для других действий.
В этой статье показано, как создать приложение логики, выполняющее различные операции с базами данных. Если вы не знакомы с приложениями логики, ознакомьтесь со статьей Что такое Azure Logic Apps?
Поддерживаемые платформы и версии
Соединитель DB2 содержит клиент Майкрософт, который взаимодействует с удаленными серверами DB2 по сети TCP/IP. С помощью этого соединителя можно получать доступ к таким облачным базам данных, как IBM DB2 для Windows, работающим в системе виртуализации Azure. Вы также можете получать доступ к локальным базам данных DB2 после установки и настройки локального шлюза данных.
Соединитель IBM DB2 поддерживает следующие платформы и версии IBM DB2, а также совместимые c IBM DB2 продукты, поддерживающие архитектуру распределенной реляционной базы данных (DRDA) SQL Access Manager (SQLAM) версий 10 и 11:
| Платформа | Версия |
|---|---|
| IBM DB2 для z/OS | 12, 11.1, 10.1 |
| IBM DB2 для i | 7.3, 7.2, 7.1 |
| IBM DB2 для LUW | 11, 10.5 |
Поддерживаемые операции с базами данных
Ниже указаны операции с базами данных, поддерживаемые соединителем IBM DB2, и соответствующие действия соединителя.
| Операция с базой данных | Действие соединителя |
|---|---|
| создание списка таблиц базы данных; | Получение таблиц |
| чтение одной строки с помощью инструкции SELECT; | Получение строки |
| чтение всех строк с помощью инструкции SELECT; | Получение строк |
| добавление одной строки с помощью инструкции INSERT; | Вставка строки |
| Изменение одной строки с помощью инструкции UPDATE | Изменить строку |
| удаление одной строки с помощью инструкции DELETE. | Удалить строку |
Необходимые компоненты
Учетная запись и подписка Azure. Если у вас еще нет подписки Azure, зарегистрируйтесь для получения бесплатной учетной записи Azure.
База данных IBM DB2 (облачная или локальная).
Базовые сведения о создании приложений логики. Дополнительные сведения см. в разделе "Создание примера рабочего процесса приложения логики потребления"
Приложение логики, из которого требуется получить доступ к базе данных DB2. Этот соединитель предоставляет только действия, поэтому для запуска приложения логики выберите отдельный триггер, например Периодичность. В примерах этой статьи мы используем триггер Периодичность.
Добавление действия DB2 — получение таблиц
Откройте приложение логики в конструкторе приложений логики на портале Azure, если оно еще не открыто.
В разделе триггера выберите Добавить шаг.
В поле поиска введите слово db2 в качестве фильтра. В этом примере выберите из списка действие Получить таблицы (предварительная версия)
Вам будет предложено указать сведения о подключении к базе данных DB2.
Следуйте инструкциям по созданию подключений для облачных или локальных баз данных.
Подключение к облаку DB2
Чтобы настроить подключение, по запросу укажите приведенные ниже сведения, нажмите Создать, а затем сохраните приложение логики.
| Свойство | Обязательное поле | Описание |
|---|---|---|
| Подключение через локальный шлюз | No | Применяется только для локальных подключений. |
| Имя подключения | Да | Имя подключения, например MyLogicApp-DB2-connection |
| Сервер | Да | Адрес или номер порта двоеточия для сервера DB2, например "myDB2server.cloudapp.net:50000" Примечание. Это строка, представляющая псевдоним или адрес TCP/IP в формате IPv4 или IPv6, за которым следуют двоеточие и номер порта TCP/IP. |
| База данных | Да | Имя базы данных Примечание. Это значение представляет строку, представляющую имя реляционной базы данных DRDA (RDBNAM): – DB2 для z/OS принимает 16-байтовую строку, если база данных известна как расположение "IBM DB2 для z/OS". |
| Username | Да | Имя пользователя для базы данных Примечание. Это значение является строкой, длина которой основана на конкретной базе данных: – DB2 для z/OS принимает 8-байтовую строку. |
| Пароль | Да | Пароль для базы данных |
Например:
Подключение к локальной базе данных DB2
Перед созданием подключения локальный шлюз данных должен быть уже установлен. В противном случае вам не удастся настроить подключение. Если у вас установлен шлюз, продолжайте указывать эти сведения о подключении, а затем нажмите кнопку Создать.
| Свойство | Обязательное поле | Описание |
|---|---|---|
| Подключение через локальный шлюз | Да | Применяется, если необходимо локальное подключение. Показывает свойства локального подключения. |
| Имя подключения | Да | Имя подключения, например MyLogicApp-DB2-connection |
| Сервер | Да | Адрес или номер порта двоеточия для сервера DB2, например myDB2server:50000. Примечание. Это строка, представляющая псевдоним или адрес TCP/IP в формате IPv4 или IPv6, за которым следуют двоеточие и номер порта TCP/IP. |
| База данных | Да | Имя базы данных Примечание. Это значение представляет строку, представляющую имя реляционной базы данных DRDA (RDBNAM): – DB2 для z/OS принимает 16-байтовую строку, если база данных известна как расположение "IBM DB2 для z/OS". |
| Аутентификация | Да | Тип проверки подлинности для подключения, например "Базовый" Примечание. Выберите это значение из списка, включающего варианты "Обычная" и "Windows (Kerberos)". |
| Username | Да | Имя пользователя для базы данных Примечание. Это значение является строкой, длина которой основана на конкретной базе данных: – DB2 для z/OS принимает 8-байтовую строку. |
| Пароль | Да | Пароль для базы данных |
| Шлюз | Да | Имя установленного локального шлюза данных Примечание. Выберите это значение из списка, включающего все установленные шлюзы данных в вашей подписке Azure и группе ресурсов. |
Например:
Просмотр таблиц выходных данных
Чтобы вручную запустить приложение логики, на панели инструментов конструктора нажмите кнопку Запустить. Когда работа приложения логики завершится, вы сможете просмотреть выходные данные.
В меню приложения логики выберите Обзор.
На вкладке Сводка, в разделе Журнал запусков, выберите последний запуск, который будет указан в списке первым.
В разделе Запуск приложения логики можно просмотреть состояние, а также входные и выходные данные для каждого этапа приложения логики. Разверните действие Получить таблицы.
Чтобы просмотреть входные данные, нажмите Показать необработанные входные данные.
Чтобы просмотреть выходные данные, нажмите Показать необработанные выходные данные.
Выходные данные включают список таблиц.
Получение строки
Чтобы получить одну запись из таблицы базы данных DB2, используйте действие Получить строку в приложении логики.
Это действие выполняет оператор SELECT WHERE для базы данных DB2, например SELECT FROM AREA WHERE AREAID = '99999'.
Если вы еще не использовали действия DB2 в приложении логики, выполните инструкции из раздела Добавление действия DB2 — получение таблиц, но добавьте действие Получить строку, а затем вернитесь к данному разделу.
После добавления действия Получить строку приложение логики будет выглядеть так:
Укажите значения для всех обязательных свойств (*). После выбора таблицы это действие показывает соответствующие свойства записей из этой таблицы.
Свойство Обязательное поле Описание Имя таблицы Да Таблица, содержащая нужную запись (в этом примере — "AREA") Идентификатор области Да Идентификатор нужной записи (в этом примере — 99999) 
Завершив работу, нажмите кнопку Сохранить на панели инструментов конструктора.
Просмотр строки выходных данных
Чтобы вручную запустить приложение логики, на панели инструментов конструктора нажмите кнопку Запустить. Когда работа приложения логики завершится, вы сможете просмотреть выходные данные.
В меню приложения логики выберите Обзор.
На вкладке Сводка, в разделе Журнал запусков, выберите последний запуск, который будет указан в списке первым.
В разделе Запуск приложения логики можно просмотреть состояние, а также входные и выходные данные для каждого этапа приложения логики. Разверните действие Получить строку.
Чтобы просмотреть входные данные, нажмите Показать необработанные входные данные.
Чтобы просмотреть выходные данные, нажмите Показать необработанные выходные данные.
Выходные данные включают указанную строку.
Получение строк
Чтобы получить все записи из таблицы базы данных DB2, используйте действие Получить строки в приложении логики.
Это действие выполняет оператор SELECT для базы данных DB2, например SELECT * FROM AREA.
Если вы еще не использовали действия DB2 в приложении логики, выполните инструкции из раздела Добавление действия DB2 — получение таблиц, но добавьте действие Получить строки, а затем вернитесь к данному разделу.
После добавления действия Получить строки приложение логики будет выглядеть так:
Откройте список Имя таблицы и выберите нужную таблицу (в этом примере — "AREA"):
Чтобы задать фильтр или запросить результаты, нажмите Показать расширенные параметры.
Завершив работу, нажмите кнопку Сохранить на панели инструментов конструктора.
Просмотр строк выходных данных
Чтобы вручную запустить приложение логики, на панели инструментов конструктора нажмите кнопку Запустить. Когда работа приложения логики завершится, вы сможете просмотреть выходные данные.
В меню приложения логики выберите Обзор.
На вкладке Сводка, в разделе Журнал запусков, выберите последний запуск, который будет указан в списке первым.
В разделе Запуск приложения логики можно просмотреть состояние, а также входные и выходные данные для каждого этапа приложения логики. Разверните действие Получить строки.
Чтобы просмотреть входные данные, нажмите Показать необработанные входные данные.
Чтобы просмотреть выходные данные, нажмите Показать необработанные выходные данные.
Выходные данные включают все записи из указанной таблицы.
Вставка строки
Чтобы добавить одну запись в таблицу базы данных DB2, используйте действие Вставить строку в приложении логики.
Это действие выполняет оператор INSERT для базы данных DB2, например INSERT INTO AREA (AREAID, AREADESC, REGIONID) VALUES ('99999', 'Area 99999', 102).
Если вы еще не использовали действия DB2 в приложении логики, выполните инструкции из раздела Добавление действия DB2 — получение таблиц, но добавьте действие Вставить строку, а затем вернитесь к данному разделу.
После добавления действия Вставить строку приложение логики будет выглядеть так:
Укажите значения для всех обязательных свойств (*). После выбора таблицы это действие показывает соответствующие свойства записей из этой таблицы.
Ниже приведены свойства для этого примера.
Свойство Обязательное поле Описание Имя таблицы Да Таблица, в которую требуется добавить запись, например "AREA" Идентификатор области Да Идентификатор добавляемой области, например 99999 Описание области Да Описание добавляемой области, например "Область 99999" Идентификатор региона Да Идентификатор добавляемого региона, например 102 Например:
Завершив работу, нажмите кнопку Сохранить на панели инструментов конструктора.
Просмотр выходных данных действия "Вставить строку"
Чтобы вручную запустить приложение логики, на панели инструментов конструктора нажмите кнопку Запустить. Когда работа приложения логики завершится, вы сможете просмотреть выходные данные.
В меню приложения логики выберите Обзор.
На вкладке Сводка, в разделе Журнал запусков, выберите последний запуск, который будет указан в списке первым.
В разделе Запуск приложения логики можно просмотреть состояние, а также входные и выходные данные для каждого этапа приложения логики. Разверните действие Вставить строку.
Чтобы просмотреть входные данные, нажмите Показать необработанные входные данные.
Чтобы просмотреть выходные данные, нажмите Показать необработанные выходные данные.
Выходные данные включают запись, добавленную в указанную таблицу.
Изменить строку
Чтобы обновить одну запись в таблице базы данных DB2, используйте действие Изменить строку в приложении логики.
Это действие выполняет оператор UPDATE для базы данных DB2, например UPDATE AREA SET AREAID = '99999', AREADESC = 'Updated 99999', REGIONID = 102).
Если вы еще не использовали действия DB2 в приложении логики, выполните инструкции из раздела Добавление действия DB2 — получение таблиц, но добавьте действие Изменить строку, а затем вернитесь к данному разделу.
После добавления действия Изменить строку приложение логики будет выглядеть так:
Укажите значения для всех обязательных свойств (*). После выбора таблицы это действие показывает соответствующие свойства записей из этой таблицы.
Ниже приведены свойства для этого примера.
Свойство Обязательное поле Описание Имя таблицы Да Таблица, в которой требуется изменить запись, например "AREA" ИД строки Да Идентификатор обновляемой записи, например 99999 Идентификатор области Да Новый идентификатор области, например 99999 Описание области Да Описание новой области, например "Обновленная 99999" Идентификатор региона Да Новый идентификатор региона, например 102 Например:
Завершив работу, нажмите кнопку Сохранить на панели инструментов конструктора.
Просмотр выходных данных действия "Изменить строку"
Чтобы вручную запустить приложение логики, на панели инструментов конструктора нажмите кнопку Запустить. Когда работа приложения логики завершится, вы сможете просмотреть выходные данные.
В меню приложения логики выберите Обзор.
На вкладке Сводка, в разделе Журнал запусков, выберите последний запуск, который будет указан в списке первым.
В разделе Запуск приложения логики можно просмотреть состояние, а также входные и выходные данные для каждого этапа приложения логики. Разверните действие Изменить строку.
Чтобы просмотреть входные данные, нажмите Показать необработанные входные данные.
Чтобы просмотреть выходные данные, нажмите Показать необработанные выходные данные.
Выходные данные включают запись, обновленную в указанной таблице.
Удалить строку
Чтобы удалить одну запись из таблицы базы данных DB2, используйте действие Удалить строку в приложении логики.
Это действие выполняет оператор DELETE для базы данных DB2, например DELETE FROM AREA WHERE AREAID = '99999'.
Если вы еще не использовали действия DB2 в приложении логики, выполните инструкции из раздела Добавление действия DB2 — получение таблиц, но добавьте действие Удалить строку, а затем вернитесь к данному разделу.
После добавления действия Удалить строку приложение логики будет выглядеть так:
Укажите значения для всех обязательных свойств (*). После выбора таблицы это действие показывает соответствующие свойства записей из этой таблицы.
Ниже приведены свойства для этого примера.
Свойство Обязательное поле Описание Имя таблицы Да Таблица, из которой требуется удалить запись, например "AREA" ИД строки Да Идентификатор удаляемой записи, например 99999 Например:
Завершив работу, нажмите кнопку Сохранить на панели инструментов конструктора.
Просмотр выходных данных действия "Удалить строку"
Чтобы вручную запустить приложение логики, на панели инструментов конструктора нажмите кнопку Запустить. Когда работа приложения логики завершится, вы сможете просмотреть выходные данные.
В меню приложения логики выберите Обзор.
На вкладке Сводка, в разделе Журнал запусков, выберите последний запуск, который будет указан в списке первым.
В разделе Запуск приложения логики можно просмотреть состояние, а также входные и выходные данные для каждого этапа приложения логики. Разверните действие Удалить строку.
Чтобы просмотреть входные данные, нажмите Показать необработанные входные данные.
Чтобы просмотреть выходные данные, нажмите Показать необработанные выходные данные.
Выходные данные больше не включают запись, удаленную из указанной таблицы.
Справочник по соединителям
Дополнительные технические сведения об этом соединителе, в том числе о триггерах, действиях и ограничениях, описываемых файлом Swagger соединителя, см. на странице справочника по соединителю.