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

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

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

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

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

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

Для сгенерированных приложений ИИ подключает учётные данные базы в компонент процесса с помощью инструмента db. Код приложения читает обычные переменные окружения, такие как DATABASE_URL и DIRECT_DATABASE_URL. Для ручных локальных команд используйте Kazzle CLI с нужной коллекцией и окружением: 
{
  "scripts": {
    "dev": "kazzle run --collection=my-saas --env=dev -- bun run server.ts"
  }
}
Не помещайте URL базы данных в код фронтенда или переменные VITE_*.

​
Миграции

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

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

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

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

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

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

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