Гарантировать таблицу

Создает новую таблицу в случае отсутствия или обновляет состав колонок существующей таблицы

Параметры

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

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

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

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

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

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

подсказка

В результате изменения структуры таблицы данные могут быть утеряны! Рекомендуется предварительно опробовать данный метод на тестовых данных

Данная функция не обновляет тип данных существующих колонок

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

    База = "/tmp/vnnmoosn.qqb.sqlite";

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

    СтруктураКолонок = Новый Структура;
    СтруктураКолонок.Вставить("id"        , "INTEGER");
    СтруктураКолонок.Вставить("code"      , "INTEGER");
    СтруктураКолонок.Вставить("name"      , "TEXT");
    СтруктураКолонок.Вставить("age"       , "INTEGER");
    СтруктураКолонок.Вставить("info"      , "TEXT");

    Результат = OPI_SQLite.ГарантироватьТаблицу(Таблица, СтруктураКолонок, База);

Bash

    # JSON данные также могут быть переданы как путь к файлу .json
    
    oint sqlite ГарантироватьТаблицу \
      --table "test_new" \
      --cols "{'id':'INTEGER','code':'INTEGER','name':'TEXT','age':'INTEGER','info':'TEXT'}" \
      --db "/tmp/rb1xmxjp.gza.sqlite"

CMD/Bat

    :: JSON данные также могут быть переданы как путь к файлу .json
    
    oint sqlite ГарантироватьТаблицу ^
      --table "test_new" ^
      --cols "{'id':'INTEGER','code':'INTEGER','name':'TEXT','age':'INTEGER','info':'TEXT'}" ^
      --db "/tmp/rb1xmxjp.gza.sqlite"

Результат

{
 "result": true,
 "commit": {
  "result": true
 }
}