SQL-консоль

Окно SQL-консоль представляет собой удобный интерфейс для получения данных из базы с помощью SQL-запросов (SQL = Structured Query Language - структурированный язык запросов) и построения на основе полученных данных отчетов и графиков. Таким образом, в данном окне Вы можете выполнять любые запросы SHOW/SELECT на получение данных из базы, необходимые для диагностики базы или построения специфических отчетов/графиков не обращаяь при этом в службу поддержки.

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

Для вызова окна необходимо выбрать пункт меню Администрирование|SQL-консоль. Появится окно:

Окно "SQL-консоль"


В окне расположены: На панели инструментов расположены кнопки:

Редактирование текста SQL-запроса

Ввод и редактирование текста запроса производится в поле SQL-запроса. При этом можно использовать заранее определенные шаблоны запросов. Для вызова панели шаблонов нажмите кнопку Показать список шаблонов на панели инструментов. В правой части окна появится список шаблонов:

Список шаблонов в SQL-консоли


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

Все шаблоны, используемые в программе, содержатся в файле cfg\sqltpl.ini. Вы можете отредактировать этот файл сами или связаться с разработчиками для формирования специального шаблона.

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

SELECT * FROM `orders` WHERE `oper`=<#номер оператора#>

В данном случае замене на соответствующее значение подлежит весь текст: < #номер оператора#>. Т.е. перед выполнением запрос должен выглядеть следующим образом:

SELECT * FROM `orders` WHERE `oper`=1

где 1 - номер оператора.

Примечание 1: Имена таблиц и полей заключайте в обратные кавычки `, а строковые данные - в двойные кавычки ".
Пример запроса:

SELECT `phone`, `addressfrom`, `addressto` FROM `orders` WHERE `phone` LIKE "%23%"

Примечание 2: В поле SQL-запроса допускается устанавливать строчные комментарии с помощью символов //.
Пример запроса:

SELECT `phone`
//, `addressfrom`, `addressto`
FROM `orders`
//WHERE `phone` LIKE "%23%"


при этом фактически выполнится следующий запрос:

SELECT `phone` FROM `orders`

Выполнение SQL-запроса

После формирования текста SQL-запроса для его выполнения нажмите кнопку Выполнить запрос (F9). При этом в нижней части окна SQL-консоль отобразится таблица-результат:

Результат выполнения SQL-запроса

Формирование отчета по результатам SQL-запроса

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

если выбран подпункт Отчет HTML

Отчет HTML


если выбран подпункт Отчет Excel

Отчет HTML


Файлы отчетов автоматически сохраняются в виде html-файлов в подкаталог программы reports\. Наименование файлов выполняется в соответствии с маской "console%.htm", где символ % - обозначает номер файла в подкаталоге reports\.

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

Установка полей в таблице-результате, которые будут выведены в отчет


В рассматриваемом подменю при снятии галочки напротив пункта Вносить поле "название" в отчет заголовок поля отрисовывается перечеркнытым шрифтом, что означает запрет вывода выбранного поля в отчет. Соответственно установка галочки напротив пункта Вносить поле "название" в отчет разрешает вывод поля в отчет.

Построение графика по результатам SQL-запроса

Для того, чтобы построить график по полученному результату SQL-запроса, необходимо нажать на кнопку Построить график по выборке данных на панели инструментов. При этом появится окно График:

Построение графика по результатам SQL-запроса


Окно содержит панель инструментов и рабочую область графика.

Для отображения графика необходимо: Ниже приведены возможные типы графиков:

Линия

Тип графика - линия
Гистограмма

Тип графика - гистограмма

Секторная диаграмма

Тип графика - секторная диаграмма


Для укрупнения масштаба графика по осям выделите мышкой интересующий прямоугольник двигаясь из верхнего левого угла в правый нижний:

Укрупнение масштаба графика


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

Для вывода графика на печать нажмите кнопку Печать графика на панели инструментов.