Перейти к содержанию

Проверка витрин

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

Запуск проверки

Проверка запускается кнопкой «Проверить витрину» на странице конструктора витрины.

  • Кнопка недоступна, пока в витрине есть критические ошибки (удалённые или недоступные элементы РПИ) либо недопустимая конфигурация. Подсказка на кнопке указывает причину
  • Запрашивать результаты витрины могут все роли, которым доступно её открытие, включая Аналитика и Наблюдателя

Кнопка открывает диалог выбора значения поля «Ограничение результата»:

Значение Поведение
«Без ограничений» Возвращаются все записи с постраничным просмотром в таблице результата
«10 строк» Первые 10 записей. Значение по умолчанию
«50 строк» Первые 50 записей
«200 строк» Первые 200 записей
«500 строк» Первые 500 записей

Подтверждение выполняется кнопкой «Проверить».

Сгенерированный SQL

Сначала отображается сгенерированный запрос с подсветкой синтаксиса для диалекта целевой базы данных.

  • Факты и измерения считываются из своих подключённых источников; показатели транслируются из формул в SQL
  • Запрос генерируется для базы данных того подключения, к которому относится витрина. Если целевую базу данных определить невозможно, запрос генерируется для PostgreSQL
  • Поддерживаются все СУБД, с которыми работает продукт

Для кода доступны два действия:

  • «Копировать» — копирование запроса в буфер обмена
  • «Экспортировать код в текстовый файл» — скачивание запроса в виде текстового файла

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

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

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

Полученные строки отображаются под запросом в таблице «Результат скрипта»:

  • Если было выбрано ограничение по строкам, таблица показывает возвращённые строки одной страницей. Без ограничения результат отображается постранично
  • Действие «Сохранить текущую страницу в файл» экспортирует строки текущей страницы в CSV-файл
  • Если запрос ничего не вернул, в таблице отображается «Результаты выполнения скрипта не найдены»

Ошибки

Если запрос не удалось сгенерировать или выполнить, пользователь получает уведомление с объяснением причины. Типичные причины:

  • Удалённые или недоступные элементы РПИ, используемые витриной
  • Элементы, относящиеся к нескольким подключениям, или отсутствующее подключение
  • Ошибки, возвращённые базой данных, например отсутствие таблицы или колонки в источнике
  • Недопустимая конфигурация, например фильтр, использующий формулу с агрегатной функцией