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

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. :

  • image.png

    Отобразятся

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

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

    «SQL-запросы».
    • И
затем н

  • Нажмитем кнопку image.png в п"Сохравом верхнем углу
    1. Далее нужно заполнить незапробходимые поляс" для завершения.

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

    image.png

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

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

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

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

    З

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

      передать
      2. в

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

      image.png

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

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

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

    2. Щеле «Входкныите параметры» (см. п. 3.2 на скрине)
      3. Протестируйте свой кнопкой мыши по рабочему пространству и выберите "Выполнить SQL-запрос".

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

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

    2. Настробязайтельный шаг). При этом, если у вас используются входные параметры:

      (п.3.2),
        т

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

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

      • Для каждого возвращаемого значения в ыберазделе «Входные параметры» (также см. п. 3.2)
        4. После тестирования запроса, нажмите на кнопку «Сохранить запрос»

        image.png

        Блок. Запрос в базу

        Теперьеменную, когторая будет использова нужный SQL-запрос добавлен, вернемться в сценаредактор и добавим блок «Запрос в базу».

    №

    Действие

    Скрин

    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-запросов зависит от доступности баз данных.

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

    Примечание

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

    Наверх