Подключение SQLite

Используется для подключения к базе данных SQLite.

Данное подключение так же реализует следующие особенности работы с импортом баз данных:

  • Наряду со стандартными правилами сравнения символов (collation) BINARY, RTRIM и NOCASE возможно использование нижеследующих, не регламентированных стандартом SQLite:
    • UNICODE — языконезависимое сравнение символов Unicode чувствительное к регистру.
    • LOCALIZED — языкозависимое сравнение символов Unicode чувствительное к регистру. Результат сравнения строк зависит от локали операционной системы сервера Loginom.
  • В SQL конструкциях возможно использование функции iLIKE, реализующей функциональность LIKE в режиме регистронезависимости символов Unicode.
  • Проверка по внешним ключам включена по умолчанию.

Параметры подключения

При настройке подключения задаются следующие параметры:

  • Метка — содержит задаваемое пользователем имя подключения.
  • База данных в памяти — по умолчанию отключено. При выставленном флаге будет создано подключение к in-memory БД c общим кэшем.

  • Имя файла — указывается путь к файлу БД, содержащей необходимые данные. Параметры можно ввести вручную или нажатием кнопки вызвать окно Открыть файл.

    Если выставлен флаг «База данных в памяти», то необходимо обязательно задать идентификатор БД. Он может состоять из:

    • символов латинского алфавита;
    • цифр;
    • слэша;
    • подчеркивания;
    • точки.
  • Тестировать — тест указанных настроек подключения.

Примечание: Если опция Спрашивать пароль активна, то при тестировании подключения будет запрошен логин/пароль.

  • Логин — логин при подключении к SQLite не используется.
  • Пароль — указывается пароль, установленный пользователем БД для защиты данных.
  • Спрашивать пароль — при установке этого флага, пароль, введенный в мастере настройки, не сохранится. Он будет запрошен единовременно при первой активации Импорта или Экспорта из БД и больше не будет запрашиваться до деактивации узла Подключения. Диалоговое окно ввода логина/пароля имеет тайм-аут 60 секунд. Данная опция доступна, если активен флаг Зашифрованная БД.

Примечание: во время работы в Пакетном режиме, а также при запуске пакета из Планировщика задач или через Loginom Integrator при включенной опции Спрашивать пароль, будет выполняться попытка подключения без пароля (логи будут содержать сообщение о том, что пароль не указан).

  • Зашифрованная БД — флаг устанавливает режим шифрования БД. Данный режим использует алгоритм шифрования AES256 и предусматривает использование пароля.
  • Размер кэша — устанавливает размер кэша. Действие параметра аналогично выполнению команды БД "PRAGMA schema.cache_size = pages | -kibibytes;", где при введении положительного числа указывается количество памяти в страницах, а при введении отрицательного — выделение памяти в КиБ.
  • Режим синхронизации — устанавливается режим синхронизации с файловой системой. Выбор данного режима влияет на быстродействие БД, без синхронизации повышая быстродействие с наименьшей защищенностью от сбоев, и с уменьшением быстродействия в счет наибольшей защищенности от сбоев. Действие параметра аналогично выполнению команды БД "PRAGMA schema.synchronous = 0 | OFF | 1 | NORMAL | 2 | FULL | 3 | EXTRA;" и предусматривает выбор из следующих вариантов:
    • По умолчанию используется режим FULL (Полная).
    • Отключена (OFF).
    • Нормальный (NORMAL).
    • Полная (FULL).
    • Экстра (EXTRA).
  • Режим журнала транзакций — устанавливается режим работы журнала транзакций. Действие параметра аналогично выполнению команды БД: "PRAGMA schema.journal_mode = DELETE | TRUNCATE | PERSIST | MEMORY | WAL;" и предусматривает выбор из следующих вариантов.
    • По умолчанию используется режим DELETE (Удаление файла).
    • Удаление файла (DELETE).
    • Очистка содержимого (TRUNCATE).
    • Обнуление заголовка (PERSIST).
    • Хранение в памяти (MEMORY).
    • Упреждающая запись (WAL).
  • Хранилище TEMP — определяет место хранения временных файлов. Действие параметра аналогично выполнению команды БД "PRAGMA temp_store = 0 | DEFAULT | 1 | FILE | 2 | MEMORY;" и предусматривает выбор из следующих вариантов:
    • По умолчанию — для незашифрованной БД принято Файловая система, для зашифрованной БД — Оперативная память.
    • Файловая система.
    • Оперативная память.
  • NOCASE в режиме UNICODE — флаг переопределяет сравнение NOCASE как UNICODE — языконезависимое сравнение символов Unicode без чувствительности к регистру.
  • lower, upper для UNICODE — флаг расширяет действия функций lower, upper на все символы UNICODE. Без задействований данной опции функции lower, upper работают только для букв латинского алфавита.
  • Режим работы LIKE — предлагается выбрать один из вариантов сравнения символов при использовании функции LIKE.
    • Без учета регистра ASCII символов.
    • С учетом регистра.
    • Без учета регистра.
  • Создавать БД, если не существует — при установке флага, указанная в параметре Строка подключения база данных будет создана, если таковая не существует. Новая БД создается в кодировке UTF-16.
  • Показывать системные таблицы — при установке этого флага в мастере импорта, использующего данное подключение, становятся видимы доступные пользователю системные таблицы БД.
  • Обрамлять имена кавычками — если имена объектов базы данных (например, имена таблиц, полей) содержат пробелы или зарезервированные символы, то необходимо использовать обрамляющие символы, фиксирующие начало и конец имени.
  • Не использовать клиент СУБД — для SQLite этот параметр не доступен.
  • Очищать пул при деактивации — при включенном флаге пул подключений, связанный с узлом Подключения, очищается сразу при деактивации узла. При отключенном флаге подключения начинают постепенно деактивироваться и удаляться из пула после деактивации узла.
  • Комментарий — в этой форме можно оставить любую справочную информацию о подключении.

Примечание: Для подключения к базе данных используются библиотеки sqlite3.dll и sqlcipher.dll, совпадающие по разрядности с приложением/сервером Loginom. Данные библиотеки поставляются в составе дистрибутива Loginom. При использовании сторонних библиотек возможно переопределение значений по умолчанию параметров Режим синхронизации и Режим журнала транзакций.

Совместимость

Версии 3.0 и выше.

Смотри также: