Приложение 1. Командный интерфейс программы

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

Все ключи и параметры командной строки соответствуют ключам, применяемым в консольных утилитах loarel и dbstore. Описание всех этих ключей см. в соответствующей документации («СУБД ЛИНТЕР. Импорт данных», подраздел «Ключи», «СУБД ЛИНТЕР. Экспорт структур и данных», раздел «Ключи»).

Для необходимости указать, какие из ключей какой программы следует использовать, следует первым аргументом указывать:

D – если необходимо использовать ключи программы dbstore (см. документ «СУБД ЛИНТЕР. Экспорт структур и данных», раздел «Ключи»);

L – если необходимо использовать ключи программы loarel (см. документацию по loarel «СУБД ЛИНТЕР. Импорт данных», подраздел «Ключи»);

S – необходимо использовать ключи восстановления структуры;

R – необходимо использовать ключи полного восстановления.

После этих аргументов необходимо использовать соответствующие ключи.

Для всех параметров стандартные параметры соединения задаются через ключи –u ИМЯ_ПОЛЬЗОВАТЕЛЯ/ПАРОЛЬ и –n ИМЯ_УЗЛА.

Для параметров восстановления структуры и полного восстановления (S или R):

-sys КАТАЛОГ – создавать системные таблицы из указанного каталога. Параметр обязателен. Если ключ не указан, то таблицы создаваться не будут.

-create КАТАЛОГ – восстанавливать структуру (если используется ключ S) или структуру и данные (если используется ключ R) на основании файлов, расположенных в указанном каталоге. Параметр обязателен.

Примеры

Необходимо произвести экспорт структуры и данных таблицы ERRORS в каталог ERROR. В командной строке вводим:

migration D -u SYSTEM/MANAGER8 -ot ERRORS -d ERROR

Если в базе данных присутствует указанная таблица, то будет открыто окно вывода результатов и программа сохранит таблицу ERRORS (рис. П1.1).

Протокол сохранения БД
Рисунок П1.1. Протокол сохранения БД

Главного меню программы показано не будет.

После нажатия кнопки Закрыть (рис. П1.2) программа завершит свою работу.

Статистическая информация о сохраненной БД
Рисунок П1.2. Статистическая информация о сохраненной БД

В каталоге ERROR появятся файлы: create_2.bat, idx_0001.sql, tab_0001.sql и SYSTEM.lod\ERRORS.lod, содержащий данные из таблицы ERRORS.

Следующая задача: восстановить эту таблицу из каталога ERROR в другую базу данных.

Вводим в командной строке:

migration R -u SYSTEM/MANAGER8 -create ERROR

Откроется окно вывода результатов. Сначала будет произведена попытка создать таблицу, затем будут загружаться в нее данные. После этого будет создан индекс по первому столбцу (рис. П1.3).

Протокол восстановления БД
Рисунок П1.3. Протокол восстановления БД

Если просто необходимо загрузить уже существующую таблицу ERRORS из имеющегося файла загрузки ERRORS.lod, который лежит в каталоге ERROR\SYSTEM.lod, то можно ввести в командной строке:

migration L -u SYSTEM/MANAGER8 -t ERRORS -d ERROR\SYSTEM.lod

Будет открыто окно вывода результатов, и программа приступит к загрузке таблицы (рис. П1.4):

Протокол восстановления объекта БД
Рисунок П1.4. Протокол восстановления объекта БД

Более подробные примеры использования параметров, передаваемых в командной строке см. также в документацию по программам loarel и dbstore («СУБД ЛИНТЕР. Импорт данных», приложение «Примеры использования утилиты», «СУБД ЛИНТЕР. Экспорт структур и данных», приложение «Примеры использования утилиты»).

Все команды сохранения, восстановления можно осуществлять как с использованием основного меню программы (для этого программу необходимо запускать без дополнительных параметров), так и с помощью командной строки. Какой из вариантов удобнее – каждый решает сам.