Dokumentasi/Formulir dan data

Basis Data

nx new dapat merancah lapisan model dengan SQLModel, SQLAlchemy atau Tortoise-ORM. Nexy tidak membungkus ORM: Anda menggunakannya secara langsung, dari penangan dan halaman.

Apa yang ditambahkan perancah

String koneksi berasal dari variabel lingkungan DATABASE_URL. Jika tidak disetel, mesin scaffold akan kembali ke file SQLite lokal, dev.db.

Gunakan layanan di halaman

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

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

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()

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

Tortoise-ORM tidak sinkron

Sebuah halaman berjalan di loop peristiwa server dan tidak dapat menunggu, jadi asyncio.run(...) gagal di sana dengan "tidak dapat dipanggil dari loop peristiwa yang sedang berjalan". Perancah src/configs/db.py memberikan Tortoise sebuah loopnya sendiri, dalam satu thread, dan dua pembantu yang mengirimkan coroutine ke sana:

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

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 menghubungkan saat pertama kali salah satunya dipanggil. Panggil model dari async def (await UserModel.all() di dalam layanan), bukan di tingkat modul: panggilan di luar coroutine dijalankan sebelum Tortoise terhubung.

Cantumkan setiap modul yang menampung model di TORTOISE_ORM (entri models dari src/configs/db.py). Perancah mencantumkan model pengguna dan aerich.models; model dalam modul yang tidak terdaftar tidak ditemukan.

Migrasi

nx migrate memilih alat untuk ORM Anda: Alembic untuk SQLModel dan SQLAlchemy, Aerich untuk Tortoise-ORM.

Dengan Aerich, nx migrate pertama dijalankan aerich init-db, yang membuat migrasi pertama dan tabel-tabelnya bersamaan; yang berikutnya menjalankan aerich migrate --name "...", dan --upgrade menjalankan aerich upgrade.

nx migrate berhenti dengan pesan yang jelas ketika DATABASE_URL hilang atau database tidak dapat dijangkau (hanya Alembic: Aerich melaporkan kesalahannya sendiri).

Migrasi pertama dibuat untuk Anda

Saat Anda memilih ORM dan memberikan URL database, nx new menyiapkan alat migrasi, membuat migrasi pertama dan menerapkannya, sehingga halaman pengguna menjawab pada nexy dev pertama. Alat migrasi (alembic atau aerich) dipasang di proyek dengan ORM.

Jika database tidak menjawab (server PostgreSQL tidak berjalan, driver hilang), nx new menjelaskan alasannya, lewati migrasi dan daftarkan dua perintah untuk dijalankan ketika sudah siap:

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

Sampai tabel tersebut ada, halaman yang membaca database gagal dengan "tidak ada tabel seperti itu".

Tambahkan model

Alembic membandingkan database dengan model yang alembic/env.py diimpor. Model dalam modul baru tidak akan terlihat sampai modul tersebut diimpor ke sana, di samping model pengguna:

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

Untuk Tortoise-ORM, daftarkan modulnya di TORTOISE_ORM (lihat di atas).

Langkah selanjutnya

• Pengujian: menguji penangan terhadap database sementara
• Konfigurasi
• Penerapan: mengatur DATABASE_URL dalam produksi

Salin halaman sebagai Markdown Sunting di GitHub