Как написать функцию коннектора SQL

Как написать функцию коннектора SQL

Используйте это руководство для подключения вашего приложения Tulip к базе данных SQL.

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

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

1- Перейдите на страницу Connectors, наведя курсор на Apps в строке меню и выбрав Connectors из выпадающего списка.

2- Нажмите кнопку "Добавить коннектор" в правой верхней части экрана, дайте коннектору имя и выберите тип коннектора "SQL".

3- На вкладке "Среды" нового коннектора выберите "Добавить сведения о подключении".

4- Заполните соответствующие данные для подключения к базе данных:

• Running On ("Хост облачного коннектора", если не задана другая настройка)
• Тип
• Сервер
• Порт
• SSL (да или нет)
• База данных
• Имя пользователя
• Пароль

5- Нажмите кнопку "Тест", чтобы запустить тестовый сигнал. Если все прошло успешно, нажмите кнопку "Сохранить".

6- Убедитесь, что хост коннектора имеет доступ к базе данных (на это указывает зеленая метка "Online" рядом с сервером на странице Connectors).

После успешной настройки нового коннектора можно создавать функции коннектора для отправки или получения данных из внешней базы данных. Функция коннектора должна быть написана на соответствующем языке целевой базы данных.

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

1- Нажмите кнопку "Добавить новую функцию" на вкладке "Функции".

2- Назовите новую функцию (это позволит выбрать конкретную функцию-коннектор в Triggers).

1. Настройте входы и выходы функции

В приведенном примере:

Входы

• конфигурация (текст)

Выходы

• субконфигурация_1
• субконфигурация_2
• субконфигурация_3

Запрос

`SELECT subconfig_1, subconfig_2, subconfig_3 FROM database webinar WHERE configuration = $configuration$ order by id desc limit 1````

Функция может иметь несколько входов и выходов. Для отправки/получения данных из приложения Tulip App вам потребуется как минимум один вход или выход.

• Нажмите кнопку Add, чтобы добавить новый вход или выход
• Дайте полю узнаваемое имя
• Выберите тип данных (например, Text, Boolean, Integer и т.д.).
• В поле Query добавьте корректный SQL-запрос. Обратите внимание, что имена входных переменных должны быть обернуты в $. Пример:
  $input$.
• Протестируйте функцию
• Если функция имеет входные данные, введите корректные значения.
• Нажмите кнопку "Test" в правом верхнем углу.
• Просмотреть результаты тестирования или сообщения об ошибках в разделе " Результаты тестирования ".

1. В некоторых случаях требуется вернуть несколько строк из таблицы SQL. Для этого установите флажок "Return Multiple Rows". В результате будет возвращен массив объектов, в котором каждый объект содержит значения из одной строки таблицы SQL.

Запрос

SELECT name, num from numbers where num > $number$

(в приведенном примере число - это вход)

Затем, когда вы добавите свои входные данные и нажмете кнопку "Test", вы должны увидеть все ожидаемые строки, возвращаемые в разделе "Test Results".

Их можно сохранить в переменной как массив, заполненный объектами в редакторе триггеров.

7- Нажмите "Сохранить", когда закончите.

:::(Warning) (ПРИМЕЧАНИЕ) Входы и выходы не могут быть изменены после сохранения функции. Это необходимо для предотвращения сбоев в работе приложений, которые могут использовать функцию коннектора.
:::

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

Более подробную информацию о написании некоторых часто используемых функций SQL можно найти в разделе"Общие функции коннектора SQL".

Дальнейшее чтение

• Как использовать выходные данные функций коннекторов в приложениях
• Обзор HTTP-коннекторов

Вы нашли то, что искали?

Вы также можете зайти на community.tulip.co, чтобы задать свой вопрос или узнать, сталкивались ли другие с подобным вопросом!