Object model overview

Stable

Каноническая объектная модель: tenant → databases → timeline → compute; где хранится истина.

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

Ключевые сущности Control Plane и их связи.

          Account
└─ Tenant
   ├─ Database
   │   ├─ Timeline (истина состояния)
   │   ├─ Current compute (0/1)
   │   └─ Credentials (pg_user/pg_password, client_token)
   └─ Tenant-level secrets & quotas

Tenant: логический контейнер для множества БД. Имеет свой API scope и шаблон DSN.
Database: запись каталога CP + timeline в Pageserver/Safekeeper. Может быть в state creating/ready/stopped/error/deleting.
Timeline: источник истины состояния БД, живёт в S3 через Pageserver/Safekeeper. Compute всегда подключается к конкретному timeline.
Compute: одноразовая ВМ PostgreSQL, текущее значение scale (0 или 1) и флаги auto start/stop.
Credentials: pg_user/pg_password на уровне tenant и опциональный client_token для БД. Не путать с API key.

Истина хранится в каталоге Control Plane (метаданные, токены, связи) и в timeline в S3 (данные БД). Compute — кэшируемый слой без уникального состояния.