Что-то пошло не так

Типовые проблемы и быстрые решения. Если не помогло — support@ide99.ru с описанием и версией ide99 (Настройки → Обновления → About).

Подключение

«Could not connect to server»

Самая частая ошибка. Поэтапная проверка:

Сервер запущен?

# local docker
docker ps | grep postgres

Порт правильный? Постgreс по умолчанию 5432, но в Docker часто пробрасывают на другой (5433, 55003 и т.п.). Смотрите docker ps или конфиг.
Хост достижим?
```
nc -zv localhost 5432
```
Должно ответить «succeeded». Если timeout — file/network нет.
pg_hba.conf? Если сервер на другой машине, проверьте что есть строка вроде:
```
host all all 0.0.0.0/0 scram-sha-256
```

«password authentication failed for user…»

Проверьте, что пароль введён правильно (Caps Lock?)
На managed-Postgres иногда нужно использовать имя пользователя в формате user@host (Azure)
Проверьте, что роль существует: SELECT rolname FROM pg_roles WHERE rolname = 'youruser';

«no pg_hba.conf entry for host…»

Сервер запретил подключение с вашего IP. Решение зависит от конфигурации сервера — нужно добавить вашу подсеть в pg_hba.conf.

На managed-Postgres: добавьте свой IP в whitelist в UI провайдера.

«SSL connection has been closed unexpectedly»

Проверьте SSL Mode (см. SSL и SSH-туннель)
Если используете verify-full, убедитесь что CA-сертификат установлен
Попробуйте prefer для диагностики (если работает — проблема в SSL-конфигурации)

SQL-редактор

Запросы виснут

Проверьте Live Ops → Sessions — возможно, ваше предыдущее подключение залочило таблицу
Кнопка Cancel query в редакторе пошлёт pg_cancel_backend. Если не помогает — pg_terminate_backend через Live Ops.

Автокомплит не работает

Возможно, схема не загружена. ⌘+R в дереве справа.
Если новые таблицы созданы, но не появились — Refresh дерева.
Включена ли опция «Scan jsonb schemas» в Settings → Общие? Без неё путей не будет.

«relation does not exist»

Schema search_path. По умолчанию Postgres ищет в public. Если ваша таблица в analytics.events — пишите явно или меняйте search_path:
```
SET search_path TO analytics, public;
```
Проверьте регистр. PostgreSQL хранит имена в нижнем регистре, если они не закавычены. Orders ≠ orders.

Грид и результаты

«Query returned 1M rows — UI слабо реагирует»

ide99 поддерживает 50M+ строк в гриде, но первая загрузка большой выборки занимает время.
Проверьте, нужны ли все строки. Добавьте LIMIT 1000 для исследования.
Result page size в Settings → Общие — уменьшите до 500 для интерактивности.

«Cannot edit cell» / иконка ✏ серая

Запрос ide99 не определил как updatable (несколько таблиц, agregate, view без триггера).
Решение: используйте конкретный SQL UPDATE ... WHERE pk = ....

EXPLAIN

«EXPLAIN не работает на prod»

Если включён Read-only — EXPLAIN ANALYZE блокируется (он реально выполняет запрос). Используйте обычный EXPLAIN без ANALYZE.

«Heatmap не загорается»

Проверьте, что выбрали duration (или rows/cost), а не none.
Если у узла время = 0 — он не покрашен.

JSONB

«JSONB-редактор показывает ошибку»

Содержимое не валидный JSON. Это бывает с legacy-данными или после ручных правок.
В Text-режиме ошибка валидации подсветится — поправьте.

«Сохранение JSONB на prod заблокировано»

Read-only режим включён. Снимите в форме подключения → Save.

MCP

«Claude Code не видит ide99»

Проверьте Настройки → AI / MCP → Status — должно быть «Listening».
Конфиг в ~/.claude/mcp.json указывает правильный путь к бинарнику?
После правки конфига Claude Code требует рестарт (/exit и заново запустить).

«Agent зависает после Allow»

Это часто связано с тем, что запрос реально длинный. Проверьте Live Ops — что выполняется.
Кнопка Cancel в диалоге MCP отменит.

Schema-дерево

«Не вижу мою таблицу»

Refresh дерева (⌘+R).
Возможно, таблица в схеме, которая не отображается. Проверьте search_path или используйте полное имя myschema.mytable.
На managed-Postgres иногда новые таблицы видны не сразу из-за кэширования системных каталогов.

Бэкапы

«pg_dump not found»

Утилиты Postgres не установлены или не в PATH.
macOS: brew install libpq и добавить $(brew --prefix libpq)/bin в PATH.
Linux: apt install postgresql-client-17.
Перезапустите ide99 после установки.

«Permission denied» при бэкапе

Папка назначения не writable. Выберите другую или проверьте права.

Производительность ide99 самого

«Приложение тормозит»

Закройте лишние табы — каждый держит результат в памяти.
Очистите history (Settings → Privacy → Clear all local data сбрасывает только историю и кэши, подключения и сниппеты остаются — нет, тут полностью).
Если нужна тонкая очистка только истории — удалите history.db руками.

«Окно «зависло»

Скорее всего идёт длинный запрос. Дайте 30 секунд.
Если не отзывается дольше — Force Quit и заново. Запросы в Postgres продолжат работать (закрытие клиента не отменяет уже отправленные запросы; используйте Live Ops после рестарта).

Логи ide99

Если что-то непонятное — логи ide99 могут помочь:

ОС	Путь
macOS	`~/Library/Logs/ide99/ide99.log`
Windows	`%LOCALAPPDATA%\ide99\logs\ide99.log`
Linux	`~/.local/state/ide99/ide99.log`

Файл текстовый, можно открыть в любом редакторе. Не содержит ваших SQL и данных — только события приложения, ошибки.

Связаться

support@ide99.ru — опишите проблему, приложите:

Версию ide99 (Settings → Updates → About)
ОС и версию
Версию Postgres (если связано с подключением)
Шаги, которые привели к ошибке
Скриншот, если возможно

Что дальше

Горячие клавиши — что нажимать.
Настройки приложения — где конфигурируется поведение.