الوثائق/النماذج والبيانات

قواعد البيانات

nx new يمكن أن يدعم طبقة نموذجية باستخدام SQLModel، SQLAlchemy أو Tortoise-ORM. لا يقوم Nexy بتغليف ORM: يمكنك استخدامه مباشرةً من المعالجات والصفحات.

ما تضيفه السقالة

تأتي سلسلة الاتصال من متغير البيئة DATABASE_URL. عندما يتم عدم ضبطه، يعود محرك السقالات إلى ملف SQLite محلي، dev.db.

استخدام الخدمة في الصفحة

---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 غير متزامن

يتم تشغيل الصفحة في حلقة حدث الخادم ولا يمكنها الانتظار، لذلك يفشل asyncio.run(...) هناك مع "لا يمكن استدعاؤها من حلقة حدث قيد التشغيل". السقالة src/configs/db.py تعطي Tortoise حلقة خاصة بها، في خيط واحد، ومساعدين يرسلان لها كوروتين:

---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 يتصل أول مرة يتم استدعاء أحدهما. استدعاء النموذج من async def (await UserModel.all() داخل الخدمة)، وليس على مستوى الوحدة: يتم تشغيل مكالمة خارج coroutine قبل اتصال Tortoise.

قم بإدراج كل وحدة تحتوي على نماذج في TORTOISE_ORM (المدخل models في src/configs/db.py). تسرد السقالة نموذج المستخدم و aerich.models؛ لم يتم العثور على نموذج في الوحدة النمطية غير المدرجة.

الهجرات

nx migrate يختار الأداة لـ ORM الخاص بك: Alembic لـ SQLModel و SQLAlchemy، Aerich لـ Tortoise-ORM.

مع Aerich، يتم تشغيل nx migrate الأول aerich init-db، مما يؤدي إلى إنشاء الترحيل الأول والجداول معًا؛ التالية تجري aerich migrate --name "..."، و --upgrade تجري aerich upgrade.

nx migrate يتوقف برسالة واضحة عندما يكون DATABASE_URL مفقودًا أو لا يمكن الوصول إلى قاعدة البيانات (Alembic فقط: يبلغ Aerich عن الأخطاء الخاصة به).

الهجرة الأولى مصنوعة لك

عندما تختار ORM وتعطي عنوان URL لقاعدة البيانات، يقوم nx new بإعداد أداة الترحيل، وإنشاء أول ترحيل وتطبيقه، بحيث تجيب صفحة المستخدمين على nexy dev الأول. تم تثبيت أداة الترحيل (alembic أو aerich) في المشروع باستخدام ORM.

إذا لم تستجب قاعدة البيانات (خادم PostgreSQL لا يعمل، برنامج تشغيل مفقود)، nx new يوضح السبب، ويتخطى الترحيل ويسرد الأمرين المطلوب تشغيلهما عندما يكون جاهزًا:

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

وإلى أن توجد الجداول، تفشل الصفحة التي تقرأ قاعدة البيانات مع ظهور عبارة "لا يوجد مثل هذا الجدول".

إضافة نموذج

Alembic يقارن قاعدة البيانات مع النماذج التي يستوردها alembic/env.py. لا يتم رؤية النموذج الموجود في وحدة نمطية جديدة حتى يتم استيراد تلك الوحدة هناك، بجوار نموذج المستخدم:

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

بالنسبة إلى Tortoise-ORM، قم بإدراج الوحدة في TORTOISE_ORM بدلاً من ذلك (انظر أعلاه).

الخطوات التالية

• الاختبار : اختبار المعالجات مقابل قاعدة بيانات مؤقتة
• التكوين
• نشر : تعيين DATABASE_URL في الإنتاج

انسخ الصفحة بصيغة Markdown حرِّر على GitHub