Ошибки и что делать
Здесь собраны сообщения, которые показывает бизнес-аналитика: что они значат и что сделать. Найдите свой текст поиском по странице — Ctrl + F, на Mac — ⌘F. Под многими сообщениями Антима сама пишет «💡 Как исправить» — начните с этого совета.
- Кто может
- Все, кто работает с бизнес-аналитикой
- Где
- Подключения, датасеты, формулы, виджеты, AI
Подключение
Заголовок раздела «Подключение»| Сообщение | Что значит | Что сделать |
|---|---|---|
| «Заполните необходимые поля», «Укажите имя базы данных», «Укажите секретный ключ Bitrix24» | Не заполнено обязательное поле | Заполните поле из сообщения |
| «Не удалось подключиться к базе данных: соединение отклонено», «…время ожидания истекло», «…хост не найден», «…хост недоступен» | Антима не достучалась до сервера базы | Проверьте хост и порт. Убедитесь, что сервер базы работает и принимает подключения извне |
| «Ошибка авторизации в базе данных: неверный логин или пароль», «Ошибка аутентификации ClickHouse…» | Неверный пользователь или пароль | Проверьте их в «Редактировать» |
| «Недостаточно прав для доступа к таблице «X»», «Доступ запрещён…» | Пользователю базы не разрешено читать таблицу | Выдайте ему право на чтение этой таблицы в базе |
| «Название обязательно», «Хост обязателен» | Пустое название или хост | Заполните поле |
| «Сохранено с ошибкой», «Сохранено, но тест не пройден: …» | Подключение сохранилось, но проверку не прошло. Статус — «Ошибка» | Исправьте данные в «Редактировать» и нажмите «Сохранить» — проверка запустится сама. «Протестировать» в окне уже сохранённой базы проверяет прежние, сохранённые данные, а не введённые |
| «Connection failed» | Проверка сохранённого подключения не прошла, причина не показана | Нажмите «Добавить подключение», введите те же данные и нажмите «Протестировать» — появится подробный текст. Затем «Отмена», чтобы не создать второе подключение. См. «Проверить подключение» |
| «Ошибка сохранения», «Не удалось сохранить подключение», «Не удалось удалить подключение», «Не удалось удалить некоторые подключения» | Сервер не выполнил действие | Обновите страницу и повторите. Для массового удаления — проверьте, какие подключения остались в списке |
Проверка PostgreSQL и MySQL пока показывает текст самой базы по-английски. Частые сообщения:
| Текст содержит | Что значит |
|---|---|
password authentication failed, Access denied for user | Неверный пользователь или пароль |
ECONNREFUSED | Сервер не принимает подключения на этом порту: неверный порт или база не запущена |
ENOTFOUND | Нет сервера с таким адресом — опечатка в хосте |
ETIMEDOUT | Сервер не отвечает: скорее всего, подключения извне закрыты |
does not exist, Unknown database | Нет базы с таким именем |
Google Таблицы
Заголовок раздела «Google Таблицы»| Сообщение | Что сделать |
|---|---|
| «Не удалось извлечь Spreadsheet ID из ссылки», «Вставьте ссылку на Google-таблицу или её ID» | Скопируйте ссылку из адресной строки браузера целиком |
| «Выберите Google-аккаунт компании или добавьте новый» | Выберите аккаунт или нажмите «Добавить аккаунт» |
| «Сначала подключите Google-аккаунт кнопкой «Подключить Google»», «Выбранный Google-аккаунт не найден у этой компании» | Подключите аккаунт или выберите другой из списка |
| «Вставьте JSON ключ сервисного аккаунта» | Вставьте содержимое JSON-файла ключа целиком |
| «Доступ не выдан», «У аккаунта X нет доступа к Google-таблицам — выдайте доступ» | Нажмите «Выдать доступ» у аккаунта и в окне Google отметьте галочку доступа к таблицам |
| «Google-подключение X истекло. Переподключите аккаунт.» | Нажмите «Переподключить» у аккаунта |
| «Google-аккаунт X не подключён для этой компании» | Подключите аккаунт заново — «Добавить аккаунт» |
The caller does not have permission | Таблица не открыта выбранному аккаунту или email сервисного ключа — откройте её в Google, «Настройки доступа» |
Requested entity was not found | Таблицы по этой ссылке нет — проверьте ссылку |
| «Invalid Google Service Account credentials» | JSON-ключ вставлен не целиком или испорчен — вставьте его заново |
Excel и Битрикс24
Заголовок раздела «Excel и Битрикс24»| Сообщение | Что сделать |
|---|---|
| «Недопустимый тип файла. Разрешён Excel (.xlsx, .xls)» | Откройте файл в Excel и сохраните как .xlsx |
| «Ошибка загрузки», «Не удалось загрузить файл» | Повторите загрузку. Файл должен быть не больше 25 МБ |
| «Лист “X” содержит более 200000 строк — превышен лимит загрузки…» | Разделите лист на несколько или подключите данные из базы |
| «Bitrix24: необходимо указать адрес сервера и секретный ключ» | Заполните оба поля |
| «Bitrix24 API Error: Expected JSON, received HTML…» | Неверный адрес портала или в Битрикс24 выключена BI-аналитика. Проверьте адрес и раздел CRM → Аналитика → BI-аналитика |
Проверка Битрикс24 не проверяет секретный ключ: неверный ключ даст ошибку только при загрузке данных в датасет.
Датасет
Заголовок раздела «Датасет»| Сообщение | Что значит | Что сделать |
|---|---|---|
| «Ошибки в полях» или «Структура изменена, но содержит ошибки» | Датасет не сохранился из-за поля или иерархии — причина ниже в сообщении | См. строки ниже |
| «У поля отсутствует алиас или пустое имя» | У поля нет имени | Задайте имя |
| «Дубликат имени поля: “X”» | Два поля с одним именем | Переименуйте одно |
| «Поле “X” содержит пустую формулу» | Вычисляемое поле без формулы | Допишите формулу или удалите поле |
| «Иерархия #N не имеет названия», «В иерархии “X” нет уровней (полей)» | Незаконченная иерархия | Задайте название и уровни или удалите иерархию |
| «Ошибка в формуле (Dry-run)» | При сохранении одна из формул не выполнилась на источнике | Откройте красное поле — текст ошибки там. См. «Ошибки в формуле» |
| «Слишком много ошибок таймаута при валидации полей… попробуйте через 30 секунд» | После пяти ошибок проверки подряд Антима делает паузу для этого датасета | Подождите 30 секунд и исправляйте формулы по одной |
| «Не удалось загрузить таблицы», «Ошибка загрузки полей» | Антима не смогла прочитать источник | Проверьте подключение — «Проверить» в списке подключений |
| «Недостаточно прав для чтения метаданных таблицы…» | Пользователю базы не разрешено читать описание таблицы | Выдайте ему право на чтение |
| «Ошибка синхронизации копии» | Копия Google Таблиц не обновилась | Наведите на статус «Ошибка» у «Синхронизации» — в подсказке причина. Чаще всего у аккаунта пропал доступ к таблице |
| «Копия не включена», «Сначала включите «Копию данных в сервисе»» | Нажали «Сделать копию сейчас», а копия выключена | Включите «Копию данных в сервисе» на вкладке «Источники» |
| «Датасет не найден», «Датасет был удалён или у вас нет доступа к нему.» | Датасета по этой ссылке нет | Откройте датасет из списка в «Настройках» |
| «Ошибка выполнения запроса» в предпросмотре | Запрос датасета не выполнился | Проверьте подключение и формулы вычисляемых полей |
| «Не удалось подключиться к источнику данных. Проверьте настройки подключения.» | Источник датасета не отвечает | Проверьте подключение — «Проверить» в списке подключений |
| «Нет данных для отображения. Проверьте источники данных или формулы.» | Запрос выполнился, но строк нет | Проверьте, что в таблицах источника есть данные, и связи между таблицами |
| «Не удалось продублировать датасет», «Не удалось удалить датасет», «Не удалось удалить некоторые датасеты» | Сервер не выполнил действие | Обновите страницу и повторите |
Без сообщения, но что-то не так:
- Итоги из нескольких файлов вдруг уменьшились. Если один файл объединения не прочитался, датасет собирается из остальных. Проверьте подключения.
- Поле по Excel или Google Таблице пустое. Значения не распознались как числа или даты — см. «Числа и даты из Excel и Google Таблиц», — или в формуле функция, которую Антима для файлов не считает: см. «Справочник функций».
- Для Google Таблиц и Битрикс24 формулы при сохранении не проверяются — ошибка появится в виджете. Проверяйте новое поле кнопкой «Проверить» в окне поля.
Ошибки в формуле
Заголовок раздела «Ошибки в формуле»Редактор проверяет формулу сразу, пока вы пишете:
| Сообщение | Что сделать |
|---|---|
| «Не закрыто N скобк…», «Лишняя закрывающая скобка» | Найдите скобку без пары — она обведена красным |
| «Не закрыта строковая константа (’ или ”)» | Закройте кавычку у текста |
| «Неизвестные поля: …» | Предупреждение: слова не похожи на поля датасета. Проверьте написание, а имя из нескольких слов возьмите в квадратные скобки: [Сумма сделки] |
После «Проверить» и при сохранении формулу проверяет база. Сообщения — по первым словам:
| Сообщение начинается с | Что значит | Что сделать |
|---|---|---|
| «Ошибка двойной агрегации!», «Внутри одной агрегатной функции нельзя использовать другую» | Подсчёт внутри подсчёта: SUM(AVG([Сумма])), или полю с отметкой «Есть агрегация» в виджете задали ещё SUM | Уберите внешнюю функцию. В виджете у такого поля выберите агрегацию «Нет (Raw Data)» — в тексте ошибки она названа «Значение» |
| «Ошибка группировки! Поле «X» содержит агрегатную функцию…» | Посчитанное поле поставили туда, где группируют: на ось X, в строки | Группируйте по полю без подсчёта |
| «Ошибка группировки полей! Поле «X» включено в выборку, но не обернуто в функцию агрегации» | В формуле с подсчётом есть поле без подсчёта: SUM([Сумма]) / [Количество] | Оберните и его: SUM([Сумма]) / SUM([Количество]) |
| «Ошибка фильтрации! Поле «X» содержит агрегацию…» | Фильтр по посчитанному полю | Фильтруйте по исходному полю |
| «Неверная агрегация для поля «X»!» | Функция не подходит к типу поля: например, сумма текста | Смените тип поля на число или выберите «Количество» |
| «Ошибка типов данных в формуле! Ветки CASE (или IF) возвращают значения разных типов» | Одна ветка возвращает текст, другая — число: THEN 'Крупная' ELSE 0 | Все ветки должны возвращать одно и то же: только текст или только числа |
| «Несовместимый тип данных в формуле», «Несовместимые типы данных в формуле» | Функции дали поле не того типа: например, текст в ROUND | Смените тип поля или преобразуйте его функцией из группы «Типы» |
| «Несовместимые типы данных «X»! Поле имеет тип массива…» | Поле со списком значений сравнивают с одним значением | Используйте has([Поле], 'значение') |
| «Не удалось преобразовать значение в дату», «…в число» | В колонке есть значения, не похожие на дату или число | Найдите такие значения в источнике или исключите их условием |
| «Ошибка типа данных! Значение «X» не может быть преобразовано в логический тип (Да/Нет)» | В логическом поле встретилось другое значение | Смените тип на «Строка» или сделайте условие через CASE |
| «Функция условной агрегации (например, avgIf) не приняла значения» | У countIf, sumIf, avgIf неверный аргумент | Проверьте: первым — поле, вторым — условие: sumIf([Сумма], [Город] = 'Москва') |
| «Функция «X» не найдена или не поддерживается базой данных» | Опечатка, или функция не работает для этой базы | Выберите функцию из справочника |
| «В формуле упомянуто имя «X»…», «Поле “X” не найдено», «Колонка (поле) «X» не найдена в таблице» | Нет поля с таким именем: опечатка, поле переименовали или удалили | Вставьте поле из «Доступных полей» справа |
| «Таблица «X» не найдена в базе данных» | Таблицу в базе переименовали или удалили | Выберите таблицы датасета заново на вкладке «Источники» |
| «Деление на ноль в формуле» | Делитель бывает равен нулю | Делите через DIVIDE([Сумма], [Количество]) или [Сумма] / NULLIF([Количество], 0) |
| «Синтаксическая ошибка в SQL формуле», «…Позиция: N» | Формула записана неверно: пропущена запятая, скобка или кавычка | Посмотрите место рядом с позицией. «Форматировать SQL» покажет формулу по строкам, «Исправить через AI» предложит исправление |
| «Запрос слишком тяжёлый — базе не хватило памяти», «База не успела вернуть результат за отведённое время» | Слишком много данных для одного запроса | Сузьте период фильтром, уберите поля с множеством разных значений |
| «Не удалось выполнить запрос в базу…» | Другая ошибка базы — подробности в тексте | Упростите формулу или нажмите «Исправить через AI» |
«Ошибка валидации формулы» или «Ошибка выполнения формулы» без подробностей — проверка не дошла до базы. Повторите через минуту.
Виджет и дашборд
Заголовок раздела «Виджет и дашборд»| Что видно | Что значит | Что сделать |
|---|---|---|
| Бледно-красное «Ошибка данных» на виджете | Запрос виджета не выполнился | Откройте виджет в конструкторе — из панели над виджетом в режиме правки или со вкладки «Виджеты» в «Настройках». Там будет текст ошибки и кнопка «Скопировать ошибку» |
| «Ошибка загрузки данных» на дашборде | Не загрузились данные всего дашборда | Обновите страницу |
| «Ошибка загрузки данных» в конструкторе виджета | Не построилось превью этого виджета — текст ошибки ниже | См. строки ниже |
| «Колонка «X» не найдена. Возможно, она была удалена или переименована в базе данных. Выберите актуальное поле.» | Колонку в источнике переименовали или удалили | Выберите поле заново в настройках виджета |
| «Ошибка подключения к источнику данных. Проверьте настройки подключения в разделе “Настройки → Подключения”.» | Источник датасета не отвечает | Проверьте подключение |
| «Ошибка в формуле вычисляемого поля. Проверьте корректность выражения и наличие полей в датасете.» | Одно из вычисляемых полей виджета не считается | Откройте поле в датасете и нажмите «Проверить» — см. «Ошибки в формуле» |
| «Укажите название виджета», «Укажите название и датасет», «Укажите название» | Виджет без названия или датасета не сохраняется | Заполните название и выберите датасет |
| Ярлык «удалено» у поля, «N удалено» у «Столбцов» | Поле виджета пропало из датасета | Замените поле кнопкой выбора поля или удалите его |
| «Выберите поле даты для расчёта тренда» | Включён тренд, но не выбрано поле даты | Выберите «Поле даты» в «Настройках тренда» |
| «Подписи скрыты. Слишком много значений (N)…» | У круговой диаграммы больше 50 сегментов | Задайте «Макс. сегментов» или отфильтруйте категории |
| «Недопустимый тип файла: …» при загрузке картинки | Формат не поддерживается | Загружайте JPEG, PNG, GIF или WebP до 20 МБ. SVG пока не принимается, хотя окно его упоминает |
| «Не удалось удалить / скопировать / переместить некоторые виджеты», «Не удалось сохранить группу», «Не удалось удалить группу» | Действие в списке виджетов выполнилось не для всех | Обновите страницу и проверьте, что осталось |
| Серое «По заданному фильтру значение не найдено» | Под выбранные фильтры не попала ни одна строка | Сбросьте фильтры или выберите другой период |
| Виджет пустой, без надписей | Возможно, временная ошибка сервера | Обновите страницу через минуту. Не помогло — откройте виджет в конструкторе |
| «Проблема с подключением», «Не удалось загрузить данные из N источник(ов)…» | Источник датасета не отвечает | Проверьте подключение в «Настройки» → «Подключения» |
| «Поле «X» не найдено в датасете. Оно могло быть удалено или переименовано…» | Поле виджета пропало из датасета | Выберите поле заново в столбцах, осях и фильтрах виджета |
| «В формуле вычисляемого поля не найдены: …» | Вычисляемое поле ссылается на пропавшее поле | Исправьте формулу в датасете |
| «Эти поля удалены из датасета. Замените их или удалите.» | У виджета-фильтра пропали поля | Замените поля в настройках фильтра |
| «Неверный пароль» | На публичной ссылке введён не тот пароль | Уточните пароль у того, кто прислал ссылку |
| «Недостаточно прав для редактирования дашборда», «Только создатель или администратор может…», «Access to dashboard denied» | Не хватает прав | См. «Доступ к дашбордам» |
| Сообщение | Что значит | Что сделать |
|---|---|---|
| «Нет доступа к AI Аналитику. Обратитесь к администратору компании.» | AI доступен администраторам компании | Попросите администратора или составьте формулу вручную |
| «Недостаточно средств на балансе компании…», «AI-агент остановлен, пока баланс не пополнен» | На балансе нет денег | Администратор пополняет баланс — кнопка «Пополнить баланс» или «Пополнить баланс» |
| «Недоступно в выбранном контуре», «Операция недоступна в выбранном контуре обработки данных…» | Операция не выполняется в контуре обработки данных, который выбран для компании | Администратор может сменить контур кнопкой «Настроить контур» |
| «Слишком много запросов к AI-аналитику. Подождите минуту и попробуйте снова.», «Слишком много запросов. Пожалуйста, подождите…» | Больше 20 AI-запросов в минуту. Лимит общий для AI Аналитика и помощника формул и считается на IP-адрес — то есть на весь офис | Подождите минуту |
| «Не удалось сгенерировать поле через ИИ» | Запрос не выполнился — в том числе из-за лимита запросов | Подождите минуту и повторите |
| «Достигнут лимит итераций (12). Попробуйте переформулировать задачу проще или разбить её на части.» | AI Аналитик сделал 12 шагов и не закончил | Разбейте просьбу на несколько сообщений |
| «Не удалось проверить доступ к AI Аналитику.» | Сервер не ответил на проверку доступа | Обновите страницу через минуту |
| «Не удалось загрузить сессии AI», «Не удалось создать сессию», «Не удалось переименовать сессию», «Не удалось архивировать сессию», «Ошибка ассистента» | Действие в чате не выполнилось. Если страницу AI Аналитика открыл сотрудник без доступа, тоже появится «Не удалось загрузить сессии AI» | Обновите страницу. Нет доступа — см. строку «Нет доступа к AI Аналитику» |
Бизнес аналитика без AI от баланса не зависит: дашборды, виджеты и формулы вручную работают и при нулевом балансе.
Отчёты и рассылки
Заголовок раздела «Отчёты и рассылки»| Сообщение | Что значит | Что сделать |
|---|---|---|
| «Нельзя удалить последний отчёт дашборда» | У дашборда должен остаться хотя бы один отчёт | Переименуйте и перенастройте этот отчёт вместо удаления |
| «Укажите название расписания», «Добавьте хотя бы один email» | Расписание без названия или получателей не сохраняется | Заполните поле |
| «⛔ Нельзя сохранить: нужно N писем (лимит 3)», «⛔ Нельзя отправить: отчёт требует N писем (лимит 3)» | Отчёт не помещается в три письма | Уберите часть виджетов из тела письма или вложений |
| «Отчёт не найден» | Отчёта по этой ссылке нет или он удалён | Откройте отчёт со страницы «Отчёты» — кнопка «К списку отчётов» |
Подробнее — «Отчёты» и «Рассылки по расписанию».
Портфели и перенос из DataLens
Заголовок раздела «Портфели и перенос из DataLens»| Сообщение | Что сделать |
|---|---|
| «Неверный формат файла. Ожидается экспорт DataLens.», «Не удалось прочитать JSON файл» | Выберите JSON-файл экспорта проекта DataLens, не меняя его |
| «Ошибка импорта» | Перенос не удался — повторите. Уже перенесённое останется, повторный перенос создаст дубли. См. «Перенос из DataLens» |
| «Не удалось продублировать портфель», «Не удалось удалить портфель», «Не удалось добавить в портфель», «Не удалось убрать из портфеля» | Обновите страницу и повторите |
Статусы и цвета
Заголовок раздела «Статусы и цвета»| Где | Что видно | Что значит |
|---|---|---|
| Список подключений | «Активно» — зелёный | Последняя проверка прошла |
| «Ошибка» — красный | Последняя проверка не прошла | |
| «Неактивно» — серый | Подключение ещё не проверяли: созданное из датасета или перенесённое из DataLens без пароля | |
| Датасет, «Синхронизация» копии Google Таблиц | «Идёт…» с крутящимся значком | Копия обновляется |
| «Завершена N назад» — зелёная галочка | Копия обновлена. Точное время — в подсказке | |
| «Ошибка» — красный треугольник | Копия не обновилась. Причина — в подсказке | |
| «ещё не запускалась» — серый | Копию ещё не делали | |
| Метрика с трендом | Зелёный процент | Рост к прошлому периоду |
| Красный процент | Падение | |
| Серый | Без изменений | |
| Карточка дашборда | «Публичный» — зелёный с глобусом, с замком — если задан пароль | Дашборд открывается по ссылке без входа |
| «Приватный» — серый с замком | Только для сотрудников с доступом | |
| Отчёт | «Публичный · с паролем», «Публичный · без пароля» — зелёный | Отчёт опубликован |
| «Доступ не настроен» | Отчёт не опубликован |
Для показателей, где рост — это плохо, например доля отказов или стоимость заявки, в настройках метрики включите «Рост — это плохо»: рост станет красным, падение — зелёным. Стрелка по-прежнему показывает, куда изменилось число. Тот же переключатель есть у столбца таблицы и у значения сводной таблицы.
Другие цвета:
- типы и отметки полей в датасете — «Создать датасет»;
- подсветка в редакторе формулы — «Формулы и вычисляемые поля».