Раздел вышел длинным, а команд в нём на самом деле немного. Здесь они собраны на одной странице: сначала порядок быстрой отладки, потом шпаргалка на каждый день, в конце — программы, которыми с базой работать приятнее, чем голым терминалом.
Быстрая отладка базы
Когда приходит «база не отвечает», команды идут в одном и том же порядке — от грубого к тонкому. Каждая отвечает на свой вопрос, и следующую запускают, только если предыдущая ответила «всё нормально». Флаг -a показывает и остановленные контейнеры, --tail 20 — двадцать последних строк журнала, -h у df — размеры в понятных единицах.
docker compose ps -a # жив ли контейнер, healthy ли docker compose exec db pg_isready -U shop # принимает ли подключения docker compose logs db --tail 20 # что база написала: FATAL, PANIC
df -h / # есть ли место на диске docker compose exec db psql -U shop # дальше — запросы ниже
Если база жива и место есть, дальше смотрят изнутри: сколько подключений и кто кого ждёт.
SELECT count(*) FROM pg_stat_activity; SELECT pid, state, wait_event_type FROM pg_stat_activity; SELECT pg_terminate_backend(<pid>); -- снять виновника
Строка idle in transaction — забытая транзакция, wait_event_type = Lock — запрос, который её ждёт. С этой парой ты разобрался в миссии.
Шпаргалка раздела
Всё остальное, что делалось руками за раздел, укладывается в семь команд. Флаг -T у exec нужен, когда через Docker передаётся файл, -c у psql выполняет одну команду и выходит.
docker compose exec db psql -U shop -c '\dt' # какие таблицы есть docker compose exec -T db pg_dump -U shop shop > shop.sql # копия docker compose exec db createdb -U shop shop_check # пустая база
docker compose exec -T db psql -U shop shop < shop.sql # залить копию docker compose exec cache redis-cli ping # жив ли Redis docker compose exec cache redis-cli info stats # попадания, вытеснение
И три привычки, которые важнее любой команды: перед правкой — BEGIN и SELECT count(*) с тем же условием; копия считается, только когда из неё восстановились; очередь сообщений не очищают, чтобы «стало зелёным».
Чем подключаются кроме psql
psql есть везде, но набирать в нём длинные запросы неудобно. Для ежедневной работы обычно ставят что-то из этого.
| Программа | Что это | Когда пригодится |
|---|---|---|
| pgcli | Консольный клиент с автодополнением имён таблиц и подсветкой | Вместо psql на стенде и через SSH |
| DBeaver | Бесплатный клиент с окнами для Postgres, MySQL и десятков других баз; Redis только в платной редакции | Посмотреть таблицы глазами и выгрузить результат в файл |
| pgAdmin | Официальный веб-интерфейс Postgres | Когда нужен доступ из браузера |
| RedisInsight | Официальный интерфейс Redis: ключи, память, медленные команды | Разбор «что лежит в кэше» |
К рабочей базе такими программами подключаются через SSH-туннель, тем же приёмом ssh -L, что в разделе «Linux: сервер», в уроке про ежедневную работу с SSH. Открывать порт базы наружу ради клиента нельзя.
Разбор медленных запросов
Когда дело дойдёт до вопроса «почему база тормозит» не на одном запросе, а в целом, пригодятся две вещи. Расширение pg_stat_statements копит статистику по всем запросам: сколько раз выполнялся, сколько времени съел. pgBadger читает журнал Postgres и строит отчёт-страницу с самыми медленными и частыми запросами. Сайты вроде explain.dalibo.com рисуют вывод EXPLAIN ANALYZE деревом, где сразу видно, какой шаг дольше всех.
На старте достаточно знать, что они есть. В следующем разделе, про мониторинг, такие числа станут графиками: в практике про метрики приложения ты поставишь готовый экспортёр postgres-exporter и увидишь подключения к этой самой базе.
Что дальше
Раздел закончен. Дальше — мониторинг: как видеть, что база, кэш и всё остальное живы, не заходя на сервер.