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

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

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

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

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

подсказка

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

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

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

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

    База    = "testbase1";
    Таблица = "testtable";

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

    СтруктураКолонок = Новый Структура;
    СтруктураКолонок.Вставить("smallint_field" , "smallint");
    СтруктураКолонок.Вставить("double_field"   , "real");
    СтруктураКолонок.Вставить("bigint_field"   , "bigint");
    СтруктураКолонок.Вставить("custom_field"   , "nvarchar");

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