Обновить записи

Обновляет значение записей по выбранным критериям

Параметры

Функция ОбновитьЗаписи(Знач Таблица, Знач СтруктураЗначений, Знач Фильтры = "", Знач Соединение = "", Знач Tls = "") Экспорт

Параметр	CLI опция	Тип	Обяз.	Назначение
Таблица	--table	Строка	✔	Имя таблицы
СтруктураЗначений	--values	Структура Из КлючИЗначение	✔	Структура значений: Ключ > поле, Значение > значение поля
Фильтры	--filter	Массив Из Структура	✖	Массив фильтров. См. ПолучитьСтруктуруФильтраЗаписей
Соединение	--dbc	Строка, Произвольный	✖	Соединение или строка подключения
Tls	--tls	Структура Из КлючИЗначение	✖	Настройки TLS, если необходимо. См. ПолучитьНастройкиTls

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

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

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

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

подсказка

Данные записей указываются как массив структур вида:
{'Имя поля 1': {'Тип данных': 'Значение'}, 'Имя поля 2': {'Тип данных': 'Значение'},...}

Список доступных типов описан на начальной странице документации библиотеки MySQL

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

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

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

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

    Таблица = "test_data";

    СтруктураПолей = Новый Структура;
    СтруктураПолей.Вставить("ip_address", Новый Структура("VARCHAR", "127.0.0.1"));

    Фильтры = Новый Массив;

    СтруктураФильтра = Новый Структура;

    СтруктураФильтра.Вставить("field", "gender");
    СтруктураФильтра.Вставить("type" , "=");
    СтруктураФильтра.Вставить("value", Новый Структура("VARCHAR", "Male"));
    СтруктураФильтра.Вставить("raw"  , Ложь);

    Фильтры.Добавить(СтруктураФильтра);

    // При использовании строки подключения инициализируется новое соединение,
    // которое будет закрыто после выполнения функции.
    // В случае выполнения нескольких операций желательно использовать одно соединение,
    // заранее созданное функцией ОткрытьСоединение()
    Результат = OPI_MySQL.ОбновитьЗаписи(Таблица, СтруктураПолей, СтруктураФильтра, СтрокаПодключения, НастройкиTLS);

Bash

    # JSON данные также могут быть переданы как путь к файлу .json
    
    oint mysql ОбновитьЗаписи \
      --table "test_data" \
      --values "{'ip_address':{'VARCHAR':'127.0.0.1'}}" \
      --filter "{'field':'gender','type':'=','value':{'VARCHAR':'Male'},'raw':false}" \
      --dbc "mysql://bayselonarrend:***@127.0.0.1:3306/" \
      --tls "{'use_tls':true,'accept_invalid_certs':true}"

CMD/Bat

    :: JSON данные также могут быть переданы как путь к файлу .json
    
    oint mysql ОбновитьЗаписи ^
      --table "test_data" ^
      --values "{'ip_address':{'VARCHAR':'127.0.0.1'}}" ^
      --filter "{'field':'gender','type':'=','value':{'VARCHAR':'Male'},'raw':false}" ^
      --dbc "mysql://bayselonarrend:***@127.0.0.1:3306/" ^
      --tls "{'use_tls':true,'accept_invalid_certs':true}"

Результат

{
 "result": true
}