←К документации

Database states: state machine

Stable

Все состояния БД, триггеры переходов, типовые ошибки и диагностические шаги.

Обновлено: 3 февраля 2026 г.

Состояния БД управляются Control Plane и отражают жизненный цикл compute.

stopped -> creating -> booting -> ready -> stopping -> stopped
 \\-> error
 \\-> deleting

Триггеры

  • creating: create DB или start при отсутствии compute.
  • booting: Provisioner создал ВМ, агент проходит hello, PostgreSQL стартует.
  • ready: успешный bootstrap; Gateway может подключать клиентов.
  • stopping: ручной stop или idle‑таймер CP.
  • error: сбой bootstrap/hello, таймаут старта, проблемы с страницами/WAL.
  • deleting: запрос delete DB/tenant.

Если state=error

  • Повторите start — CP выдаст новый register_token и создаст новую ВМ.
  • Проверьте доступность S3/Safekeeper/Pageserver; убедитесь, что WAL/timeline целы.
  • Посмотрите логи агента/Provisioner и события CP (work log).
  • При повторяемом сбое зафиксируйте в /troubleshooting/db-stuck-creating-booting.