Глоссарий

Stable

Словарь терминов SPG99: tenant, timeline, compute, soft basebackup, candidate writer, freeze, drain и другие ключевые понятия.

Обновлено: 21 марта 2026 г.

Tenant — логический контейнер в каталоге SPG99. Владеет набором БД и tenant‑кредитами pg_user / pg_password.
Database — конкретная PostgreSQL‑БД внутри tenant, у которой есть lifecycle (creating, booting, ready, stopped и т. д.).
Timeline — долговечная история состояния базы на storage‑стороне платформы.
Compute — рабочий PostgreSQL‑исполнитель. Выполняет SQL и использует локальный диск как write‑back cache.
Gateway — единая внешняя PostgreSQL‑точка входа по TLS. Приложения подключаются именно сюда.
Control Plane — управляющий слой платформы. Хранит каталог, запускает и останавливает БД, управляет leases и autoscaler‑состоянием.
Provisioner — компонент, который создаёт и удаляет Compute‑воркеры в инфраструктуре.
Pageserver — сервис bootstrap и истории данных. Отдаёт soft basebackup и обслуживает remote read‑through.
Safekeeper — сервис надёжности WAL. Обычно используется кворум из трёх узлов.
Cold start — первый запуск Compute после stopped, когда БД нужно снова довести до ready.
Soft basebackup — тонкий startup‑образ от Pageserver. Локально остаётся только стартовый минимум, а пользовательские relation pages дочитываются по мере необходимости.
Thin startup image — минимальный набор файлов и метаданных, достаточный для старта PostgreSQL без полного локального PGDATA.
Write-back cache — локальный рабочий слой Compute. Ускоряет чтения и записи, но не является единственным durable‑источником истины.
Writer term — поколение активного writer. Используется для защиты от split‑brain.
Current profile / target profile — текущий и целевой профиль writer в autoscaler‑контракте.
Candidate writer — заранее подготовленное новое поколение writer для безопасного handoff между профилями.
Freeze new checkouts — режим, когда Gateway перестаёт выдавать новые checkout'ы на старый writer перед cutover.
Drain — фаза, когда платформа ждёт завершения активной нагрузки перед переключением writer.
Pinned session — соединение, которое нельзя бесшовно перевести transaction‑pooling cutover’ом из‑за session‑state.
Scale state — стадия autoscaler‑handoff: STEADY, PREPARING, FREEZING, DRAINING, STOPPING_OLD, STARTING_NEW, SWITCHING, COOLDOWN, FAILED.
Ready / Readiness — состояние, при котором база действительно готова принимать рабочий трафик.
DSN — строка подключения PostgreSQL к Gateway.
API key — ключ для Control Plane API, Console и CLI. Не используется внутри PostgreSQL DSN.