Релиз 1.34 [05.2025]

Улучшения и новая разработка

:warning:
ВАЖНО
Версия AW BI 1.34 имеет существенные изменения, связанные с синтаксисом формул в агрегатах.
Теперь движок OZ (оптимизатор запросов) строже относится к соблюдение синтаксиса формул.
Это сделано для ускорения расчётов — тесты показывают, что в некоторых сценариях расчёты стали выполнять в 40-50 раз быстрее.

Мы не можем автоматически скорректировать синтаксис в ваших расчётных агрегатах (расчёты на уровне виджетов) — необходимо это делать подконтрольно.
Но мы приготовили рекомендации по решению самых распространенных ошибок:

Отсутствие квадратных скобок в наименовании полей.
Имена полей необходимо указывать в квадратных скобках.

Неправильно:

  • calc__created_at_month = Month(now()) - 1 OR calc__created_at_month = Month(now())

Правильно:

  • [calc__created_at_month] = Month(now()) - 1 OR [calc__created_at_month] = Month(now())

Использование недопустимого названия функции.

  • avgif - заменить на AVG_IF;
  • countif - заменить на COUNT_IF;
  • cast - заменить на DB_CAST;
  • sumif - заменить на SUM_IF;
  • minif - заменить на MIN_IF;
  • date_trunc - заменить на DATETRUNC;
    и другие.

Использование несуществующих функций.

  • avgsum - заменить на AVG и SUM;
  • lastdayofmonth - заменить на DATEADD, DATE, YEAR, MONTH. Взять год и месяц исходной даты, прибавить 1 к месяцу и установить день равным 1;
  • procent, percent - заменить на арифметические расчеты;
  • current_date - заменить на NOW или TODAY;
  • calculate - заменить функциями с IF, например, SUM_IF и тд или оконной;
  • distinct - заменить функциями COUNTD или COUNTD_IF для получения количества уникальных, и более сложные функции для получения списка;
    и другие.

Рекомендуем перед обновлением AW BI на версию 1.34 исправить все используемые в виджетах формулы и SQL-фильтры, согласно рекомендациям - Синтаксис формул. Формулы, не обозначенные в данной документации, работать не будут.

Источники

Расширены проверки подключения к БД ClickHouse

Доступны проверки подключения через порты:

  • TCP;
  • HTTP / HTTPS.


Модели

Внедрена автоматическая отмена предпросмотра данных модели

Автоматическая отмена операции предпросмотра работает в следующих случаях:

  1. Предпросмотр данных модели;
  2. Предпросмотр иерархий;
  3. Расчет количества записей;
  4. Тестовый запуск скрипта в ETL-редакторе;
  5. Выполнение ETL-блока при редактировании его параметров;
  6. Запуск действия в панели настройки параметров блока.

Автозавершение происходит, если:

  1. закрывается браузер или вкладка браузера;
  2. закрывается страница AW, на которой должны показаться результаты предпросмотра, или модальное окно с ожиданием результатов тестового запуска, или панель с параметрами ETL-блока;
  3. при истечении максимального времени ожидания результатов быстрого предпросмотра (значение переменной окружения ETL_DATA_PREVIEW_MAX_TASK_DURATION).

Добавлена настройка для управления скрытием push-уведомлений при синхронизации моделей через планировщик


Добавлена возможность установки дополнительных python-библиотек и использования их в etl-скриптах моделей и блоков

О функционале: Подключение дополнительных Python библиотек.


Виджеты

Добавлена возможность переиспользования расчетных агрегатов

В виджеты “Тренд” и “KPI” добавлены настройки блока “Вид” и настройки для управления поведением фонового изображения


Добавлено изменение порядка переменных в виджетах



Добавлены новые типы виджета “Воронка” и “Диаграмма потоков (Sankey)”

Изменена грамматика формул

Для ускорения расчётов агрегатных функций проведена оптимизация сервиса clickhouse-parser - движок OZ (оптимизатор запросов) строже относится к соблюдению синтаксиса формул.

Подробнее в предупреждении


Информационные панели

Добавлено логирование просмотров информационных панелей

В окне “Связи виджетов” добавлены опции по скрытию списка виджетов

Добавлены настройки для кастомизации внешнего вида системных виджет-фильтров


Общие изменения

Добавлена информации в реестрах о количестве объектов в каталоге и улучшены методы поиска и фильтрации каталогов по объектам, находящихся внутри каталогов

Добавлена кнопка “Выход” на страницу просмотра виджета/ИП по внутренней ссылке

Добавлено сохранение состояний показателей и уровня вложенности на виджетах в функционале представлений

В дополнительные реестры Системы добавлен вывод окна с атрибутными данными об учетной записи пользователя

Просмотр дополнительных атрибутов пользователя добавлен в:

  • общий доступ к объектам;
  • наследуемые права на объекты;
  • права доступа каталога;
  • общий доступ к переменным;
  • реестр переменных;
  • общий доступ к закладкам;
  • рассылки по email;
  • доступ к созданию публичных ссылок.

Другие улучшения

Внесены улучшения:

  1. Восстановлено применение форматирования значений в выгрузке виджета “Сводная таблица” в excel и csv;
  2. Скорректирована работа добавления/удаления виджетов на рабочую область ИП;
  3. Упрощены правила ключевых слов в формулах агрегации для увеличения скорости запросов;
  4. Оптимизированы просмотры виджетов и панелей;
  5. Исправлены интерфейсные неточности, обнаруженные в версии 1.32;
  6. Скорректировано применение сортировки по агрегату в сводной таблице;
  7. Внесены корректировки в работу функции DATEPART;
  8. Исправлено отображение данных в таблице агрегатов в развернутом режиме;
  9. Исправлены неточности работы превью в виджете “Таблица агрегатов”;
  10. Изменено поведение при создании виджета через ИП;
  11. Исправлены неточности в работе системных виджетов “Текст” , “Кнопка”, “Изображение” и “Контейнер”;
  12. Устранены проблемы в Airflow при смене значений по умолчанию в .env переменных;
  13. Скорректирована работа взаимозависимого фильтра в ИП открытых по публичной ссылке;
  14. Для виджетов “Тренд” и “KPI” обновлена форма “Экспорт”;
  15. Внесены интерфейсные корректировки в работу виджета “KPI”;
  16. Убраны скроллы, лишние отступы и пробелы в виджетах “Тренд” и “KPI” в просмотре ИП;
  17. Добавлена проверка при сохранении расписания на частое обновление модели;
  18. Исправлены неточности при установке по умолчанию значения “(Пустые)” в редактируемые переменные;
  19. Добавлен учет сортировки групп-столбцов в тепловой карте на ИП;
  20. Улучшена работа переключателя для смены темы;
  21. Добавлено условное форматирование заголовков групп-столбцов оператором “Цвет текста”;
  22. Исправлено отображение bool-значений в группировках и показателях пузырьковых диаграмм и тепловых карт;
  23. Добавлено экранирование в значение переменной “Константа” с типом “Строка” для поддержания работы Системы в старом синтаксисе;
  24. Проведена оптимизация логов для сервиса рассылок;
  25. Оптимизирован запрос при генерации прямой ссылки на ИП;
  26. Проведено исследование по ошибке “[Errno 111] Connection refused”;
  27. Добавлен выпадающий список с наименованиями переменных при вводе редактируемых переменных в подписях “Тренда” и “KPI”;
  28. Модернизировано хранение паролей источников;
  29. Добавлены проверки в API на права в зависимости от роли пользователя;
  30. Оптимизирована передача прав доступа на действия в Системе;
  31. Добавлены дополнительные правила учета скрытой сортировки в группах-строках / группах;
  32. Добавлен Update при изменении названия модели на все связанные model_object;
  33. Восстановлена передача полного текста из сообщения об ошибке при подключении к источникам;
  34. Переименовано право “Выгрузка” на “Экспорт”;
  35. Добавлено закрытие окна “Экспорт” в ИП после вызова сервиса;
  36. Исправлено поведение превью при публикации виджета HTML с пустым кодом;
  37. Добавлены миниатюры для новых типов виджетов (KPI, воронка, санкей, водопад);
  38. Модернизировано применение обводки секторов круговых диаграмм;
  39. Исправлены интерфейсные неточности при замене файлового источника;
  40. Добавлены проверки на статус синхронизации модели при создании виджета через API;
  41. Скорректировано применение настройки выравнивания для итоговых агрегатов в виджетах “Таблица” и “Сводная таблица”;
  42. Изменены условия отображения кнопки экспорта в виджетах.

Ошибки

Исправлены ошибки:

  1. Устранена ошибка в виджете “Таблица” при авто-форматировании агрегата с оконной функцией в формуле;
  2. Устранена ошибка в виджете “Сводная таблица” при авто-форматировании агрегата с оконной функцией в формуле;
  3. Устранена ошибка сортировки по расчетному агрегату в сводной таблице;
  4. Исправлена ошибка при работе с моделью на файловом источнике, в случае смены режима загрузки данных с “Файл” на “Ссылка”;
  5. В файловый пуллер добавлен нечеткий поиск листов для частичного решения проблемы с листами Excel, в названии которых есть символ точки;
  6. Устранена ошибка при проваливании в пустую группировку на ИП.

Важная информация для команд проектной разработки и devops

:warning:Необходимые изменения, которые должны быть внесены после обновлений:

Изменения в конфигурации

Добавлены переменные:

  • ETL_PULLER_TIMEOUT
  • ETL_API_START_PREVIEW_TIMEOUT
  • ETL_DATA_PREVIEW_MAX_REQUESTS
  • ETL_DATA_PREVIEW_MAX_TASK_DURATION
  • ETL_DATA_PREVIEW_WARMUP_SPARK_SESSION
  • ETL_EXTRA_PYLIBS_INSTALL
  • ETL_EXTRA_PYLIBS_ALLOW
  • ETL_EXTRA_PYBUILTINS_ALLOW
  • ETL_EXTRA_PYWHEELS
  • BACKEND_LIVE_WIDGET_DATA_CACHE_DURATION
  • ETL_KEEP_FILES_DAYS
  • ETL_KEEP_DAGS_DAYS
  • ETL_TASKS_LOG_LEVEL
  • ETL_BROKER_URL
  • AW_S3_URL

Удалены переменные:

  • AW_FILE_PULLER_INTERNAL_DS_S3_URL

Хранение состояния инкрементальной загрузки переведено в S3. File-puller полностью переведен на работу c S3.

Добавлена новая переменная ETL_PULLER_TIMEOUT, которая указывает ограничение на время обращение к пуллеру из превью или синхронизации модели.

Добавлена переменная BACKEND_LIVE_WIDGET_DATA_CACHE_DURATION для управления жизнью кеша виджетов, построенных на live-моделях.

Проведен рефакторинг папки config.