Документация Algorius Net Viewer | База данных

Общие сведения

Для работы Algorius Net Viewer требуется доступ к базе данных. По умолчанию используется встроенная база данных (SQLite). Можно использовать внешние базы данных (Oracle, MySQL, PostgreSQL, MS/SQL).

В базе данных приложения Algorius Net Viewer хранится следующая информация:

В базе данных сервера Algorius Net Viewer дополнительно хранятся следующая информация:

Каждая инстанция приложения и сервера должна использовать свою базу данных. Не допускается использование одной базы данных разными инстанциями приложения или сервера.

Инициализация

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

Производительность

Algorius Net Viewer по умолчанию использует встроенную базу данных SQLite. Данные в ней хранятся в едином файле, доступ к которому осуществляется напрямую (без сети), что обеспечивает максимальную производительность. В тоже время, внешние базы данных надежней, обеспечивают лучшую масштабируемость, и обеспечивают различные дополнительные сервисы, например, авторизация, шифрование, ведение резервных копий, внешнее администрирование и т.д. Поэтому для рабочих сред рекомендуется использовать внешнюю базу данных. Из бесплатных баз данных рекомендуется MySQL. Из платных рекомендуется коммерческая версия Oracle, она показывает максимальное быстродействие и наиболее компактную форму хранения данных.

Algorius Net Viewer производит запись в базу данных в фоновом режиме, параллельно с основной работой программы. Запись производится транзакционно, массово, используя подготовленный параметризованный запрос. За счет этого обеспечивается высокая производительность добавления новых записей в базу данных: более 5 тысяч записей в секунду на компьютере средней производительности (Core i5).

Настройка

Параметры доступа к базе данных задаются отдельно для приложения и для сервера.

Параметры доступа к базе данных для сервера задаются в Algorius Net Viewer Server Setup на шаге База данных:

Параметры доступа к базе данных для приложения, задаются в настройках приложения в разделе База данных:

Доступны следующие параметры:

  • Тип базы данных — тип используемой базы данных. В зависимости от типа доступны различные параметры для настройки соединения с базой данных.
  • Файл базы данных — только для встроенной (SQLite) базы данных. На сервере файл с базой данных расположен в папке Database в каталоге с данными сервера. Для приложения можно указать произвольное расположение файла встроенной базы данных. В документации SQLite рекомендуется не использовать сетевой диск для расположения файла базы данных. Для переноса встроенной базы данных скопируйте ее файл в требуемое место и укажите его расположение в настройках. После этого можно удалить старый файл, если он вам не требуется.
  • Сервер — только для баз данных MS SQL, Oracle, MySQL, PostgreSQL — имя сервера, на котором расположена база данных. Для Oracle, MySQL, PostgreSQL следует указывать имя хоста или IP адрес. Для MS SQL — имя сервера базы данных согласно настройкам MS SQL, например: SERVER_NAME\SQLEXPRESS
  • Порт — только для баз данных Oracle, MySQL, PostgreSQL — номер сетевого порта для соединения с базой данных. Кнопка сброса позволяет вернуть номер порта по умолчанию для выбранной базы данных.
  • Авторизация — только для баз данных MS SQL, Oracle, MySQL, PostgreSQL — способ авторизации на SQL сервере. Если указана Windows Authentication, то используется проверка подлинности пользователя Windows. Если указано SQL Server Authentication, то указывается логин SQL сервера.
  • Пользователь/пароль — только для баз данных MS SQL, Oracle, MySQL, PostgreSQL — логин для доступа к базе данных. Доступно только если указана авторизация SQL Server Authentication.
  • База данных — только для баз данных MS SQL, MySQL, PostgreSQL — название базы данных, в которой будут созданы таблицы для хранения данных приложения.
  • Сервисное имя — только для базы данных Oracle — сервисное имя базы данных согласно настройкам Oracle, например: XE
  • Строка соединения — только для баз данных ODBC — DSN для соединения с внешней базой данных через ODBC. Обращение к базам данных через ODBC производится посредством ODBC драйвера. Производители практически любой базы данных поставляют соответствующий ODBC драйвер. В строке соединения требуется выбрать DSN, настроенный в приложении "Администратор источников данных ODBC", которое входит в состав Windows. Соединение через ODBC доступно только в настройках приложения для совместимости со старыми версиями. Его использование не рекомендуется.
  • Проверить соединение — проверить соединение с базой данных, используя указанные параметры соединения.

Кэширование информации

Сервер Algorius Net Viewer кэширует в оперативной памяти всю информацию, загруженную из базы данных. Это требуется для повышения производительности приложения. Если вы произвели изменения в базе данных внешними средствами и требуется актуализировать эту информацию на сервере, то нужно очистить кэш. Для очистки кэша выберите требуемый сервер в списке серверов и нажмите Очистить кэш. Очистку кэша можно также выполнить из командной строки.

Экспорт

Экспорт позволяет сохранить информацию из базы данных сервера в архив (ZIP файл) для создания резервной копии, а также для миграции на другую базу данных.

Чтобы выполнить экспорт базы данных, нажмите кнопку Экспорт на панели управления сервером. Откроется окно Экспорт базы данных. Укажите каталог, в котором будет создан ZIP файл. Далее выберите разделы базы данных, которые следует экспортировать: настройки, карты, данные инвентаризации, журнал мониторинга, журнал проведения инвентаризации, журнал Web доступа. После этого выбранные разделы будут сохранены в ZIP файл в указанном каталоге. Для удобства, название ZIP файла будет соответствовать дате и времени на момент выгрузки.

Предусмотрена возможность экспорта с командной строки. Для этого воспользуйтесь следующей командой:

NetViewerServer.exe -data:DATA_DIR -export:DEST [-maps] [-options] [-monitoring-log] [-inventory-cards] [-inventory-log] [-web-log]

где:

  • DATA_DIR — путь до каталога данных сервера.
  • DEST — каталог или zip-файл, в который будет экспортирована информация.
  • -maps, -options, -monitoring-log, -inventory-cards, -inventory-log, -web-log — необязательные аргументы, указывающие, какую информацию требуется экспортировать: карты, настройки, журнал мониторинга, карточки инвентаризации, журнал проведения инвентаризации, журнал Web доступа. Если ни один из этих параметров не указан, то будет экспортированы все вышеуказанные разделы.

Пример, как выгрузить только карты и карточки инвентаризации в каталог:

NetViewerServer.exe "-data:c:\Program Files\Algorius\Application Data\NetViewer" -export:"D:\Export" -maps -inventory_cards

Примечание: не указывайте слэш перед кавычкой (\”), например, "D:\Export\", т.к. синтаксис командной строки воспринимает это, как экранирование кавычки.

При помощи планировщика задач Windows и возможности экспорта с командной строки, можно выполнять экспорт по расписанию, например, ежедневно. Для этого сохраните указанную выше команду в bat-файл и добавьте этот bat-файл в планировщик задач Windows.

Импорт

Импорт позволяет загрузить информацию из архива (ZIP файла) в базу данных. Это позволяет восстановить базу данных их резервной копии, или выполнить миграцию сервера на другую базу.

Чтобы выполнить импорт в базу данных, нажмите кнопку Импорт на панели управления сервером. Укажите ZIP файл, созданный ранее во время экспорта. Затем выберите, какие разделы следует импортировать. Если какой-либо раздел отсутствует в архиве, то его импорт будет недоступен. После этого выбранные разделы будут импортированы в базу данных из архива.

Внимание!

Перед импортом данные в выбранных разделах будут полностью удалены из базы данных. Затем в эти разделы будут импортированы новые данные из файла. На время проведения этой операции, сервер Algorius Net Viewer будет остановлен. Рекомендуется предварительно сделать экспорт данных для создания резервной копии.

При миграции на другую базу данных следует выполнить конфигурирование сервера и на шаге База данных указать параметры доступа к новой базе.