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

~~Перед началом работы~~

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

~~нужно~~

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

1. добавитьРабота вашус базубазами данных

1.1. платформу.

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

~~Для этого:~~

Перейдите в раздел «"Базы ~~данных»~~данных".
На странице отображается список подключённых баз данных:
Статус подключения (например, "Подключена" или "Ошибка") отображает текущее состояние доступа к базе данных.

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

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

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

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

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

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

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

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

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

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

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

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

~~Введите~~ ~~параметры~~

Откроется ~~вашей~~модальное ~~Базы~~окно ~~данных~~с параметрами базы данных:

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

~~Нажмите~~ на

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

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

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

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

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

~~Теперь~~

~~переходим~~

~~добавлению SQL-запроса:~~

~~0. Перейдем~~Перейдите в ~~соответствующий~~ раздел ~~платформы~~ «"SQL-~~запросы»~~запросы".

И ~~затем~~ ~~нажмем~~

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

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

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

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

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

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

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

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

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

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

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

В разделе "Переменные ~~заполнить~~во ~~необходимые~~входных ~~поля~~параметрах", если такие есть, добавьте параметры запроса:

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

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

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

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

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

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

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

Для редактирования существующего запроса ~~(см.~~выберите ~~скрин ниже)~~
~~2. Пишем сам~~ ~~SQL-запрос~~
~~3.1 Затем вы можете передать в запрос необходимые параметры~~его из ~~сценария,~~списка ~~указав их в «{{}}». Далее они отобразятся в поле «Входные параметры» (см. п. 3.2 на скрине)~~
3. ~~Протестируйте~~ свой запрос (это обязательный шаг). При этом, если у вас используются входные параметры (п.3.2), то при тестировании, вы можете задать им значения в разделе «Входные параметры» (также см. п. 3.2)
~~4. После тестирования запроса,~~и нажмите на его название.

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

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

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

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

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

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

~~Теперь,~~

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

~~добавлен,~~

~~вернемся~~

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

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

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

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

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

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

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

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

№	Действие	Скрин
1	Нажмите ПКМ по рабочему пространству и в появившемся списке выберите блок «Отправить запрос в базу»
2	В правом боковом меню в выпадающем списке выбираем наш созданный запрос
3	После выбора запроса в разделе «Входные параметры» как раз-таки появляется параметр, который мы добавляли (параметр, который будет передан в запрос)
4	Присваиваем ему переменную сценария «phone» (как создать переменную в сценарии читайте на странице «Работа с переменными») Таким образом, мы передаем значение переменной из сценария в наш запрос
5	Нажимаем на вкладку «Результаты запроса» и видим, что наш запрос возвращает столбец «user_id» Теперь также выбираем/создаем переменную из сценария, которой мы присвоим возвращаемое sql-запросом значение
6	Сохраняем блок