Доступные версии документации

Ключи

Для передачи программе параметров используется набор ключей, позволяющих однозначно интерпретировать вид параметра. Все ключи имеют уникальное мнемоническое обозначение. Ключи в командной строке можно располагать в любой последовательности (за одним исключением: если используются оба ключа -h и -c, то ключ -c должен следовать первым, чтобы сообщения, выводимые ключом -h, отображались в указанной кодировке).

Примечания

  1. Команды и ключи допускается вводить как малыми, так и большими буквами.

  2. При вводе значений ключей (имена, пароли, наименования таблиц и т.п.) малые и большие буквы различаются.

  3. Если задан ключ, не относящийся к команде, то ошибка не фиксируется, а ключ программой не обрабатывается (игнорируется).

  4. Признаком ключа является знак минус «-», альтернативный признак ключа / (обратная косая черта) допустим во всех ОС, кроме UNIX.

  5. Для получения справочной информации о ключах программы необходимо задать в командной строке символ -? или -h.

  6. Имена файлов в командах и/или ключах должны задаваться полностью, расширения по умолчанию не допускаются.

Ниже перечислены используемые утилитой ключи с описанием их применения.

Ключ

Описание

-u

Идентификация пользователя с аргументами <имя пользователя> и <пароль пользователя>. Если пароль не указан, он считается состоящим из одних пробелов

-n

Идентификация имени ЛИНТЕР-сервера. Имеет смысл только при работе в сети. Для подключения к удаленному ЛИНТЕР-серверу необходимо настроить сетевые средства СУБД ЛИНТЕР в соответствии с документом «СУБД ЛИНТЕР. Сетевые средства». Имя <сервера> из ключа должно соответствовать имени одному из удаленных ЛИНТЕР-серверов, указанных в файле сетевой конфигурации СУБД ЛИНТЕР nodetab

-f

Определение имени файла, содержащего SQL-запрос (серию или пакет SQL-запросов), подлежащий выполнению

-p

При работе в пакетном режиме задает имя текстового файла с паролями пользователей.

Формат строк файла:
<имя пользователя>/[<пароль>]

Если <пароль> не задан, он будет запрошен интерактивно с консоли.

Особенности использования ключа -p одновременно с ключом

-u <имя пользователя>[/[<пароль пользователя>]]:

1) если после имени пользователя в ключе -u знак «/» присутствует, то подразумевается, что пароль задан (он будет пустым, если после знака «/» нет символов пароля), и в этом случае ключ -p игнорируется;

2) если после имени пользователя в ключе -u знака «/» нет, то пароль не задан, и тогда при наличии ключа -p пароль берется из файла.

Параметры файла паролей:

  • максимальное количество строк: 100 (лишние строки игнорируются);

  • максимальная длина строки: 100 байтов;

  • кодировка текста: ASCII.

Ключ -p может задаваться не только в паре с ключом -f, но и отдельно, в частности, при вводе в командной строке имени пользователя без пароля.

Пример.

inl -u SYSTEM/ -p pwd.txt

Inl выдаст сообщение о неверном пароле, если пароль у пользователя SYSTEM не пустой.

Если в файле pwd.txt задан пароль для пользователя SYSTEM – он будет взят из файла. Если нет, то будет запрошен интерактивно

-t

Отключение выдачи временно́й статистики (см. команду TIME)

-s

Запрещает выдачу на экран диагностического сообщения:

  • кода завершения 2202 при удалении объекта из БД (т.е. в БД нет удаляемого объекта);

  • кода завершения 2310 (неизвестная глобальная переменная).

Игнорируются ошибки удаления CHARACTER SET и TRANSLATION.

На все другие диагностические сообщения, связанные с операцией удаления объекта (например, синтаксическая ошибка в SQL-запросе, отсутствие привилегий и т.п.) действие ключа не распространяется. Также запрещает выдачу на экран диагностического сообщения c уведомлением об удалении несуществующих объектов

-q

Запрет выдачи информации об авторских правах

-ia

Заставляет игнорировать любой код завершения SQL-запроса и продолжать работу программы

-i

Включает игнорирование выдачи диагностического сообщения для указанного <кода завершения> (см. команду IGNORE). Ключей -i, включающих различные коды завершения, в SQL-скрипте может быть несколько, при этом ключ действует как переключатель: если <код завершения> еще не установлен, то он устанавливается, если уже установлен, то сбрасывается

Примечание

Список установленных по ключу -i кодов завершения можно просмотреть по команде LIST

-sm

Задает имя схемы. При указании этого ключа сразу после открытия канала выполняется команда SET SCHEMA <имя схемы> (при возникновении ошибки выполнения этой команды канал закрывается)

-es

Заставляет выдавать на экран тексты запросов при ошибках, отличных от ошибок синтаксиса/логики

-nh

Запрет  выдачи заголовка

-nc

Запрет выдачи итоговой статистики о выполненных SQL-запросах (число найденных/обработанных записей и длительность обработки запроса – см. команду COUNT)

-ns

Запрет выдачи разделителя столбцов (см. команду UNLOAD)

-nl

Запрет выдачи разделителя столбцов в начале и конце записей выборки данных (см. команду UNLOAD)

-nf

Запрещает дополнять выдаваемое значение до ширины столбца

-c

Задает кодировку подаваемых утилитой inl ядру СУБД ЛИНТЕР SQL-запросов и кодировку выводимых inl сообщений. Возможные значения: cp866, cp1251, koi8-r, utf-8. Если значение кодировки отличается от перечисленного, то для запросов в ядре СУБД будет использована кодировка по умолчанию для платформы ОС, а текст сообщений inl будет выводиться на английском языке

-ci

Задает кодовую страницу для интерфейса утилиты.

Если ключ не задан, по умолчанию используется язык операционной системы.

Если кодовая страница задана неверно или не установлена в ОС, используется англоязычный интерфейс.

Примеры:

-ci cp866 (русскоязычный интерфейс)

-ci cp437 (англоязычный интерфейс)

-h или ?

Выдает на экран справочную информацию и завершает выполнение программы. Если в командной строке заданы другие ключи, то они игнорируются

-nohist

Запрещает протоколирование выполняемых команд с целью последующего отображения по команде HISTORY

Примечание

Действует только в среде ОС типа UNIX

-dis

Задает игнорирование inl-команд BROWSE, EDIT, EXIT, QUIT, PAGE, SH

Примечание

Используется при запуске командного inl из web-сервисной версии inl

-onpromt

Заставляет выдавать подсказку SQL> при работе в потоковом режиме

Примечание

Используется при запуске командного inl из web-сервисной версии inl

-version

Полная информация о версии программы

-briefversion

Номер версии сборки программы

Принятые умолчания

  1. Ключи регистронезависимы.

  2. Если при запуске опущен ключ -u (вместе с аргументами), то прежде чем приступить к работе, inl запрашивает у пользователя имя и пароль.

  3. Если опущен ключ -n, то inl будет работать с сервером по умолчанию.

  4. При отсутствии ключа -f программа переходит в интерактивный режим работы.

  5. При отсутствии ключа -t выдается время начала и окончания обработки каждого SQL-запроса.

  6. Если ключ -c не задан, то берется значение переменной окружения LINTER_CP; если и она не задана, то возьмется национальная кодировка (locale), установленная в ОС.

Примечания

  1. При вводе пароля вводимые символы маскируются.

  2. При запуске inl ей можно передавать команду для выполнения, например:

    echo 'select * from auto;' | INL -u SYSTEM/MANAGER

  3. Команды с ключами -version и -briefversion могут выполняться при неактивном ядре СУБД ЛИНТЕР:

    INL -version
    INL -briefversion

Пример

Для запуска программы:

  1. набрать имя программы и нажать клавишу <Enter>:

    INL <Enter>
  2. появится заставка программы и приглашение для ввода имени пользователя:

    Интерактивный SQL в.6.0.0 СУБД ЛИНТЕР в.6.0
    Имя пользователя: SYSTEM
  3. после ввода имени пользователя появится приглашение для ввода пароля пользователя:

    Пароль пользователя:MANAGER
  4. если регистрационные параметры введены правильно, появится подсказка готовности к работе:

    SQL>
Заметили ошибку?
Выделите текст и нажмите Ctrl + Enter