Блок SQL-запроса


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

Шаги создания SQL-запроса:

  1. наведите курсор мыши на источник, для которого необходимо создать SQL-запрос;

  2. нажмите на кнопку (Рисунок «Кнопка вызова меню»);

    Figure 1. Кнопка вызова меню

    Кнопка вызова меню

  3. в открывшемся меню выберите значение «Добавить SQL» (Рисунок «Значение «Добавить SQL»);

    Figure 2. Значение «Добавить SQL»

    Значение «Добавить SQL»

  4. откроется окно создания SQL-запроса, введите наименование и SQL-запрос (Рисунок «Окно создания SQL-запроса»);

    Примечание
    Для удобства настройки в поле ввода SQL-запроса при вводе первых букв отображаются значения справочников (IntelliSense) и подсветка синтаксиса. Справочники реализованы по полям модели, ключевым словам (select, from и др.), алиасам (при выборе алиаса в выпадающем списке в SQL-запросе указывается код выбранного поля для корректной работы запроса), таблицам (при выборе листов или таблиц файловых источников в выпадающем списке в SQL-запросе указывается его название в обратных кавычках ` ` для корректной работы запроса) (Рисунок «Пример отображения выпадающего списка при вводе SQL-скрипта»).

    Figure 3. Пример отображения выпадающего списка при вводе SQL-скрипта

    Пример отображения выпадающего списка при вводе SQL-скрипта

    Figure 4. Окно создания SQL-запроса

    Окно создания SQL-запроса

  5. нажмите на кнопку , результат отобразится в таблице ниже (Рисунок «Результат»);

    Figure 5. Результат

    Результат

  6. чтобы очистить окно ввода SQL-запроса, нажмите на кнопку ;

  7. нажмите на кнопку , созданный SQL-запрос сохранится и отобразится в левом верхнем углу схемы модели. При сохранении запроса реализована проверка на наличие всех используемых полей в уже созданных виджетах (в том числе и системных виджетов) на этой модели. В случае отсутствия нужных полей в запросе при сохранении отобразится уведомление типа: «Сохранить SQL-запрос невозможно, так как в нем отсутствует поле [недостающее поле]. Данное поле используется в следующих виджетах: [список виджетов]» (Рисунок «Отображение уведомления при сохранении запроса в случае отсутствия нужных полей»).

    Figure 6. Отображение уведомления при сохранении запроса в случае отсутствия нужных полей

    Отображение уведомления при сохранении запроса в случае отсутствия нужных полей

Примечание
Если в SQL-запросе будет наименование, введенное на кириллице, то оно автоматически будет переведено в латиницу. Новые наименования проверяются на уникальность.

При создании SQL-запроса к источнику данных с типом .xlsx выделяйте названия листов Excel-файла кавычками ` `, например, `Лист1`. При выполнении операции JOIN в запросе «select *» замените на конкретный список полей, например, «select `Лист1`.`Фамилия`, `Лист1`.`Имя`».

Пример
Запрос (Рисунок «Пример SQL-запроса к источнику данных с типом .xlsx»): select `Лист1`.`Фамилия`, `Лист1`.`Имя`, `Лист1`.`Отчество`, `Лист2`.`Ид страны`, `Лист1`.`Страна` from `Лист1` join `Лист2` on `Лист1`.`Страна`=`Лист2`.`Ид страны.

Figure 7. Пример SQL-запроса к источнику данных с типом .xlsx

Пример SQL-запроса к источнику данных с типом .xlsx

При создании SQL-запроса к источнику с типом JSON:

  • если JSON представлен в виде простого списка строк:

    [
      {...},
      {...} 
    ]

    то обращение выполняется к таблице default (т.к. данная структура файла представляет одну таблицу, по умолчанию ее наименование default). Пример: SELECT * FROM `default`;

  • если JSON представлен в виде нескольких вложенных таблиц:

    {
      " table 1": [{...}, {....}],
       " table 2": [{...}, {....}],  
    }

    то обращения к таблицам выполняются по именам из ключей словаря верхнего уровня. Пример: SELECT * FROM ` table 1` INNER JOIN ` table 2` ON ` table 1`.` id 1`=` table 2`.` id 2`.