OUTFILE

Формат

{OUTFILE|OUTFIL}: [<​спецификация файла​>]|[CON]

Назначение

Спецификация выходного файла.

Описание

По умолчанию результаты выполнения команд и/или SQL-операторов inl выводит на экран терминала пользователя (выходной файл по умолчанию). Для переназначения вывода используется команда OUTFILE:. Параметр <​спецификация файла​> задает местоположение и имя выходного текстового файла в формате соответствующей операционной системы, например, C:\linter\test\crt_table.tst.

Если в качестве выходного файла указано CON, то текущий выходной файл закрывается и вывод осуществляется на терминал.

В выходной файл записываются:

  1. выборка данных select-запроса (в форматированном или неформатированном виде);

  2. заголовок выборки данных (определенный командой HEADER:);

  3. итоговая статистика.

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

  • устройство и каталог (каталоги), указанные в <​спецификации файла​> должны существовать на момент выполнения команды (автоматически не создаются);

  • если не указано местоположение выходного файла, он создается в текущем каталоге;

  • данные в выходной файл записываются в коде ASCII;

  • результаты выполнения SQL-оператора будут направляться в файл, определенный командой OUTFILE:, до тех пор, пока не будет произведено новое назначение выходного файла. При этом выходной файл, открытый предшествующей командой OUTFILE:, закроется и откроется новый специфицированный файл;

  • если в OUTFILE: указан файл, который уже существует, то выходные данные добавляются в этот файл;

  • комментарии, коды завершения и их диагностические сообщения всегда выдаются на экран терминала;

  • команда OUTFILE: может быть введена как с терминала, так и из SQL-скрипта;

  • если параметр <​спецификация файла​> не указан, то в качестве выходного файла используется экран терминала.

Примечания

  1. При запуске inl выходным файлом по умолчанию установлен экран терминала.

  2. Узнать текущее имя выходного файла можно с помощью команды LIST.

Примеры

SQL​>outfile:/usr/home/Fill.ans (в среде ОС Linux, ЗОСРВ Нейтрино)

;создание выходного файла в текущем каталоге
SQL​>outfile:tst
…

;создание другого выходного файла в заданном каталоге
SQL​>outfile:d:/linter/script/crt_db.sql
…
;перенаправление вывода на экран терминала
SQL​>outfile:con
…
;продолжение вывода в файл tst
SQL​>outfile:tst
…