Команда COLUMN для управления форматом выдачи столбца имеет следующий синтаксис:
<команда COLUMN> ::=
COL[UMN] [<ссылка на столбец> {<опция> }]
<ссылка на столбец> ::=
<имя столбца> | <псевдоним> | <выражение>
<опция> ::=
ALI[AS] <псевдоним>
| CLE[AR]
| ENTMAP [<вкл./откл.>]
| FOLD_A[FTER]
| FOLD_B[EFORE]
| FOR[MAT] <формат>
| HEA[DING] <текст>
| JUS[TIFY] <выравнивание>
| LIKE <выражение> | <псевдоним>
| NEWL[INE]
| NEW_V[ALUE] <переменная>
| NOPRI[NT]
| PRI[NT]
| NUL[L] <текст>
| OLD_V[ALUE] <переменная>
| <вкл./откл.>
| WRA[PPED]
| WOR[D_WRAPPED]
| TRU[NCATED]
<вкл./откл.> ::=
ON | OFF
<выравнивание> ::=
L[EFT] | C[ENTER] | C[ENTRE] | R[IGHT]
Назначение опций форматирования столбца кратко описано в .
Таблица 5. Основные опции команды COLUMN.
Опция | Назначение |
ALIAS | Присваивает столбцу указанный псевдоним. По этому псевдониму на столбец можно ссылаться в дальнейшем в командах , и . |
CLEAR | Сбрасывает атрибуты указанного столбца в стандартные значения. |
ENTMAP | Позволяет включать и отключать форматирование значений столбца для HTML-отчета. Если эта опция для столбца включена, в значениях будут заменяться символы, имеющие управляющее значение в HTML (<, >, & и т.д.). |
FOLD_AFTER | Вставляет перевод строки после заголовка столбца и каждого значения в данном столбце. Перевод строки не вставляется, если указанный столбец - последний в списке выбора. |
FOLD_BEFORE | Вставляет перевод строки перед заголовком столбца и каждым значением в данном столбце. Перевод строки не вставляется, если указанный столбец - первый в списке выбора. |
FORMAT | Задает формат вывода значений столбца. Основные элементы формата представлены в ниже. |
HEADING | Задает заголовок столбца. Если эта опция не используется, в качестве заголовка используются начальные символы (до ширины столбца) имени столбца или выбираемого выражения. Если в тексте есть пробелы или символы пунктуации, его необходимо брать в одинарные или двойные кавычки. Вместо каждого вхождения символа HEADSEP (по умолчанию - "|") в тексте заголовка вставляется перевод строки. |
JUSTIFY | Задает выравнивание столбца. По умолчанию столбцы типа NUMBER выравниваются вправо, все остальные - влево. |
LIKE | Копирует особенности форматирования указанного столбца, не заданные для текущего столбца явно. |
NEWLINE | Вставляет перевод строки перед выдачей значения столбца аналогично FOLD_BEFORE. |
NEW_VALUE | Задает переменную, в которой будет храниться значение столбца. Эту переменную можно использовать в команде в качестве элемента верхнего колонтитула. Сам столбец необходимо при этом указать в команде с действием SKIP PAGE. |
NOPRINT | Управляет выдачей столбца. Опция NOPRINT отключает выдачу столбца на экран и в отчет. Опция PRINT восстанавливает выдачу столбца. |
NULL | Задает текст, выдаваемый утилитой SQL*Plus вместо пустых значений в столбце. По умолчанию используется пробел. |
OLD_VALUE | Задает переменную, в которой будет храниться значение столбца. Эту переменную можно использовать в команде в качестве элемента нижнего колонтитула. Сам столбец необходимо при этом указать в команде с действием SKIP PAGE. |
ON OFF | Управляет применением особенностей (атрибутов) форматирования столбца. Значение OFF отключает применение особенностей форматирования, не отменяя их. Значение ON снова включает применение заданных особенностей форматирования. |
WRAPPED WORD_WRAPPED TRUNCATED | Задает правила работы со значениями, превышающими ширину столбца. Допускается перенос на следующую строку по границе столбца, по границе слова или усечение по границе столбца. |
Элемент | Пример | Описание |
A<ширина> | A20 | Этот элемент формата позволяет изменить стандартную ширину столбца строкового типа и типа DATE. Если значение столбца не помещается в заданную <ширину>, оно усекается или переносится, в зависимости от соответствующих установок. |
9 | 9999 | Представляет значащую цифру в числовом значении. Вместо начальных нулей выдаются пробелы. Нулевое значение представляется цифрой 0. |
0 | 0999 | Выдает начальный нуль. |
$ | $999 | Выдает перед числовым значением символ доллара. |
L | 9999L | Выдает символ локальной денежной единицы в данной позиции. |
. | 9999.99 | Выдает разделитель целой и дробной части (десятичную запятую) в данной позиции |
, | 9,999 | Выдает запятую (разделитель разрядов) в данной позиции. |
DATE | DATE | Выдает числовое значение (представляющее дату в Юлианском формате) как дату в формате MM/DD/YY. |
EEEE | 9.999EEEE | Выдает значение в экспоненциальном формате (обязательно указывать ровно четыре E). |