Ключи
Для передачи программе параметров используется набор ключей,
позволяющих однозначно интерпретировать вид параметра. Все ключи
имеют уникальное мнемоническое обозначение. Ключи в командной строке
можно располагать в любой последовательности (за одним исключением:
если используются оба ключа -h
и -c
, то ключ -c
должен следовать первым, чтобы сообщения, выводимые ключом
-h
, отображались в указанной кодировке).
Примечания
-
Команды и ключи допускается вводить как малыми, так и большими буквами.
-
При вводе значений ключей (имена, пароли, наименования таблиц и т.п.) малые и большие буквы различаются.
-
Если задан ключ, не относящийся к команде, то ошибка не фиксируется, а ключ программой не обрабатывается (игнорируется).
-
Признаком ключа является знак минус «-», альтернативный признак ключа «/» (обратная косая черта) допустим во всех ОС, кроме UNIX.
-
Для получения справочной информации о ключах программы необходимо задать в командной строке ключ
-?
или-h
. -
Имена файлов в командах и/или ключах должны задаваться полностью, расширения по умолчанию не допускаются.
Ниже перечислены используемые утилитой ключи с описанием их применения (таблица 1).
Ключ |
Описание |
---|---|
-u
|
Идентификация пользователя с аргументами
|
|
Идентификация имени ЛИНТЕР-сервера. Имеет смысл только при
работе в сети. Для подключения к удаленному ЛИНТЕР-серверу
необходимо настроить сетевые средства СУБД ЛИНТЕР в
соответствии с документом «СУБД ЛИНТЕР. Сетевые средства»,
раздел «Файл сетевой конфигурации». Имя
< сервера > из ключа должно соответствовать имени одному из
удаленных ЛИНТЕР-серверов, указанных в файле сетевой
конфигурации СУБД ЛИНТЕР |
|
Определение имени файла, содержащего SQL-запрос (серию или пакет SQL-запросов), подлежащий выполнению |
|
При работе в пакетном режиме задает имя текстового файла с паролями пользователей. Формат строк файла: Если < пароль > не задан, он будет запрошен интерактивно с консоли. Особенности использования ключа
1) если после имени пользователя в ключе
2) если после имени пользователя в ключе
Параметры файла паролей:
Ключ
Пример. inl -u SYSTEM/ -p pwd.txt Inl выдаст сообщение о неверном пароле, если пароль у пользователя SYSTEM не пустой. Если в файле |
|
Отключение выдачи временно́й статистики (см. команду TIME) |
|
Запрещает выдачу на экран диагностического сообщения:
Игнорируются ошибки удаления CHARACTER SET и TRANSLATION. На все другие диагностические сообщения, связанные с операцией удаления объекта (например, синтаксическая ошибка в SQL-запросе, отсутствие привилегий и т.п.) действие ключа не распространяется. Также запрещает выдачу на экран диагностического сообщения c уведомлением об удалении несуществующих объектов |
|
Запрет выдачи информации об авторских правах |
|
Заставляет игнорировать любой код завершения SQL-запроса и продолжать работу программы |
|
Включает
игнорирование выдачи диагностического сообщения для указанного
< кода завершения > (см. команду
IGNORE).
Ключей Примечание
Список установленных по ключу
|
|
Задает имя схемы. При указании этого ключа сразу после открытия канала выполняется команда SET SCHEMA < имя схемы > (при возникновении ошибки выполнения этой команды канал закрывается) |
|
Заставляет выдавать на экран тексты запросов при ошибках, отличных от ошибок синтаксиса/логики |
|
Запрет выдачи заголовка |
|
Запрет выдачи итоговой статистики о выполненных SQL-запросах (число найденных/обработанных записей и длительность обработки запроса – см. команду COUNT) |
|
Запрет выдачи разделителя столбцов (см. команду UNLOAD) |
|
Запрет выдачи разделителя столбцов в начале и конце записей выборки данных (см. команду UNLOAD) |
|
Запрещает дополнять выдаваемое значение до ширины столбца |
|
Задает кодовую страницу для интерфейса утилиты. Если ключ не задан, по умолчанию используется язык операционной системы. Если кодовая страница задана неверно или не установлена в ОС, используется англоязычный интерфейс. Примеры: -ci cp866 (русскоязычный интерфейс) -c ENG (англоязычный интерфейс) |
|
Выдает на экран справочную информацию и завершает выполнение программы. Если в командной строке заданы другие ключи, то они игнорируются |
|
Запрещает протоколирование выполняемых команд с целью последующего отображения по команде HISTORY ПримечаниеДействует только в среде ОС типа UNIX |
|
Задает игнорирование inl-команд BROWSE, EDIT, EXIT, QUIT, PAGE, SH ПримечаниеИспользуется при запуске командного inl из web-сервисной версии inl |
|
Заставляет выдавать подсказку SQL > при работе в потоковом режиме ПримечаниеИспользуется при запуске командного inl из web-сервисной версии inl |
|
Полная информация о версии программы |
|
Номер версии сборки программы |
Принятые умолчания
-
Ключи регистронезависимы.
-
Если при запуске опущен ключ
-u
(вместе с аргументами), то прежде чем приступить к работе, inl запрашивает у пользователя имя и пароль. -
Если опущен ключ
-n
, то inl будет работать с сервером по умолчанию. -
При отсутствии ключа
-f
программа переходит в интерактивный режим работы. -
При отсутствии ключа
-t
выдается время начала и окончания обработки каждого SQL-запроса. -
Если ключ
-c
не задан, то берется значение переменной окружения LINTER_CP; если и она не задана, то возьмется национальная кодировка (locale), установленная в ОС.
Примечания
-
При вводе пароля вводимые символы маскируются.
-
При запуске inl ей можно передавать команду для выполнения, например:
echo 'select * from auto;' | INL -u SYSTEM/MANAGER8
-
Команды с ключами
-version
и-briefversion
могут выполняться при неактивном ядре СУБД ЛИНТЕР:INL -version INL -briefversion
Пример
Для запуска программы:
-
набрать имя программы и нажать клавишу < Enter >:
INL < Enter >
-
появится заставка программы и приглашение для ввода имени пользователя:
Интерактивный SQL в.6.0.0 СУБД ЛИНТЕР в.6.0 Имя пользователя: SYSTEM
-
после ввода имени пользователя появится приглашение для ввода пароля пользователя:
Пароль пользователя:MANAGER8
-
если регистрационные параметры введены правильно, появится подсказка готовности к работе:
SQL >