SQL Plus: Создание и выполнение сценариев - Команды BTITLE и TTITLE
ОГЛАВЛЕНИЕ
Команды BTITLE и TTITLE
Утилита SQL*Plus позволяет задавать заголовок для показа в качестве верхнего (команда TTITLE) и нижнего (команда BTITLE) колонтитула на каждой странице отчета. Эти команды имеют следующий синтаксис:
- <команда BTITLE> ::=
- BTI[TLE] [<спецификации печати> <текст или переменная>{ <текст или переменная>}] [<вкл-выкл>]
- <команда TTITLE> ::=
- TTI[TLE] [<спецификации печати> <текст или переменная>{ <текст или переменная>}] [<вкл-выкл>]
- <спецификации печати> ::=
- <спецификация печати>{ <спецификация печати>}
- <спецификация печати> ::=
- COL <позиция>
/ S[KIP] [<количество строк>]
/ TAB <количество табуляций>
/ LE[FT]
/ CE[NTER]
/ R[IGHT]
/ BOLD
/ FORMAT <формат> - <текст или переменная> ::=
- <текст>
/ SQL.LNO / SQL.PNO / SQL.RELEASE / SQL.SQLCODE / SQL.USER
Текст колонтитула необходимо брать в одиночные кавычки, если он состоит из нескольких слов. При выдаче одной из встроенных переменных SQL.* можно указывать конструкцию FORMAT. Соответствующие элементы формата см. в разделе, посвященном команде COLUMN.
Конструкция <вкл-выкл> (ON / OFF) позволяет включать и отключать вывод колонтитулов, не влияя на их определения.
Назначение спецификаций печати команд BTITLE и TTITLE представлено в табл. 11.
Таблица 11. Спецификации печати в командах BTITLE, TTITLE, REPHEADER и REPFOOTER.
| Спецификация | Назначение |
| COL | Выравнивает текст по указанной символьной позиции. |
| SKIP | Выводит указанное количество пустых строк. По умолчанию - одну пустую строку. Значение 0 означает возврат к началу строки. |
| TAB | Пропускает указанное количество столбцов (позиций табуляции). Если указано отрицательное значение, смещает текущую позицию на соответствующее количество столбцов влево. |
| LEFT CENTER RIGHT | Задает выравнивание текущей строки (влево, по центру, вправо, соответственно). Все следующие элементы колонтитула (до конца спецификации или до следующей спецификации LEFT, CENTER, RIGHT или COL) выравниваются вместе, как группа. При этом используется длина строки, заданная с помощью команды SET LINESIZE. |
| BOLD | Выделяет данные. На терминале для этого одинаковые данные печатаются в трех последовательных строках. При выводе на печать строка обычно выдается жирным шрифтом. |
| FORMAT | Задает модель формата для последующих данных. Допустимые элементы модели формата см. в табл. 6 выше. |
При вызове без параметров эти команды выдают текущий формат и признак вывода соответствующего колонтитула.
Если спецификации колонтитула необходимо перенести на следующую строку, предыдущая строка завершается дефисом (-).
Рассмотрим простой пример задания верхнего колонтитула для отчета:
SQL> ttitle left 'Список отделов' center '6 декабря 2001 г.' -
> right 'Стр.: ' format 999 SQL.PNO
SQL> select * from dept;
Список отделов 6 декабря 2001 г. Стр.: 1
DEPTNO DNAME LOC
---------- -------------- -------------
10 ACCOUNTING NEW YORK
20 RESEARCH DALLAS
30 SALES CHICAGO
40 OPERATIONS BOSTON