Проверка витрин
Проверка витрины формирует SELECT-запрос по её текущей конфигурации и, при необходимости, выполняет его на подключённой базе данных. Это позволяет убедиться в корректности конфигурации и заранее увидеть, какие данные вернёт витрина, не создавая никакого объекта в базе данных.
Запуск проверки
Проверка запускается кнопкой «Проверить витрину» на странице конструктора витрины.
- Кнопка недоступна, пока в витрине есть критические ошибки (удалённые или недоступные элементы РПИ) либо недопустимая конфигурация. Подсказка на кнопке указывает причину
- Запрашивать результаты витрины могут все роли, которым доступно её открытие, включая Аналитика и Наблюдателя
Кнопка открывает диалог выбора значения поля «Ограничение результата»:
| Значение | Поведение |
|---|---|
| «Без ограничений» | Возвращаются все записи с постраничным просмотром в таблице результата |
| «10 строк» | Первые 10 записей. Значение по умолчанию |
| «50 строк» | Первые 50 записей |
| «200 строк» | Первые 200 записей |
| «500 строк» | Первые 500 записей |
Подтверждение выполняется кнопкой «Проверить».
Сгенерированный SQL
Сначала отображается сгенерированный запрос с подсветкой синтаксиса для диалекта целевой базы данных.
- Факты и измерения считываются из своих подключённых источников; показатели транслируются из формул в SQL
- Запрос генерируется для базы данных того подключения, к которому относится витрина. Если целевую базу данных определить невозможно, запрос генерируется для PostgreSQL
- Поддерживаются все СУБД, с которыми работает продукт
Для кода доступны два действия:
- «Копировать» — копирование запроса в буфер обмена
- «Экспортировать код в текстовый файл» — скачивание запроса в виде текстового файла
Рядом с этими кнопками расположен элемент управления представлением в базе данных, поэтому представление можно создать или обновить прямо из панели проверки.
Выполнение запроса
Кнопка «Выполнить SQL-скрипт» запускает сгенерированный запрос на целевой базе данных. Кнопка недоступна, если используемое витриной подключение неактивно.
Полученные строки отображаются под запросом в таблице «Результат скрипта»:
- Если было выбрано ограничение по строкам, таблица показывает возвращённые строки одной страницей. Без ограничения результат отображается постранично
- Действие «Сохранить текущую страницу в файл» экспортирует строки текущей страницы в CSV-файл
- Если запрос ничего не вернул, в таблице отображается «Результаты выполнения скрипта не найдены»
Ошибки
Если запрос не удалось сгенерировать или выполнить, пользователь получает уведомление с объяснением причины. Типичные причины:
- Удалённые или недоступные элементы РПИ, используемые витриной
- Элементы, относящиеся к нескольким подключениям, или отсутствующее подключение
- Ошибки, возвращённые базой данных, например отсутствие таблицы или колонки в источнике
- Недопустимая конфигурация, например фильтр, использующий формулу с агрегатной функцией