Przejdź do głównej treści
Każda baza danych to dedykowana instancja Postgres — izolowana, skalowalna do zera, z połączeniami poolowanymi i bezpośrednimi. Poproś AI o utworzenie bazy, a ona zajmie się konfiguracją i poświadczeniami.

​
Tworzenie bazy danych

Powiedz AI, czego potrzebuje aplikacja. Powinna najpierw wyświetlić istniejące bazy danych i ponownie użyć odpowiedniej aktywnej bazy, jeśli taka istnieje. Nową instancję Postgres tworzy tylko wtedy, gdy poprosisz o izolację lub żadna istniejąca baza nie pasuje.

​
Poświadczenia

Poświadczenia bazy danych są zarządzane przez vault.
  • Wyświetl poświadczenia — zwraca bieżące identyfikatory URI połączenia dla bazy danych.
  • Regeneruj poświadczenia — resetuje hasło bazy danych i tworzy nowe sekrety vault. Użyj, gdy poświadczenia są niedostępne, skompromitowane lub wymagają rotacji. Stare poświadczenia przestają działać natychmiast.

​
Używanie poświadczeń w aplikacji

W przypadku wygenerowanych aplikacji AI podłącza poświadczenia bazy danych do komponentu procesu za pomocą narzędzia db. Kod aplikacji odczytuje zwykłe zmienne środowiskowe, takie jak DATABASE_URL i DIRECT_DATABASE_URL. W przypadku ręcznych poleceń lokalnych uruchom je przez Kazzle CLI z odpowiednią kolekcją i środowiskiem: 
{
  "scripts": {
    "dev": "kazzle run --collection=my-saas --env=dev -- bun run server.ts"
  }
}
Nie umieszczaj adresów URL bazy danych w kodzie frontend lub zmiennych VITE_*.

​
Migracje

Zmiany schematu znajdują się w plikach SQL w repozytorium aplikacji (np. migrations/001_create_todos.sql). Kazzle może uruchamiać te migracje w ramach przepływu wdrażania aplikacji. Jeśli synchronizacja w czasie rzeczywistym jest włączona, AI aktualizuje również powiązaną konfigurację synchronizacji.

​
Włączanie synchronizacji w czasie rzeczywistym

Poproś AI o włączenie synchronizacji na bazie danych. Powinna czekać, aż baza danych pokaże sync: ready, zanim podłączy aplikację w czasie rzeczywistym. Przeczytaj Synchronizacja w czasie rzeczywistym, aby dowiedzieć się, jak to działa.

​
Usuwanie bazy danych

Poproś AI o usunięcie bazy danych. Kazzle oznacza ją jako usuniętą, a baza danych może być przywrócona przed trwałym czyszczeniem.

​
Przykład: konfiguracja bazy danych od zera

  1. “Utwórz bazę danych o nazwie my-app-db”
  2. AI ponownie używa odpowiedniej bazy danych lub konfiguruje Postgres i przechowuje poświadczenia w vault
  3. “Utwórz tabelę todos z kolumnami id, text, done i created_at”
  4. AI uruchamia SQL
  5. “Podłącz ją do mojej aplikacji” — AI łączy bazę danych z komponentem procesu aplikacji
W przypadku aplikacji w czasie rzeczywistym z obsługą offline AI włącza również synchronizację i konfiguruje schemat po stronie klienta. Przeczytaj budowanie aplikacji w czasie rzeczywistym, aby poznać pełny przepływ.