Provision
—— XP

Инструменты: шпаргалка по базам

теория~4 минут+180 XP

Раздел вышел длинным, а команд в нём на самом деле немного. Здесь они собраны на одной странице: сначала порядок быстрой отладки, потом шпаргалка на каждый день, в конце — программы, которыми с базой работать приятнее, чем голым терминалом.

Быстрая отладка базы

Когда приходит «база не отвечает», команды идут в одном и том же порядке — от грубого к тонкому. Каждая отвечает на свой вопрос, и следующую запускают, только если предыдущая ответила «всё нормально». Флаг -a показывает и остановленные контейнеры, --tail 20 — двадцать последних строк журнала, -h у df — размеры в понятных единицах.

ubuntu@stand:~$
docker compose ps -a                # жив ли контейнер, healthy ли
docker compose exec db pg_isready -U shop   # принимает ли подключения
docker compose logs db --tail 20    # что база написала: FATAL, PANIC
ubuntu@stand:~$
df -h /                             # есть ли место на диске
docker compose exec db psql -U shop # дальше — запросы ниже

Если база жива и место есть, дальше смотрят изнутри: сколько подключений и кто кого ждёт.

SQL
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 выполняет одну команду и выходит.

ubuntu@stand:~$
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          # пустая база
ubuntu@stand:~$
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 и увидишь подключения к этой самой базе.

Что дальше

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

Проверь себя+180 XPдве попытки
1
Отладка
С какой команды начинают, когда «база не отвечает»?
2
Клиенты
Чем pgcli отличается от psql?
3
Разбор журнала
Что делает pgBadger?
ответь на все вопросы, чтобы проверить

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.