Базы данных

База данных — именованная точка назначения для ваших бэкапов.

Что такое база данных?

База данных (Database) — это объект в системе, представляющий одну конкретную базу данных вашего проекта. Он не хранит данные напрямую, а является «ведром», в которое пушатся снимки (снапшоты).

Репозиторий → База данных

Коммит → Снапшот (Snapshot)

git push → dbsend.backup()

git log → История снапшотов

Иерархия

Workspace (аккаунт/команда)

└── Project (группировка)

└── Database (одна БД) ← вы здесь

├── Snapshot v1

├── Snapshot v2

└── Snapshot v3

Создание базы данных

Через UI (дашборд)

Перейдите в "Databases" в боковом меню

Нажмите кнопку "+ Add Database"

Выберите проект, укажите название и тип БД

Получите API ключ — он привязан к данной базе данных

Через API

POST /v1/databases
Authorization: Bearer <jwt>

{
  "projectId": "uuid",
  "name": "production-db",
  "engineType": "sqlite"
}

Типы баз данных

sqliteРекомендован

Файлы .db, .sqlite, .sqlite3. Поддерживает diff-инспекцию таблиц.

duckdb

Аналитические БД .ddb. Поддерживает diff-инспекцию.

postgresql_dump

Plain SQL из pg_dump: CREATE/ALTER, COPY/INSERT, schema hash и оценка строк.

mysql_dump

Plain SQL из mysqldump: схема, обычные и extended INSERT, оценка строк.

generic_file

Любой файл: размер, checksum и файловый diff без разбора внутренней структуры.

Статусы базы данных

Статус	Описание
active	Принимает бэкапы
paused	Приём бэкапов приостановлен (POST /pause)
inactive	Создана, бэкапов ещё не было

Diff-инспекция

Для SQLite, DuckDB и plain SQL-дампов PostgreSQL/MySQL dbsend автоматически анализирует структуру после каждого бэкапа и вычисляет diff между снапшотами. Для generic file доступен файловый diff.

Что показывает diff:

+ Новые таблицы (количество строк)
~ Изменённые таблицы (дельта строк: было → стало)
− Удалённые таблицы

Diff доступен во вкладке “Snapshots”. Требует тариф Старт и выше.

Лимиты

Количество баз данных ограничено тарифом:

Тариф	Баз данных
Free	1
Старт	5
Про	20
Команда	∞
Enterprise	∞

Все лимиты тарифов