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

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

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

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

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

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

Для сгенерированных приложений ИИ подключает учётные данные базы данных в компонент процесса с помощью инструмента db. Код приложения читает обычные переменные окружения, такие как DATABASE_URL и DIRECT_DATABASE_URL. Для ручных локальных команд используйте Kazzle CLI с нужной коллекцией и окружением:
Не помещайте 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. “Подключи её к моему приложению” — ИИ подключает базу данных к компоненту процесса приложения
Для приложений реального времени с поддержкой автономной работы ИИ также включает синхронизацию и настраивает схему на стороне клиента. Полный процесс см. в разделе Синхронизация в реальном времени.