Приложение 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.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).
Если просто необходимо загрузить уже существующую таблицу ERRORS
из имеющегося файла загрузки ERRORS.lod
, который лежит в каталоге ERROR\SYSTEM.lod
, то можно ввести в командной строке:
migration L -u SYSTEM/MANAGER8 -t ERRORS -d ERROR\SYSTEM.lod
Будет открыто окно вывода результатов, и программа приступит к загрузке таблицы (рис. П1.4):
Более подробные примеры использования параметров, передаваемых в командной строке см. также в документацию по программам loarel и dbstore («СУБД ЛИНТЕР. Импорт данных», приложение «Примеры использования утилиты», «СУБД ЛИНТЕР. Экспорт структур и данных», приложение «Примеры использования утилиты»).
Все команды сохранения, восстановления можно осуществлять как с использованием основного меню программы (для этого программу необходимо запускать без дополнительных параметров), так и с помощью командной строки. Какой из вариантов удобнее – каждый решает сам.