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

Гарантировать записи

Добавляет записи или обновляет данные существующих при совпадении ключевых полей

Функция ГарантироватьЗаписи(Знач Таблица, Знач МассивДанных, Знач КлючевыеПоля = "", Знач Транзакция = Истина, Знач Соединение = "", Знач Tls = "") Экспорт

ПараметрCLI опцияТипОбяз.Назначение
Таблица--tableСтрока✔Имя таблицы
МассивДанных--rowsМассив Из Структура✔Массив структур данных строк: Ключ > поле, Значение > значение поля
КлючевыеПоля--uniqueМассив Из Строка✖Имя или имена ключевых полей таблицы для проверки уникальности
Транзакция--trnБулево✖Истина > добавление записей в транзакции с откатом при ошибке
Соединение--dbСтрока, Произвольный✖Существующее соединение или путь к базе
Tls--tlsСтруктура Из КлючИЗначение✖Настройки TLS, если необходимо. См. ПолучитьНастройкиTls

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

подсказка

В качестве ключевых можно указывать UNIQUE и PRIMARY KEY поля


Пример использования для 1С:Предприятие/OneScript
    Адрес  = "127.0.0.1";
    Логин  = "bayselonarrend";
    Пароль = "12we...";
    База   = "testbase1";

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

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

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

    МассивДанных = Новый Массив;

    СтруктураСтроки1 = Новый Структура;
    СтруктураСтроки1.Вставить("id"    , Новый Структура("INT" , 1));
    СтруктураСтроки1.Вставить("name"  , Новый Структура("TEXT", "Vitaly"));
    СтруктураСтроки1.Вставить("age"   , Новый Структура("INT" , 25));
    СтруктураСтроки1.Вставить("salary", Новый Структура("REAL", 1000.12));

    СтруктураСтроки2 = Новый Структура;
    СтруктураСтроки2.Вставить("id"    , Новый Структура("INT" , 2));
    СтруктураСтроки2.Вставить("name"  , Новый Структура("TEXT", "Lesha"));
    СтруктураСтроки2.Вставить("age"   , Новый Структура("INT" , 20));
    СтруктураСтроки2.Вставить("salary", Новый Структура("REAL", 200.20));

    МассивДанных.Добавить(СтруктураСтроки1);
    МассивДанных.Добавить(СтруктураСтроки2);

    КлючевыеПоля = Новый Массив;
    КлючевыеПоля.Добавить("id");

    Результат = OPI_PostgreSQL.ГарантироватьЗаписи(Таблица, МассивДанных, КлючевыеПоля, , СтрокаПодключения, НастройкиTLS);
    # JSON данные также могут быть переданы как путь к файлу .json
    
    oint postgres ГарантироватьЗаписи \
      --table "test_merge" \
      --rows "[{'id':{'INT':'1'},'name':{'TEXT':'Vitaly Updated'},'age':{'INT':'25'},'salary':{'REAL':'1500.5'}},{'id':{'INT':'3'},'name':{'TEXT':'Anton'},'age':{'INT':'30'},'salary':{'REAL':'3000'}}]" \
      --unique "['id']" \
      --db "postgresql://bayselonarrend:12we3456!2154@127.0.0.1:5433/testbase1" \
      --tls "{'use_tls':true,'accept_invalid_certs':true}"