• English

مدل سازی MySQL

در این بخش نحوه تعریف مدل‌ها برای MySQL با استفاده از کتابخانه AbarORM را بررسی خواهیم کرد.

مثال پایه

برای استفاده از MySQL با AbarORM، باید مدل‌های خود را از MySQLModel ارث بری کنید. در اینجا یک مثال پایه آورده شده است:

from abarorm import MySQLModel
from abarorm.fields import CharField, DateTimeField, ForeignKey

DATABASE_CONFIG = {
    'mysql': {
        'host': 'localhost',
        'user': 'your_user',
        'password': 'your_password',
        'db_name': 'example_db',  # MySQL database name
    }
}

class Category(MySQLModel):
    title = CharField(max_length=200, unique=True)
    class Meta:
        db_config = DATABASE_CONFIG['mysql']
        table_name = 'categories'  # Name of the table for storing the Category model data in MySQL


class Post(MySQLModel):
    title = CharField(max_length=100, unique=True)
    create_time = DateTimeField(auto_now=True)
    category = ForeignKey(Category)
    class Meta:
        db_config = DATABASE_CONFIG['mysql']

مدیریت خودکار جداول

در نسخه جدید AbarORM، دیگر نیازی به ایجاد دستی جداول نیست. این کتابخانه به طور خودکار ایجاد و مدیریت جداول شما را بر اساس تعاریف مدل انجام می‌دهد. به این معنی که به محض شروع تعامل با مدل‌های خود، AbarORM اطمینان حاصل می‌کند که اگر جداول مربوطه از قبل وجود نداشته باشند، ایجاد می‌شوند. با این حال، شما می‌توانید به صورت دستی نام جداول را با تعریف متغیر table_name در کلاس Meta مدیریت کنید.

بروزرسانی خودکار اسکیمای پایگاه داده

AbarORM همچنین از بروزرسانی خودکار اسکیما پشتیبانی می‌کند. اگر فیلدهای جدیدی به مدل‌های خود اضافه کنید در حالی که اپلیکیشن در حال اجرا است، AbarORM به طور خودکار اسکیما پایگاه داده را برای منعطف کردن این تغییرات به روز خواهد کرد. این امر نیاز به اسکریپت‌های مهاجرت دستی یا بازسازی پایگاه داده را از بین می‌برد.

هشدار

اگرچه بروزرسانی‌های اسکیما به طور خودکار انجام می‌شود، توصیه می‌شود که پس از تکمیل توسعه، اسکیما پایگاه داده خود را دوباره ایجاد کنید تا از اعمال صحیح تمامی فیلدها و محدودیت‌ها اطمینان حاصل کنید. این کمک می‌کند تا از مشکلات احتمالی جلوگیری شود و اطمینان حاصل کنید که پایگاه داده شما قبل از حرکت به سمت تولید در وضعیت ثابتی قرار دارد.

CRUD

نوع و روش CRUD در مدل سازی و استفاده از بانک های اطلاعاتی تفاوتی ندارد و برای ایجاد آنها می توانید به صفحه Basic Usage - CRUD مراجعه کنید.