> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kazzle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Базы данных

> Выделенные экземпляры Postgres для ваших приложений.

Каждая база данных — это выделенный экземпляр Postgres, изолированный, масштабируемый до нуля, с объединённым пулом соединений и прямыми подключениями. Попросите ИИ создать базу, и он настроит её и управляет учётными данными.

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

Расскажите ИИ, что нужно приложению. Он должен сначала показать существующие базы и переиспользовать подходящую активную базу, если она есть. Новый экземпляр Postgres создаётся только если вы просите изоляцию или подходящей базы нет.

## Учётные данные

Учётные данные базы данных управляются через [хранилище](/work/vault).

* **Просмотр учётных данных** — возвращает текущие URI подключения к базе.
* **Обновить учётные данные** — сбрасывает пароль базы и создаёт новые секреты в хранилище. Используйте, когда учётные данные потеряны, скомпрометированы или требуют ротации. Старые учётные данные перестают работать сразу.

### Использование учётных данных в приложении

Для сгенерированных приложений ИИ подключает учётные данные базы в компонент процесса с помощью инструмента `db`. Код приложения читает обычные переменные окружения, такие как `DATABASE_URL` и `DIRECT_DATABASE_URL`.

Для ручных локальных команд используйте Kazzle CLI с нужной коллекцией и окружением:

```json theme={"theme":"material-theme-darker"}
{
  "scripts": {
    "dev": "kazzle run --collection=my-saas --env=dev -- bun run server.ts"
  }
}
```

Не помещайте URL базы данных в код фронтенда или переменные `VITE_*`.

## Миграции

Изменения схемы размещаются в SQL-файлах в репозитории приложения (например `migrations/001_create_todos.sql`). Kazzle может запускать эти миграции как часть процесса развёртывания приложения. Если включена синхронизация в реальном времени, ИИ также обновляет связанную настройку синхронизации.

## Включение синхронизации в реальном времени

Попросите ИИ включить синхронизацию на базе данных. Он должен дождаться, пока база покажет `sync: ready`, прежде чем подключать приложение реального времени. См. [Синхронизация в реальном времени](/apps/sync) для подробностей.

## Удаление базы данных

Попросите ИИ удалить базу данных. Kazzle сначала отмечает её как удалённую, и база может быть восстановлена перед окончательной очисткой.

## Пример: настройка базы данных с нуля

1. "Создай базу данных my-app-db"
2. ИИ переиспользует подходящую базу или настраивает Postgres и сохраняет учётные данные в хранилище
3. "Создай таблицу todos с полями id, text, done и created\_at"
4. ИИ выполняет SQL
5. "Подключи её к моему приложению" — ИИ соединяет базу с компонентом процесса приложения

Для приложений реального времени с поддержкой офлайна ИИ также включает синхронизацию и настраивает схему на стороне клиента. См. [создание приложения реального времени](/apps/build-and-publish) для полного процесса.