Использование переменных просмотра

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

Чтобы написать запрос SQL с переменными просмотра:

1.         В нужной ветви соединений дерева навигации DB2 Web Query Tool щелкните по Запросы SQL. Появится выпадающее меню.

2.         В этом выпадающем меню выберите Создать. Откроется страница Редактировать запрос.

3.         В поле Введите операторы SQL введите запрос SQL.

4.         Необязательно: Переменные просмотра можно включить в ваш запрос в одном из следующих форматов:

·      [q.имя_группы.имя_запроса]

·      [r.имя_группы.имя_результата]

·      [qm.имя_группы.имя_запроса]

·      [rm.имя_группы.имя_результата]

Используйте имена запросов или результатов, в которых нужно получить выпадающее меню. Для переменных просмотра, начинающихся с "qm." или "rm.", можно выбрать несколько значений. Для переменных поиска, начинающихся с "q." или "r.", можно выбрать только одно значение.

Определить переменную в запросе можно при помощи одного из следующих вариантов синтаксиса.

·      ?

·      :переменная

·      [переменная]

·      &переменная

Например, в приведенном ниже операторе SQL &userid - это переменная:

select * from table.sample where user=&userid

Можно использовать также одну из системных переменных:

·      wqsys.time  - Заменяет текущее время.

·      wqsys.date -  Заменяет текущую дату.

·      wqsys.timestamp  - Заменяет текущую отметку времени.

·      wqsys.user -  Заменяет имя пользователя, под которым вы зарегистрированы.

·      wqsys.sqlid -  Заменяет ID SQL, с которым вы зарегистрированы.

·      wqsys.database  Заменяет имя базы данных, к которой вы обращаетесь.

5.         Необязательно: В ваш запрос можно включить комментарии в одном из следующих форматов:

·      -- комментарий

·      // комментарий

Примечание:                Комментарием считается только текст, следующий за символами комментария. Любой текст в той же строке до символов комментария рассматривается как часть оператора SQL.

6.         Нажмите кнопку Далее. Откроется экран Опции запроса.

7.         В разделе Параметры выберите ваши предпочтения для автоматического принятия.

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

Примечание:                Если вы решите отказаться от автоматического принятия изменений в базе данных, база данных останется в непринятом состоянии. Это может привести к ошибкам.

·      Выберите При завершении, чтобы изменения в базе данных принимались после выполнения всех операторов SQL.

·      Выберите После каждого оператора, чтобы изменения в базе данных принимались после выполнения каждого оператора SQL.

8.         В поле Имя результата введите имя набора результатов.

Совет: DB2 Web Query Tool предлагает имя набора результатов по умолчанию. Вы можете заменить это имя на другое по вашему выбору.

9.         В поле Максимальное число строк введите максимальное число строк, возвращаемых в наборе результатов.

Совет: Чтобы в наборе результатов были возвращены все строки, в поле Максимальное число строк введите "0".

10.      В поле Срок ожидания введите предельный срок ожидания.

11.      Из выпадающего списка Действие выберите действие для данных большого объекта.

·      Выберите Пропускать, чтобы игнорировать большие объекты.

·      Выберите Получать, чтобы разрешить получение больших объектов.

·      Выберите Встраивать, чтобы включать большие объекты в набор результатов.

12.      Если в вашей системе установлена программа SQL\PA и ваш запрос не был проанализирован SQL/PA, в разделе SQL/PA рядом с SQL/PA появится надпись "Не проанализирован". Чтобы анализировать ваш запрос с помощью SQL/PA, нажмите кнопку Анализ в подразделе SQL/PA раздела Параметры. SQL/PA анализирует один оператор в каждый момент времени. Поэтому, если в вашем запросе содержится несколько операторов SQL, вы увидите результат анализа в кумулятивном формате. Чтобы задать опции анализа SQL/PA, нажмите кнопку Опции анализа.

Примечание:                Если программа SQL/PA у вас не установлена, рядом с SQL/PA в разделе SQL/PA будет написано "Не установлен".

13.      Необязательно: Нажмите кнопку Редактировать SQL, чтобы редактировать запрос SQL.

14.      Щелкните по каждой переменной поиска в разделе Проанализированный запрос и задайте ее значение.

15.      Введите значение переменной или выберите его в выпадающем меню, если оно доступно.

·      Выберите Использовать, чтобы подставить заданное значение только в этот экземпляр имени переменной.

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

·      Выберите Игнорировать, чтобы обрабатывать эту переменную как строку.

Совет: Если щелкнуть по переменной просмотра, появится выпадающее меню, в котором можно выбрать значения переменной. Если для переменной задан выбор нескольких значений, можно выбрать для переменной несколько значений, удерживая нажатой клавишу Control.

16.      Запустите или сохраните запрос. Чтобы запустить запрос, нажмите кнопку Запустить.

Примечание:                DB2 Web Query Tool не проверяет правильность SQL. Если пишите запрос, проверяйте сами синтаксис SQL, имена таблиц и имена столбцов.

DB2 Web Query Tool выполнит запрос и выведет результаты на странице Запрос данных. Теперь можно запустить или сохранить запрос. Если требуется, можно посмотреть страницу сообщений и задать, как выводить или экспортировать результаты запроса.