Флаги функций

Флаги функций


Флаги функций позволяют включать или отключать дополнительные возможности платформы Fincomtech Analytics.
Каждый флаг управляется параметрами в файле superset_config.py и имеет значение True (включено) или False (отключено) по умолчанию, определённое в исходном файле config.py.

Некоторые флаги предназначены только для среды разработки, другие — протестированы и могут использоваться в продакшне.
Ниже приведена классификация доступных опций.

В разработке (In Development)

Эти функции ещё не завершены и рекомендуется использовать их только в средах разработки.

  • ALERT_REPORT_TABS — вкладки для управления отчётами и уведомлениями.
  • DATE_RANGE_TIMESHIFTS_ENABLED — поддержка временных сдвигов в фильтрах диапазона дат.
  • ENABLE_ADVANCED_DATA_TYPES — расширенные типы данных для некоторых источников.
  • PRESTO_EXPAND_DATA — экспериментальное расширение для Presto.
  • SHARE_QUERIES_VIA_KV_STORE — обмен SQL-запросами через key-value хранилище.
  • TAGGING_SYSTEM — система тегов для объектов.
  • CHART_PLUGINS_EXPERIMENTAL — тестирование новых плагинов визуализации.

На тестировании (In Testing)

Эти возможности функциональны, но всё ещё проходят стадию внутреннего тестирования. Возможны незначительные ошибки.

  • ALERT_REPORTS — управление оповещениями и отчётами
  • ALLOW_FULL_CSV_EXPORT — экспорт всех данных отчёта в CSV.
  • CACHE_IMPERSONATION — кеширование под именем пользователя.
  • CONFIRM_DASHBOARD_DIFF — подтверждение изменений при сохранении дашборда.
  • DYNAMIC_PLUGINS — подгрузка плагинов динамически.
  • DATE_FORMAT_IN_EMAIL_SUBJECT — управление форматированием даты в теме email-уведомлений.
  • ENABLE_FT_META_DB — включение встроенной мета-базы данных Fincomtech Analytics.
  • ESTIMATE_QUERY_COST — оценка стоимости выполнения запроса.
  • GLOBAL_ASYNC_QUERIES — выполнение асинхронных запросов 
  • IMPERSONATE_WITH_EMAIL_PREFIX — использование email-префиксов для авторизации.
  • PLAYWRIGHT_REPORTS_AND_THUMBNAILS — скриншоты и предпросмотр через Playwright.
  • RLS_IN_SQLLAB — поддержка row-level security в SQLLab.
  • SSH_TUNNELING — подключение через SSH-туннели .
  • USE_ANALAGOUS_COLORS — генерация похожих цветовых схем для чартов.

Стабильные флаги (Stable)

Эти функции безопасны для продакшена, полностью протестированы и поддерживаются в текущих релизах Fincomtech Analytics.

  • Основные стабильные флаги задокументированы в superset_config.py.
  • Они не требуют дополнительных действий при обновлениях.

Переходные флаги и планируемая замена (Flags on Launch Path)

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

  • DASHBOARD_VIRTUALIZATION — виртуализация отображения дашбордов.

Флаги с динамической настройкой (Runtime configuration)

Некоторые флаги позволяют менять поведение приложения на лету, без перезапуска контейнера.
В будущем они будут выделены в отдельный модуль “динамических конфигураций” с поддержкой не только булевых значений.

  • ALERTS_ATTACH_REPORTS — автоматическое приложение отчётов к уведомлениям.
  • ALLOW_ADHOC_SUBQUERY — поддержка вложенных запросов в SQLLab.
  • DASHBOARD_RBAC — разграничение доступа к дашбордам .
  • DATAPANEL_CLOSED_BY_DEFAULT — скрытая боковая панель данных по умолчанию.
  • DRILL_BY — переход к данным по клику.
  • DRUID_JOINS — поддержка join-запросов в Druid.
  • EMBEDDABLE_CHARTS — встраиваемые диаграммы для внешних страниц.
  • EMBEDDED_FT_ANALYTICS — интеграция Fincomtech Analytics через iframe.
  • ENABLE_TEMPLATE_PROCESSING — шаблонизация SQL-запросов.
  • ESCAPE_MARKDOWN_HTML — экранирование HTML в markdown.
  • LISTVIEWS_DEFAULT_CARD_VIEW — карточный вид списков по умолчанию.
  • SCHEDULED_QUERIES — расписание выполнения SQL-запросов .
  • SLACK_ENABLE_AVATARS — включение аватаров пользователей в Slack-уведомлениях.
  • SQLLAB_BACKEND_PERSISTENCE — сохранение состояния SQLLab на сервере.
  • SQL_VALIDATORS_BY_ENGINE — валидация синтаксиса SQL по типу СУБД .
  • THUMBNAILS — генерация миниатюр для дашбордов .

Устаревшие флаги (Deprecated)

Эти параметры включены по умолчанию (True), но будут удалены в одном из следующих крупных обновлений.
Рекомендуется удалить их из локальных конфигураций или оставить в значении True, чтобы избежать сбоев при обновлении Fincomtech Analytics.

  • AVOID_COLORS_COLLISION — предотвращение конфликта цветов.
  • DRILL_TO_DETAIL — старый механизм перехода к деталям.
  • ENABLE_JAVASCRIPT_CONTROLS — устаревшие элементы управления на JS.
  • KV_STORE — механизм хранения через key-value API.