Перейти к основному контенту

SQL-запросы (Запросы к БД)

Работа с SQL-запросами

Данное руководство поможет вам разобраться с настройкой баз данных, созданием SQL-запросов и их использованием в сценариях на платформе.


1. Работа с базами данных

1.1. Просмотр списка баз данных

image.png

  1. Перейдите в раздел "Базы данных".

  2. На странице отображается список подключённых баз данных:

    • Статус подключения (например, "Подключена" или "Ошибка") отображает текущее состояние доступа к базе данных.

    • Если статус "Ошибка", попробуйте обновить статусы подключений. Если ошибка сохраняется, проверьте настройки базы данных.

  3. Для добавления новой базы данных нажмите кнопку "Добавить базу данных".

1.2. Добавление новой базы данныхimage.png

  1. Нажмите кнопку "Добавить базу данных".

  2. Введите следующие параметры:

    • Название базы данных.

    • Тип базы данных (например, Oracle, MySQL, PostgreSQL).

    • Хост, порт, имя пользователя, пароль и имя базы данных.

  3. Нажмите кнопку "Добавить базу данных" для сохранения.

  4. После добавления база появится в списке. Убедитесь, что статус подключения отображается как "Подключена".

1.3. Настройка базы данных

image.png

  1. Нажмите на иконку параметров (шестерёнка) напротив нужной базы данных в списке.

  2. Откроется модальное окно с параметрами базы данных:

    • Вы можете изменить название, тип базы данных, хост, порт, имя пользователя, пароль и имя базы данных.

    • Для сохранения изменений нажмите "Сохранить изменения".

  3. Для удаления базы данных нажмите кнопку "Удалить базу данных".

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


2. Работа с SQL-запросами

2.1. Просмотр списка SQL-запросов

image.png

  1. Перейдите в раздел "SQL-запросы".

  2. На странице отображается список всех созданных SQL-запросов:

    • Колонка "Базы данных и сценарии" отображает, к каким базам данных и в каких сценариях использован запрос.

    • Используйте поле поиска для поиска запросов по названию.

    • Вы можете фильтровать запросы по базам данных или сценариям.

  3. Для создания нового SQL-запроса нажмите кнопку "Создать SQL-запрос".

2.2. Создание SQL-запроса

image.png

  1. Нажмите кнопку "Создать SQL-запрос".

  2. В открывшемся редакторе выполните следующие действия:

    • В разделе "Основные данные" укажите название запроса и выберите базу данных из выпадающего списка.

    • В разделе "SQL-запрос" введите текст SQL-запроса.

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

      • Укажите имя переменной.

      • Задайте тип переменной ("Число" или "Строка").

  3. Для проверки запроса нажмите кнопку "Получить результаты":

    • Отобразятся результаты выполнения запроса.

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

  4. Нажмите кнопку "Сохранить запрос" для завершения.

2.3. Редактирование SQL-запроса

image.png

  1. Для редактирования существующего запроса выберите его из списка и нажмите на его название.

  2. Внесите изменения в открывшемся редакторе.

  3. Нажмите кнопку "Сохранить запрос" для сохранения изменений.

2.4. Удаление SQL-запроса

  1. Нажмите иконку удаления рядом с запросом в списке.

  2. Если запрос используется в сценариях, система уведомит вас о невозможности удаления и покажет список связанных сценариев. Удалите ссылки на запрос из сценариев в блоках "Выполнить SQL-запрос", чтобы завершить удаление.

    image.png


3. Использование SQL-запросов в сценариях

3.1. Добавление блока "Выполнить SQL-запрос"

  1. Перейдите в редактор сценариев.

  2. Щелкните правой кнопкой мыши по рабочему пространству и выберите "Выполнить SQL-запрос".

3.2. Настройка блока

  1. Выберите созданный SQL-запрос из выпадающего списка.

  2. Настройте входные параметры:

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

  3. Настройте результаты запроса:

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

Действие

Скрин

1

Нажмите ПКМ по рабочему пространству и в появившемся списке выберите блок «Отправить запрос в базу»

image.png

2

В правом боковом меню в выпадающем списке выбираем наш созданный запрос

image.png

3

После выбора запроса в разделе «Входные параметры» как раз-таки появляется параметр, который мы добавляли (параметр, который будет передан в запрос)

image.png

4

Присваиваем ему переменную сценария «phone» (как создать переменную в сценарии читайте на странице «Работа с переменными»)


Таким образом, мы передаем значение переменной из сценария в наш запрос

 

image.png

 

5

Нажимаем на вкладку «Результаты запроса» и видим, что наш запрос возвращает столбец «user_id»


Теперь также выбираем/создаем переменную из сценария, которой мы присвоим возвращаемое sql-запросом значение

image.png

6

Сохраняем блок

image.png

3.3. Проверка и сохранение сценария

  1. Убедитесь, что все входные параметры и результаты настроены корректно.

  2. Сохраните изменения сценария.


4. Советы и рекомендации

  • Тестируйте запросы отдельно перед сохранением в редакторе SQL-запросов: это поможет избежать ошибок при настройке сценария.

  • Следите за статусом подключения баз данных: корректная работа SQL-запросов зависит от доступности баз данных.

  • Используйте понятные названия переменных: это упростит их использование в сценариях.


Примечание

Для дополнительной информации по настройке блоков сценариев ознакомьтесь с разделом "Редактор сценариев" в документации.