Документация iSZN

Вариант выборки (техническая информация)

Вариант выборки определяет:

  • таблицы и (или) представления, из которых выбираются данные;
  • столбцы, значения которых выбираются;
  • критерии, по которым выбираются данные.

Для выборки данных используется обычный SQL-оператор SELECT, строящийся Системой по следующему принципу:

SELECT [DISTINCT]
  data_column_1, data_column_2, ..., [file_name_column_1], [file_name_column_2], ...
sql_ending
ORDER BY [file_name_column_index_1], [file_name_column_index_2], data_column_index_1 [asc|desc], data_column_index_2 [asc|desc], ...

где:

  • data_column_n — выражения столбцов выборки;
  • data_column_index_n — индексы выражений столбцов в списке оператора SELECT;
  • file_name_column_n — выражения столбцов имени файла;
  • file_name_column_index_n — индексы выражений столбцов имени файла в списке оператора SELECT;
  • sql_ending — завершение выражения выборки данных.

Выражение предварительного SQL-сценария

Это выражение представляет собой необязательный DDL- или DML-оператор (например, оператор UPDATE) или PL/SQL-блок, выполняющий подготовительную работу перед использованием варианта выборки (формированием выходного документа; например, заполнение некой временной таблицы данными, которые будут служить исходными для документа).

Выражение предварительного SQL-сценария может включать любой из параметров отчётной системыстандартный, предоставляемый провайдером и тому подобное.

При отсутствии данного сценария никаких предварительных действий перед использованием варианта выборки не предпринимается.

Выражение для подсчёта количества записей выборки

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

При отсутствии данного выражения считается, что количество выбираемых строк определять нецелесообразно (например, если подсчёт количества строк занимает длительное время, соизмеримое с собственно выборкой данных) и отображение прогресса при этом не используется.

Выражение для подсчёта количества записей также может включать любой из параметров отчётной системы.

Завершение выражения выборки данных

Это выражение является основным и обязательным для варианта выборки. Оно должно представлять собой окончание SQL-оператора SELECT (начиная с ключевого слова FROM и включая его), который впоследствии будет построен путём добавления выражений столбцов.

Пример выражения варианта выборки, используемого для формирования списка пользователей Системы:

FROM
  uszn.tsrv_users u

Как видно, здесь используется алиас (псевдоним) для таблицы tsrv_usersu, что является стандартной и крайне желательной практикой при создании выражений выборок (и не только для выражений выборок).

Завершение выражения выборки данных, подобно прочим выражениям варианта выборки, также может включать любой из параметров отчётной системы.

Параметры, используемые SQL-выражениями

Имя Описание
CRITERIA_SELECT Запрос, выбирающий ключевой столбец по критериям отчётной системы.
REGION Идентификатор района.
<параметр> Параметры, подставляемые при вызове из внешних программ, а также параметры отчётной системы.

См. также