Решение проблем

Частые ошибки и что с ними делать.

Подключение источника

Не удалось подключиться к источнику

Проверьте по порядку:

1. Сверьте порт. Для ClickHouse укажите HTTP-порт 8123: подставленное формой значение 9000 относится к native-протоколу, и подключение с ним не установится.
2. Проверьте адрес хоста. Платформа обращается к базе со стороны сервера, а не из вашего браузера. Если база и платформа стоят на разных машинах, localhost не подойдёт — укажите адрес, который видит сервер платформы.
3. Убедитесь в учётных данных. Достаточно прав только на чтение, но пользователь должен существовать и иметь доступ к указанной базе.
4. Проверьте сеть. Порт базы должен быть открыт для сервера платформы.

При открытии источника — ошибка про список объектов

Сообщение вида Не удалось получить список объектов: ... transport error: 400 означает, что соединение установить не удалось. Причина обычно та же, что и выше, — неверный порт.

Ошибка «Failed to load driver class»

Сообщение вида Failed to load driver class oracle.jdbc.OracleDriver появляется при чтении данных и означает, что для этого типа базы не загружен JDBC-драйвер. Само подключение здесь ни при чём: источник создался и сохранился, потому что мастер наличие драйвера не проверяет.

Попросите администратора загрузить драйвер — раздел Типы источников и драйверы. Пересоздавать источник не нужно: он заработает сразу после загрузки.

Драйвера нет или база недоступна?

Различить помогает текст ошибки. Failed to load driver class ... — нет драйвера. Failed to connect to host ... — драйвер на месте, но платформа не достучалась до самой базы: проверяйте адрес, порт и сеть.

Нужного типа базы нет в мастере

Тип отключён администратором. Обратитесь к администратору платформы — раздел Типы источников и драйверы.

Датасеты

Виджет пишет «агрегация неоднозначна»

Полный текст: «Измерение [products] имеет грейн мельче меры [orders]; агрегация неоднозначна». Это не про виджет, а про датасет: неверно указана кардинальность связи.

Откройте датасет, щёлкните по линии связи и проверьте кардинальность. Для связи таблицы фактов со справочником (заказы → товары) правильное значение — M : 1: у одного товара много заказов, а у заказа ровно один товар. Платформа при перетаскивании ставит 1 : M, то есть наоборот.

Превью данных пустое

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

Изменил датасет, а виджет показывает старое

Сохраните датасет кнопкой Сохранить: правки схемы, связей и полей применяются только после сохранения. Затем обновите страницу виджета.

Виджеты

«Нет данных для отображения»

Чаще всего не заполнена полка Мера — без числового поля диаграмме нечего показывать. Проверьте также, что фильтры не отсекают все строки.

На графике по датам слишком много точек

Поле с датой по умолчанию группируется по каждому дню. Щёлкните по полю на полке, выберите Преобразование → Усечение и период — например, Месяц.

Не получается собрать виджеты на одной странице

Редактор дашбордов пока не реализован: дашборд можно создать и назвать, но добавить в него виджеты нельзя. Подробнее — Дашборды.

AI-помощник

«Не удалось сгенерировать SQL»

• Если это первый запрос после запуска — повторите. Локальная модель в этот момент загружается в память, и ответ приходит дольше обычного.
• Если ошибка повторяется, значит платформа не может достучаться до языковой модели. Это настройка администратора — AI-провайдер.

Кнопки AI-помощника нет

Ассистент выключен администратором или не настроен провайдер языковой модели.

Доступ

В меню нет нужного раздела

Разделы показываются по типу учётной записи. Если раздела нет, у вашей учётной записи нет к нему доступа — обратитесь к администратору платформы.

Нет кнопки «Создать проект»

Создавать проекты могут только участники группы «Менеджеры рабочих пространств».

В профиле нет вкладки «AI mcp токены»

Нужны два условия сразу: членство в группе «Пользователи AI mcp» и разрешение на выпуск токенов в настройках AI-провайдера. Оба включает администратор.

Коллега не видит мой датасет

Доступ выдаётся через участие в проекте: добавьте человека в проект и назначьте роль — см. Проекты. Выдать права на один отдельный объект через интерфейс нельзя.

Пользователь видит не все строки данных

Так работают правила видимости строк (RLS). Проверьте их в датасете — кнопка Видимость строк. Правила действуют на всех, кому адресованы, включая владельца датасета и администратора.

MCP-токены

Потерял значение токена

Токен показывается один раз при создании. Восстановить его нельзя — отзовите старый и выпустите новый в профиле, вкладка AI mcp токены.

Внешний клиент перестал подключаться

Проверьте статус токена в таблице Мои токены: он мог быть приостановлен, отозван или у него истёк срок действия.