> ## 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, ізольований, масштабований до нуля, з об'єднаними та прямими з'єднаннями. Попросіть AI створити одну, і він налаштує та керуватиме обліковими даними.

## Створення бази даних

Розповідьте AI, що потрібно додатку. Він повинен спочатку перелічити існуючі бази даних і повторно використати відповідну активну базу, якщо вона існує. Він створює новий екземпляр Postgres лише коли ви просите ізоляцію або жодна існуюча база не підходить.

## Облікові дані

Облікові дані бази даних керуються через [сховище](/work/vault).

* **Переглянути облікові дані** — повертає поточні URI з'єднання для бази даних.
* **Відновити облікові дані** — скидає пароль бази даних і створює нові секрети сховища. Використовуйте, коли облікові дані відсутні, скомпрометовані або потребують ротації. Старі облікові дані перестають працювати негайно.

### Використання облікових даних у додатку

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

Для ручних локальних команд запустіть через CLI Kazzle з правильною колекцією та середовищем:

```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 може запускати ці міграції як частину потоку розгортання вашого додатку. Якщо синхронізація в реальному часі ввімкнена, AI також оновлює пов'язане налаштування синхронізації.

## Увімкнення синхронізації в реальному часі

Попросіть AI увімкнути синхронізацію на базі даних. Він повинен чекати, поки база даних не покаже `sync: ready`, перш ніж підключати додаток реального часу. Див. [Синхронізація в реальному часі](/apps/sync), щоб дізнатися, як це працює.

## Видалення бази даних

Попросіть AI видалити базу даних. Kazzle спочатку позначає її як видалену, і база даних може бути відновлена перед постійним очищенням.

## Приклад: налаштування бази даних з нуля

1. "Створи базу даних під назвою my-app-db"
2. AI повторно використовує відповідну базу даних або налаштовує Postgres та зберігає облікові дані у сховищі
3. "Створи таблицю todos з id, text, done та created\_at"
4. AI запускає SQL
5. "Підключи її до мого додатку" — AI з'єднує базу даних з компонентом процесу додатку

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