Выполнить запрос SQL

Выполняет произвольный SQL запрос

Параметры

Функция ВыполнитьЗапросSQL(Знач ТекстЗапроса, Знач Параметры = "", Знач ФорсироватьРезультат = Ложь, Знач Соединение = "", Знач Tls = "") Экспорт

Параметр	CLI опция	Тип	Обяз.	Назначение
ТекстЗапроса	--sql	Строка	✔	Текст запроса к базе
Параметры	--params	Массив Из Произвольный	✖	Массив позиционных параметров запроса
ФорсироватьРезультат	--force	Булево	✖	Включает попытку получения результата, даже для не SELECT запросов
Соединение	--dbc	Строка, Произвольный	✖	Соединение или строка подключения
Tls	--tls	Структура Из КлючИЗначение	✖	Настройки TLS, если необходимо. См. ПолучитьНастройкиTls

Возвращаемое значение

Соответствие Из КлючИЗначение - Результат выполнения запроса

Расширенный вызов ?

Параметр	Описание
addin_mode	Ручной выбор режима подключения внешней компоненты (для 1С): Изолированно, НеИзолированно
dontwait	Создает фоновое задание и возвращает его данные (только для 1С и OneScript)

подсказка

Параметры запроса указываются как массив структур вида {'Тип данных': 'Значение'}. Список доступных типов описан на начальной странице документации библиотеки MySQL

Без указания флага ФорсироватьРезультат, чтение результата осуществляется только для запросов, начинающихся с SELECT Для остальных запросов возвращается result:true или false с текстом ошибки

Пример использования для 1С:Предприятие/OneScript

    Картинка = "https://hut.openintegrations.dev/test_data/picture.jpg";
    OPI_ПреобразованиеТипов.ПолучитьДвоичныеДанные(Картинка); // Картинка - Тип: ДвоичныеДанные

    Адрес  = "127.0.0.1";
    Логин  = "bayselonarrend";
    Пароль = "12we...";
    База   = "test_data";

    TLS = Истина;
    Порт = 3306;
    СтрокаПодключения = OPI_MySQL.СформироватьСтрокуПодключения(Адрес, База, Логин, Пароль, Порт);

    Если TLS Тогда
        НастройкиTLS = OPI_MySQL.ПолучитьНастройкиTLS(Истина);
    Иначе
        НастройкиTLS = Неопределено;
    КонецЕсли;

    Соединение = OPI_MySQL.ОткрытьСоединение(СтрокаПодключения, НастройкиTLS);

    // CREATE

    ТекстЗапроса = "
                   |CREATE TABLE test_table (
                   |id INT AUTO_INCREMENT PRIMARY KEY,
                   |name VARCHAR(255),
                   |age INT,
                   |salary DOUBLE,
                   |amount FLOAT,
                   |type TINYINT UNSIGNED,
                   |date DATE,
                   |time TIME,
                   |data MEDIUMBLOB
                   |);";

    Результат = OPI_MySQL.ВыполнитьЗапросSQL(ТекстЗапроса, , , Соединение);

    // INSERT с параметрами

    ТекстЗапроса = "
                   |INSERT INTO test_table (name, age, salary, amount, type, date, time, data)
                   |VALUES (?, ?, ?, ?, ?, ?, ?, ?);";

    МассивПараметров = Новый Массив;
    МассивПараметров.Добавить(Новый Структура("TEXT"  , "Vitaly"));
    МассивПараметров.Добавить(Новый Структура("INT"   , 25));
    МассивПараметров.Добавить(Новый Структура("DOUBLE", 1000.12));
    МассивПараметров.Добавить(Новый Структура("FLOAT" , 1000.12));
    МассивПараметров.Добавить(Новый Структура("UINT"  , 1));
    МассивПараметров.Добавить(Новый Структура("DATE"  , OPI_Инструменты.ПолучитьТекущуюДату()));
    МассивПараметров.Добавить(Новый Структура("TIME"  , OPI_Инструменты.ПолучитьТекущуюДату()));
    МассивПараметров.Добавить(Новый Структура("BYTES" , Картинка));

    Результат = OPI_MySQL.ВыполнитьЗапросSQL(ТекстЗапроса, МассивПараметров, , Соединение);

    // SELECT (Результат этого запроса приведен в следующем блоке)

    ТекстЗапроса = "SELECT name, age, salary, amount, type, date, time, data FROM test_table;";

    Результат = OPI_MySQL.ВыполнитьЗапросSQL(ТекстЗапроса, , , Соединение);

    // SQL запрос из файла

    ФайлSQL = "https://hut.openintegrations.dev/test_data/TEST_DATA2.sql"; // Двоичные данные, URL или путь к файлу

    Результат = OPI_MySQL.ВыполнитьЗапросSQL(ФайлSQL, , , Соединение);

    Закрытие = OPI_MySQL.ЗакрытьСоединение(Соединение);

Bash

    # JSON данные также могут быть переданы как путь к файлу .json
    
    oint mysql ВыполнитьЗапросSQL \
      --sql "SELECT 1 AS n" \
      --dbc "mysql://bayselonarrend:***@127.0.0.1:3306/" \
      --tls "{'accept_invalid_certs':true,'ca_cert_path':'','use_tls':true}"

CMD/Bat

    :: JSON данные также могут быть переданы как путь к файлу .json
    
    oint mysql ВыполнитьЗапросSQL ^
      --sql "SELECT 1 AS n" ^
      --dbc "mysql://bayselonarrend:***@127.0.0.1:3306/" ^
      --tls "{'accept_invalid_certs':true,'ca_cert_path':'','use_tls':true}"

Результат

{
 "data": [
  {
   "age": 25,
   "amount": 1000.11999511719,
   "data": {
    "BYTES": "Base64"
   },
   "date": "2026-05-26T00:00:00+00:00",
   "name": "Vitaly",
   "salary": 1000.12,
   "time": "1970-01-01T17:32:24+00:00",
   "type": 1
  }
 ],
 "result": true
}