Оформление
Решение проблем
Частые ошибки и что с ними делать.
Если платформа показала конкретный текст ошибки, быстрее искать по нему — Сообщения платформы.
Подключение источника
Не удалось подключиться к источнику
Начните с кнопки Проверить подключение в форме источника: она называет причину прямым текстом — неверный порт, ненайденный хост, закрытый порт, молчащий сервер или сбой шифрования.
Если сообщения недостаточно, проверьте по порядку:
- Сверьте порт. Значение по умолчанию платформа подставляет сама; если порт правили вручную, сверьтесь со справочником типов и портов. Частая ошибка —
9000вместо8123у ClickHouse. - Проверьте адрес хоста. Платформа обращается к базе со стороны сервера, а не из вашего браузера. Если база и платформа стоят на разных машинах,
localhostне подойдёт — укажите адрес, который видит сервер платформы. - Убедитесь в учётных данных. Достаточно прав только на чтение, но пользователь должен существовать и иметь доступ к указанной базе.
- Проверьте сеть. Порт базы должен быть открыт для сервера платформы.
При открытии источника — «Внутренняя ошибка сервера»
Так выглядит неудачное подключение при запросе списка таблиц: причину это сообщение не называет. Откройте источник на редактирование и нажмите Проверить подключение — там платформа объяснит, что именно не сошлось: порт, адрес хоста, доступность сервера или режим SSL.
Ошибка «Failed to load driver class»
Сообщение появляется при чтении данных и означает, что для этого типа базы не загружен JDBC-драйвер. Источники, созданные раньше, продолжают числиться в списке, а вот новый источник такого типа форма сохранить уже не даст — она предупреждает о драйвере сразу.
Драйвер загружает администратор — см. Типы источников и драйверы. Пересоздавать источник не нужно, он заработает сразу после загрузки.
Драйвера нет или база недоступна?
Различить помогает текст ошибки. Failed to load driver class ... — нет драйвера. Failed to connect to host ... — драйвер на месте, но платформа не смогла соединиться с базой: проверяйте адрес, порт и сеть.
Нужного типа базы нет в мастере
Сначала снимите переключатель Только доступные над списком типов: он прячет типы, для которых не загружен драйвер. Если типа нет и тогда — он отключён администратором. Обратитесь к администратору платформы — раздел Типы источников и драйверы. Полный перечень поддерживаемых баз — Справочник типов и портов.
Датасеты
Виджет пишет, что поля нельзя показать вместе с мерами
Полный текст: «Поля [products] нельзя показать вместе с мерами этого виджета: связь [orders] → [products] размножает строки…». Причина не в виджете, а в датасете: неверно указана кардинальность связи.
Откройте датасет, щёлкните по линии связи и проверьте кардинальность: для связи таблицы фактов со справочником нужно M : 1, а платформа при перетаскивании ставит 1 : M. Почему так и что означает каждое значение — Связи между таблицами.
Превью данных пустое
Сначала выберите таблицу на холсте — пока объект не выбран, панель сообщает «Объект не выбран». Затем нажмите Обновить под таблицей: запрос не выполняется сам, пока не включено Автообновление, см. Датасеты.
Изменил датасет, а виджет показывает старое
Сохраните датасет кнопкой Сохранить: правки схемы, связей и полей применяются только после сохранения. Затем обновите страницу виджета.
«В датасете не выбран главный объект»
Виджет не строится, пока в датасете не отмечена основная таблица. Откройте датасет и нажмите звёздочку в заголовке нужного блока на холсте — см. Основная таблица.
Данные в виджете отстают от источника
Причин две:
- Датасет в режиме извлечения — виджеты читают снимок, а он обновляется по расписанию. Посмотрите время последней сборки в списке датасетов (колонка «Данные обновлены») или на вкладке История окна Синхронизация — история запусков.
- Кеш выборки — готовый ответ хранится минуту, структура таблиц и списки значений — пять. Что и насколько кешируется, перечислено в разделе Кеши и лимиты.
Виджеты
«Нет данных для отображения»
Чаще всего не заполнена полка Мера — без числового поля диаграмме нечего показывать. Проверьте также, что фильтры не отсекают все строки, и сверьтесь с таблицей сколько полей принимает тип: лишние поля виджет не покажет.
На графике по датам слишком много точек
Поле с датой по умолчанию группируется по каждому дню. Щёлкните по полю на полке, выберите Преобразование → Усечение и период — например, Месяц. Чем усечение отличается от «части даты» — в разделе Поля, фильтры и сортировка.
«Функция … пока не поддержана»
Виджет показывает «Не удалось загрузить данные виджета», а строкой ниже — причину: «Функция 'MEDIAN' пока не поддержана». Так платформа отвечает на формулу с функцией, которой она не выражает: имя набрано с опечаткой, взята функция самой СУБД (lowerUTF8, toStartOfQuarter) или функция помечена в справочнике как неисполняемая источником — MEDIAN, QUANTILE и ещё восемь, список — ограничения. Сообщение называет функцию: исправьте формулу или соберите расчёт из поддержанных функций, см. Вычисляемые поля.
Фильтр с относительной датой отвечает «Внутренней ошибкой сервера»
Так отвечают выражения «Начало месяца», «Начало квартала» и «Начало года» на источниках, которые не умеют округлять дату до периода: квартал — на ClickHouse, MySQL, MariaDB и MS SQL, а на Vertica и H2 — ещё и месяц с годом. На MS SQL так же отвечает «Сейчас» (NOW()) — берите «Сегодня». Сдвиг («7 дней назад» и подобные) работает везде. Обход — обычный фильтр с конкретной датой; таблица по источникам и тексты отказов — Поля, фильтры и сортировка.
Не получается собрать виджеты на одной странице
Виджеты собираются на дашборде: Дашборды → Создать, затем в конструкторе — кнопка Виджет в панели Объекты: она откроет окно со списком сохранённых виджетов. Как устроен конструктор и какие объекты кроме виджетов бывают — Конструктор дашборда и Объекты дашборда.
AI-помощник
«Не удалось сгенерировать SQL»
- Если это первый запрос после запуска — повторите. Локальная модель в этот момент загружается в память, и ответ приходит дольше обычного.
- Если ошибка повторяется, платформа не может обратиться к языковой модели. Это настройка администратора — AI-провайдер.
Помощник долго «печатает»
Так ведёт себя рассуждающая модель: большая часть времени уходит на внутренние рассуждения. Администратор отключает их в настройках провайдера — параметром в поле «Доп. параметры вызова (JSON)»; название параметра зависит от сервиса, замер обоих режимов приведён в разделе AI-провайдер.
«Ответ модели неполный»
Модель не успела договорить: ответ оборвал лимит токенов. Обрезанный SQL помощник не отдаёт — вместо него приходит эта ошибка. Администратор увеличивает max_tokens в доп. параметрах провайдера или убирает этот параметр совсем; помогает и более простой вопрос. У рассуждающих моделей тот же лимит тратят рассуждения — их стоит отключить.
Кнопки AI-помощника нет
Помощник выключен администратором или не настроен провайдер языковой модели.
Доступ
В меню нет нужного раздела
Разделы показываются по типу учётной записи, а некоторые возможности — по членству в системных группах: создание пространств, выпуск токенов для ИИ, рассылки — системные группы. Если раздела нет, обратитесь к администратору платформы.
Нет кнопки «Создать пространство»
Создавать пространства могут только участники группы «Менеджеры рабочих пространств».
В профиле нет вкладки «Доступ для ИИ»
Нужны три условия сразу: тип учётной записи «Создатель» или «Исследователь» (наблюдателю доступ для ИИ не выдаётся), членство в группе «Пользователи AI mcp» и разрешение на выпуск токенов в настройках AI-провайдера. Два последних включает администратор.
Коллега не видит мой датасет
Есть два пути. Добавить человека в пространство и назначить ему роль — см. Пространства. Или открыть доступ к одному датасету: кнопка Доступы на его странице, поиск по имени или группе, право просмотр — см. Доступ к отдельному объекту.
Если объект лежит в личном пространстве, поделиться им нельзя — сначала перенесите его в общее.
Пользователь видит не все строки данных
Так работают правила видимости строк (RLS). Проверьте их в датасете — кнопка Видимость данных, вкладка Строки (RLS). Правила действуют на всех, кому адресованы, включая владельца датасета и администратора, — подробности в разделе Видимость строк (RLS).
Если поля вовсе пропали из списка, а не строки, — это уже правила видимости полей, см. Видимость полей (CLS).
MCP-токены
Потерял значение токена
Токен показывается один раз при создании. Восстановить его нельзя — отзовите старый и выпустите новый в профиле, вкладка Доступ для ИИ, см. подключение агента.
Внешний клиент перестал подключаться
Причину называет сам отказ при подключении: «Токен приостановлен владельцем», «Токен отозван», «Срок действия токена истёк». Приостановку снимают кнопкой Возобновить в таблице Мои токены, в остальных случаях нужен новый токен.
Отказ «Этой учётной записи доступ к MCP не разрешён» означает другое: токен рабочий, но у учётной записи нет права на MCP — членства в группе «Пользователи AI mcp» или разрешения в настройках платформы. Оба включает администратор.
Что дальше
- Ограничения текущей версии — если поведение не ошибка, а граница продукта.
- Журнал обращений — точный SQL, ушедший в источник.