DokuFormulare und Daten

Datenbanken

nx new kann eine Modellebene mit SQLModel, SQLAlchemy oder Tortoise-ORM aufbauen. Nexy umschließt das ORM nicht: Sie verwenden es direkt über Handler und Seiten.

Was das Gerüst hinzufügt

Datei	Zweck
`src/configs/db.py`	die Engine (SQLModel, SQLAlchemy) oder die `TORTOISE_ORM`-Einstellungen
`src/models/`	Modellklassen
`src/services/`	Funktionen, die die Modelle abfragen
`.env`	`DATABASE_URL`, geschrieben, wenn Sie während `nx new` eine Datenbank-URL angeben

Die Verbindungszeichenfolge stammt aus der Umgebungsvariablen DATABASE_URL. Wenn es nicht festgelegt ist, greift die Gerüst-Engine auf eine lokale SQLite-Datei, dev.db zurück.

Verwenden Sie einen Dienst auf einer Seite

src/routes/users/index.nexy

---from src.services.user_service import UserServiceusers = UserService.get_all()---<ul>  {% for user in users %}  <li>{{ user.name }}</li>  {% endfor %}</ul>

Verwenden Sie einen Dienst in einem API-Handler

src/routes/api/users.py

from src.services.user_service import UserService  async def GET():    return UserService.get_all()

Ein Controller ruft den Dienst auf und übergibt die Zeilen an seine Ansicht oder gibt sie als JSON zurück:

src/apps/users/user_controller.py

from nexy.decorators import Controllerfrom nexy.hooks import useViews from src.services.user_service import UserService  @Controller("/users")class UserController:    async def get(self):        users = UserService.get_all()        return useViews("src/apps/users/user_view.nexy", context={"users": users})  @Controller("/api/users")class UserApiController:    async def get(self):        return UserService.get_all()

src/apps/users/user_view.nexy

---users: prop[list] = []---<ul>  {% for user in users %}  <li>{{ user.name }}</li>  {% endfor %}</ul>

Tortoise-ORM ist asynchron

Eine Seite läuft in der Ereignisschleife des Servers und kann nicht darauf warten, daher schlägt asyncio.run(...) dort mit „kann nicht aus einer laufenden Ereignisschleife aufgerufen werden“ fehl. Das Gerüst src/configs/db.py gibt Tortoise eine eigene Schleife in einem Thread und zwei Helfer, die ihm eine Coroutine senden:

Wo du bist	Rufen Sie an	Tut
Synchronisierungscode, z. B. eine Seite	`run(UserService.get_all())`	führt es aus und gibt das Ergebnis zurück
asynchroner Code, z. B. ein Handler oder ein Controller	`await arun(UserService.get_all())`	das Gleiche, ohne den Server zu blockieren

src/routes/users/index.nexy

---from src.configs.db import runfrom src.services.user_service import UserServiceusers = run(UserService.get_all())---

Ein Controller ist asynchron: Er wartet bis arun auf den Dienst und die Ansicht zeigt nur die Zeilen:

src/apps/users/user_controller.py

from nexy.decorators import Controllerfrom nexy.hooks import useViews from src.configs.db import arunfrom src.services.user_service import UserService  @Controller("/users")class UserController:    async def get(self):        users = await arun(UserService.get_all())        return useViews("src/apps/users/user_view.nexy", context={"users": users})

Tortoise stellt eine Verbindung her, wenn einer von ihnen zum ersten Mal aufgerufen wird. Rufen Sie das Modell von einem async def (await UserModel.all() innerhalb eines Dienstes auf, nicht auf Modulebene: Ein Aufruf außerhalb einer Coroutine wird ausgeführt, bevor Tortoise eine Verbindung hergestellt hat.

Listen Sie jedes Modul auf, das Modelle in TORTOISE_ORM enthält (der models-Eintrag von src/configs/db.py). Das Gerüst listet das Benutzermodell und aerich.models auf; Ein Modell in einem Modul, das nicht aufgeführt ist, wurde nicht gefunden.

Migrationen

nx migrate wählt das Tool für Ihr ORM aus: Alembic für SQLModel und SQLAlchemy, Aerich für Tortoise-ORM.

Befehl	Tut
`nx migrate --init`	Initialisieren Sie das Migrationstool für das Projekt
`nx migrate -m "add users"`	Erstellen Sie eine Migration aus Ihren Modelländerungen
`nx migrate --upgrade`	Ausstehende Migrationen anwenden

Mit Aerich führt der erste nx migrate aerich init-db aus, wodurch die erste Migration und die Tabellen zusammen erstellt werden; Die nächsten führen aerich migrate --name "..." aus, und --upgrade führt aerich upgrade aus.

nx migrate stoppt mit einer eindeutigen Meldung, wenn DATABASE_URL fehlt oder die Datenbank nicht erreichbar ist (nur Alembic: Aerich meldet eigene Fehler).

Die erste Migration wird für Sie durchgeführt

Wenn Sie einen ORM auswählen und eine Datenbank-URL angeben, richtet nx new das Migrationstool ein, erstellt die erste Migration und wendet sie an, sodass die Benutzerseite auf die erste nexy dev antwortet. Das Migrationstool (alembic oder aerich) wird im Projekt mit dem ORM installiert.

Wenn die Datenbank nicht antwortet (ein PostgreSQL-Server, der nicht läuft, ein fehlender Treiber), sagt nx new den Grund, überspringt die Migration und listet die beiden Befehle auf, die ausgeführt werden sollen, wenn sie bereit ist:

nexy migrate -m "create tables"nexy migrate --upgrade

Bis die Tabellen vorhanden sind, schlägt eine Seite, die die Datenbank liest, mit „keine solche Tabelle“ fehl.

Fügen Sie ein Modell hinzu

Alembic vergleicht die Datenbank mit den Modellen, die alembic/env.py importiert. Ein Modell in einem neuen Modul wird erst angezeigt, wenn dieses Modul dort neben dem Benutzermodell importiert wird:

alembic/env.py

import src.models.user_model  # noqa: F401import src.models.post_model  # noqa: F401

Listen Sie für Tortoise-ORM das Modul stattdessen in TORTOISE_ORM auf (siehe oben).

Nächste Schritte

Testen: Testhandler anhand einer temporären Datenbank
Konfiguration
Deployment: DATABASE_URL in der Produktion festlegen

Auf GitHub bearbeiten