ডকুমেন্টেশন/ফর্ম এবং তথ্য

ডাটাবেস

nx new SQLModel, SQLAlchemy বা কচ্ছপ-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>

কচ্ছপ-ORM async হয়

একটি পৃষ্ঠা সার্ভারের ইভেন্ট লুপে চলে এবং এটিতে অপেক্ষা করতে পারে না, তাই 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()) পরিষেবার ভিতরে থেকে মডেলটিকে কল করুন, মডিউল স্তরে নয়: একটি করটিনের বাইরে একটি কল Tortoise সংযুক্ত হওয়ার আগে চলে।

TORTOISE_ORM (src/configs/db.py-এর models এন্ট্রিতে মডেল ধারণ করে এমন প্রতিটি মডিউলের তালিকা করুন। ভারা ব্যবহারকারী মডেল এবং aerich.models তালিকাভুক্ত করে; তালিকাভুক্ত নয় এমন একটি মডিউলের একটি মডেল পাওয়া যায় না।

মাইগ্রেশন

nx migrate আপনার ORM-এর জন্য টুলটি বেছে নেয়: Alembic SQLModel এবং SQLAlchemy, Aerich কচ্ছপ-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-এ সম্পাদনা করুন