Инспектор модели¶
Инспектор модели предназначен для интроспекции вычислений внутри модели. Инструмент отображает порядок обработки данных в виде графа, позволяет запустить проверку модели и получить диагностические сообщения по отдельным узлам.
Открыть инспектор модели можно в режиме редактирования модели по кнопке Инспектор модели в правой верхней части экрана. После нажатия кнопки инспектор открывается в соседней вкладке браузера.
В инспекторе отображается процессное представление модели. На графе видно, в каком порядке выполняются вычисления между блоками. Граф инспектора может отличаться от обычной схемы модели, так как показывает фактическую последовательность вычислений и промежуточные узлы обработки.
На графе могут отображаться:
- источники;
- модели;
- ETL-блоки;
- соединения
JOIN; - блоки
UNION; - группы;
- вызовы опубликованных функций из ETL-скрипта модели;
- вычисляемые поля.
При открытии инспектора система предлагает выполнить проверку модели. Проверку также можно запустить кнопкой в верхней панели страницы. Во время проверки по графу модели запускаются вычисления, и система проверяет, что узлы выдают ожидаемый результат.
После завершения проверки каждому узлу присваивается статус:
- зеленый - ошибки и предупреждения по узлу не обнаружены;
- желтый - по узлу обнаружены предупреждения;
- красный - по узлу обнаружены ошибки.
При нажатии на узел открывается правая панель с подробностями проверки выбранного узла. Панель содержит вкладки Подсказки, Структура датафрейма и Статистика.
Правая панель¶
Подсказки¶
Вкладка Подсказки содержит диагностические сообщения по выбранному узлу. На вкладке отображаются ошибки, предупреждения и рекомендации по устранению обнаруженных проблем.
Если по узлу обнаружена ошибка, используйте текст подсказки для определения причины проблемы. Например, подсказка может указать на рассогласование типов полей, изменение структуры датафрейма функцией ETL-скрипта или неоптимальное соединение таблиц.
Структура датафрейма¶
Вкладка Структура датафрейма отображает структуру данных выбранного узла после выполнения проверки. На вкладке можно проверить состав полей и типы данных, которые система получила по результатам вычисления узла.
Используйте вкладку для сравнения ожидаемой структуры модели с фактической структурой датафрейма. Это помогает выявить ситуации, когда поле изменило тип данных или структура выходной таблицы отличается от структуры, определенной в модели.
Статистика¶
Вкладка Статистика отображает сведения о результате вычисления выбранного узла. Данные вкладки помогают оценить, как узел участвует в построении модели и есть ли признаки некорректного или неоптимального расчета.
Используйте статистику совместно с подсказками и структурой датафрейма: если после соединения или преобразования количество записей существенно отличается от ожидаемого, проверьте настройки соответствующего блока модели.
Проверки¶
В инспекторе модели реализованы проверки сложнодетектируемых проблем, которые не всегда заметны при обычном просмотре схемы модели. Проверки помогают выявить расхождения между ожидаемой и фактической структурой данных, изменения результата после выполнения ETL-функций и потенциально некорректные соединения. В дальнейшем список проверок может расширяться.
Рассогласование декларируемой и вычисленной структуры узла¶
Инспектор выявляет ситуации, когда система определяет структуру объекта модели одним образом, а по результатам фактического вычисления получает другую структуру.
Например, если в блоке UNION объединяются две таблицы с одинаковым набором полей, но разными типами данных, система может определить структуру выходной таблицы по первому добавленному блоку. После реального вычисления тип поля может быть приведен к другому типу. В этом случае инспектор фиксирует рассогласование и отображает ошибку на узле.
Изменение структуры выходного датафрейма¶
Функции after_load и after_all из ETL-скрипта не должны менять структуру выходного датафрейма модели. Если такая функция изменяет типы или состав полей, при проверке модели инспектор отображает ошибку.
Неоптимальные соединения¶
Если соединение JOIN выполняется не по первичному ключу, результат может содержать избыточное количество записей. Инспектор модели определяет такие соединения и отображает предупреждение.
Пример предупреждения для соединения JOIN:
После выполнения узла образуется слишком много значений. Проверьте условия соединения записей из дочерних таблиц.
Входящих записей: 1586
Записей после выполнения узла: 12882
Особенности¶
Инспектор модели проверяет права доступа текущего пользователя к модели. Если у пользователя нет доступа к модели, система отображает сообщение об отсутствии доступа.
Тема оформления инспектора соответствует теме основного приложения. Если пользователь меняет светлую или темную тему в основном приложении и повторно открывает инспектор, страница инспектора открывается в выбранной теме.