Описание БД

Describe — основной способ понять, что сейчас происходит с базой и нужен ли от вас следующий шаг.

На какие поля смотреть в первую очередь

state

Главное lifecycle‑поле: creating, booting, ready, stopped, deleting, error.

status

Совместимый alias для старых клиентов и скриптов.

size

Публичный размерный label, который видит пользователь.

current_scale и target_scale

Показывают, запущен writer или нет. В managed‑контракте это по сути бинарный статус 0/1.

current_profile

Профиль, на котором сейчас реально работает активный writer.

target_profile

Профиль, к которому платформа пытается перейти в рамках текущего autoscale‑handoff.

candidate_profile

Профиль подготовленного candidate generation.

scale_state

Текущая стадия autoscaler‑машины. Если она отличается от STEADY, значит сейчас идёт handoff, cooldown или сбой.

freeze_new_checkouts

Показывает, заморозил ли Gateway новые checkout'ы перед cutover.

candidate_worker_id и candidate_writer_term

Полезны для диагностики нового поколения writer во время перехода.

scale_failure_reason

Если autoscale‑handoff сорвался, это поле даёт лучший короткий диагноз.

worker_id

Полезен для диагностики, когда база активна. Не стоит строить на нём бизнес‑логику.

active_connections

Помогает понять, используется ли база прямо сейчас.

last_used_at

Полезно для анализа idle‑поведения и общей активности.

Как интерпретировать результат

• state=ready и scale_state=STEADY — обычный стабильный режим.
• state=stopped — база не потеряна, writer сейчас просто выключен.
• scale_state=PREPARING/FREEZING/DRAINING/... — идёт controlled handoff между поколениями writer.
• scale_state=FAILED — переход сорвался и нужен разбор метрик/логов.
• freeze_new_checkouts=true — это не авария, а нормальная фаза cutover.

Практический смысл

Describe нужен не только для API‑автоматизации. Это ещё и самый быстрый способ оператору или разработчику понять, что именно происходит с ресурсом:

• обычный cold start;
• idle stop;
• controlled autoscale handoff;
• или реальная ошибка.