SQL-консоль

Материал из Такси Диспетчер

Содержание 1 SQL-консоль 1.1 Описание 1.2 Редактирование текста SQL-запроса 1.3 Формирование отчета по результатам SQL-запроса 1.4 Построение графика по результатам SQL-запроса

SQL-консоль

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

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

Так же Вы можете просмотреть Пример использования SQL-консоли для получения формата исходных данных

Описание

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

В окне расположены:

• Панель инструментов

• Поле SQL-запроса

• Поле подсказки

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

• Выполнить запрос (F9) - выполняет запрос, указанный в поле SQL-запроса

• Очистить поле запроса, Копировать текст, Вырезать текст, Вставить текст - кнопки для работы с полем SQL-запроса

• Поиск в таблице-результате - вызывает окно поиска данных в таблице-результате

• Показать список шаблонов - отображает список шаблонов текста SQL-запроса

• Добавить текст запроса в шаблоны - добавляет текст из поля SQL-запроса в список шаблонов

• Сформировать отчет по выборке данных - формирование отчетов в HTML и Excel-форматах. Кнопка имеет два состояния

• Построить график по выборке данных - вызов окна построения графиков по результатам запроса

• Справка - вызов справки

Редактирование текста 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-запроса, необходимо нажать на кнопку-список Сформировать отчет по выборке данных. Данная кнопка имеет два подпункта:

• Отчет HTML

• Отчет Excel

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

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

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

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

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

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

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

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

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

Для отображения графика необходимо:

• указать название поля, значения которого будут откладываться вдоль оси X (выпадающий список Ось X на панели инструментов)

• указать название поля, значения которого будут откладываться вдоль оси Y (выпадающий список Ось Y на панели инструментов)

• дополнительно можно указать тип графика (линия/гистограмма/секторная диаграмма) вызвав контекстное меню правым щелчком мыши на рабочей области графика

Ниже приведены возможные типы графиков:

Линия

Гистограмма

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

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

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

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