Django ORM Documentation: Difference between revisions

From binaryoption
Jump to navigation Jump to search
Баннер1
(@pipegas_WP)
 
(@pipegas_WP)
 
Line 1: Line 1:
=== Django ORM Documentation ===
=== Django ORM Documentation ===


'''Django Object-Relational Mapper (ORM)''' هو أداة قوية تسمح لك بالتفاعل مع قواعد البيانات باستخدام كود بايثون، بدلاً من كتابة استعلامات SQL مباشرة. يوفر Django ORM طبقة تجريد بين كود بايثون الخاص بك وقاعدة البيانات، مما يجعل الكود الخاص بك أكثر قابلية للنقل وأسهل في الصيانة. هذه الوثيقة هي دليل للمبتدئين لاستكشاف Django ORM.
'''مقدمة'''
Django Object-Relational Mapper (ORM) هو أداة قوية تسمح لك بالتفاعل مع قواعد البيانات باستخدام كود بايثون بدلاً من كتابة استعلامات SQL مباشرة. يوفر Django ORM تجريدًا لقواعد البيانات المختلفة، مما يعني أنك يمكنك تغيير قاعدة البيانات المستخدمة (مثل PostgreSQL أو MySQL أو SQLite) دون الحاجة إلى تغيير الكثير من الكود الخاص بك. هذه المقالة موجهة للمبتدئين وتهدف إلى تقديم نظرة عامة شاملة على وثائق Django ORM وكيفية استخدامها بفعالية.


== ما هو ORM ولماذا نستخدمه؟==
== فهم أساسيات Django ORM ==


'''ORM''' تعني "Object-Relational Mapping" (تخطيط الكائن العلائقي).  ببساطة، يتيح لك ORM التعامل مع البيانات في قاعدة البيانات ككائنات بايثون.  بدلاً من كتابة استعلامات SQL معقدة، يمكنك استخدام كود بايثون بسيط لقراءة وكتابة وتحديث وحذف البيانات.
'''النماذج (Models)'''
النماذج هي فئات بايثون التي تمثل جداول في قاعدة البيانات. كل نموذج يحدد بنية الجدول والأعمدة (الحقول) الخاصة به.  النماذج هي نقطة البداية للتفاعل مع قاعدة البيانات.  يمكنك تعريف النماذج في ملف `models.py` داخل تطبيق Django الخاص بك.


'''فوائد استخدام Django ORM:'''
'''الحقول (Fields)'''
الحقول هي أنواع البيانات التي تمثل أعمدة الجدول. يوفر Django مجموعة واسعة من الحقول، بما في ذلك `CharField` (للنصوص)، `IntegerField` (للأعداد الصحيحة)، `FloatField` (للأعداد العشرية)، `BooleanField` (للقيم المنطقية)، `DateField` (للتواريخ)، و `ForeignKey` (للعلاقات بين الجداول).  [[حقول النموذج في Django]] توفر مرونة كبيرة في تعريف هياكل البيانات.


*  '''الإنتاجية:''' يقلل من كمية الكود التي تحتاج إلى كتابتها.
'''العلاقات (Relationships)'''
*   '''قابلية النقل:'''  يمكنك تغيير قاعدة البيانات المستخدمة (مثل PostgreSQL, MySQL, SQLite) دون تغيير الكثير من الكود الخاص بك.
Django ORM يدعم أنواعًا مختلفة من العلاقات بين النماذج:
*   '''الأمان:'''  يحمي من هجمات '''SQL Injection''' عن طريق التعامل مع البيانات بشكل آمن.
* '''واحد إلى واحد (One-to-One):'''  نموذج واحد يرتبط بنموذج آخر واحد فقط.
*   '''قابلية الصيانة:'''  يجعل الكود الخاص بك أسهل في الفهم والتعديل.
* '''واحد إلى متعدد (One-to-Many):'''  نموذج واحد يرتبط بالعديد من النماذج الأخرى.
*  '''التجريد:''' يوفر تجريدًا لقواعد البيانات المختلفة، مما يسمح لك بالتركيز على منطق التطبيق الخاص بك.
* '''متعدد إلى متعدد (Many-to-Many):'''  العديد من النماذج ترتبط بالعديد من النماذج الأخرى.  [[العلاقات بين النماذج]] مهمة جدًا في تصميم قاعدة البيانات.


== أساسيات Django ORM ==
== وثائق Django ORM: المصادر الرئيسية ==


### النماذج (Models)
'''وثائق Django الرسمية'''
المصدر الأساسي للوثائق هو [[وثائق Django الرسمية]].  تغطي هذه الوثائق جميع جوانب Django ORM بالتفصيل، بما في ذلك:
* '''النماذج (Models):'''  تعريف النماذج، الحقول، العلاقات، والخيارات المتاحة. [[تعريف النماذج]]
* '''الاستعلامات (Queries):'''  كيفية كتابة الاستعلامات لاسترداد البيانات من قاعدة البيانات. [[استعلامات قاعدة البيانات]]
* '''المديرون (Managers):'''  تخصيص طريقة الوصول إلى النماذج وتنفيذ الاستعلامات المعقدة. [[المديرون في Django]]
* '''الترحيلات (Migrations):'''  كيفية إنشاء وتطبيق التغييرات على هيكل قاعدة البيانات. [[الترحيلات في Django]]
* '''وظائف قاعدة البيانات (Database Functions):''' استخدام وظائف قاعدة البيانات الأصلية داخل استعلامات ORM. [[وظائف قاعدة البيانات]]


النماذج هي الفئة الأساسية في Django ORM.  يمثل كل نموذج جدولًا في قاعدة البيانات.  يتم تعريف النماذج كفئات بايثون داخل ملف `models.py` في تطبيق Django الخاص بك.
'''أمثلة عملية'''
الوثائق الرسمية تحتوي على العديد من الأمثلة العملية التي توضح كيفية استخدام Django ORM في سيناريوهات مختلفة.  [[أمثلة ORM]] تساعد على فهم المفاهيم بشكل أفضل.


'''مثال:'''
== استخدام Django ORM في الممارسة العملية ==


```python
'''إنشاء النماذج'''
ابدأ بتعريف النماذج الخاصة بك في ملف `models.py`.  على سبيل المثال:
 
[[User:Admin|Admin]] ([[User talk:Admin|talk]])python
from django.db import models
from django.db import models


class Book(models.Model):
class Product(models.Model):
     title = models.CharField(max_length=200)
     name = models.CharField(max_length=100)
     author = models.CharField(max_length=100)
     price = models.FloatField()
     publication_date = models.DateField()
     created_at = models.DateTimeField(auto_now_add=True)


     def __str__(self):
     def __str__(self):
         return self.title
         return self.name
```
[[User:Admin|Admin]] ([[User talk:Admin|talk]])
 
في هذا المثال، قمنا بتعريف نموذج `Book` بثلاثة حقول: `title`, `author`, و `publication_date`.  `models.CharField` و `models.DateField` هما أنواع الحقول التي تحدد نوع البيانات التي يمكن تخزينها في كل حقل.  الدالة `__str__` تحدد كيفية تمثيل الكائن كنص.
 
### قواعد البيانات والإعدادات
 
يجب عليك تكوين قاعدة البيانات التي تريد استخدامها في ملف `settings.py` الخاص بتطبيق Django الخاص بك.  يتم ذلك عن طريق تعديل إعداد `DATABASES`.  راجع [[Django settings]] لمزيد من المعلومات.
 
'''مثال:'''
 
```python
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': BASE_DIR / 'db.sqlite3',
    }
}
```
 
### عمليات CRUD (إنشاء، قراءة، تحديث، حذف)
 
Django ORM يوفر طرقًا سهلة لتنفيذ عمليات CRUD على البيانات.
 
*  '''إنشاء (Create):'''  استخدم `Model.objects.create()` لإنشاء سجل جديد في قاعدة البيانات.
*  '''قراءة (Read):'''  استخدم `Model.objects.get()` لاسترداد سجل واحد، و `Model.objects.filter()` لاسترداد مجموعة من السجلات.
*  '''تحديث (Update):'''  استخدم `instance.save()` لتحديث سجل موجود.
*  '''حذف (Delete):'''  استخدم `instance.delete()` لحذف سجل.
 
'''مثال:'''
 
```python
# إنشاء كتاب جديد
book = Book.objects.create(title="The Great Gatsby", author="F. Scott Fitzgerald", publication_date="1925-04-10")
 
# استرداد جميع الكتب
books = Book.objects.all()
 
# استرداد كتاب بعنوان "The Great Gatsby"
gatsby = Book.objects.get(title="The Great Gatsby")
 
# تحديث عنوان الكتاب
gatsby.title = "The Magnificent Gatsby"
gatsby.save()
 
# حذف الكتاب
gatsby.delete()
```
 
== الاستعلامات المتقدمة ==
 
### الفلاتر (Filters)
 
يمكنك استخدام فلاتر متقدمة لتحديد السجلات التي تريد استردادها.  يدعم Django ORM مجموعة متنوعة من عوامل التصفية، مثل `Q` objects و lookups.  راجع [[Django filters]] لمزيد من التفاصيل.


### العلاقات (Relationships)
'''الترحيلات'''
بعد تعريف النماذج، قم بإنشاء الترحيلات وتطبيقها على قاعدة البيانات:


يدعم Django ORM أنواعًا مختلفة من العلاقات بين النماذج، مثل:
[[User:Admin|Admin]] ([[User talk:Admin|talk]])bash
python manage.py makemigrations
python manage.py migrate
[[User:Admin|Admin]] ([[User talk:Admin|talk]])


*  '''One-to-One:''' علاقة واحد لواحد.
'''الاستعلامات'''
*  '''One-to-Many:'''  علاقة واحد لكثير.
يمكنك استخدام Django ORM للاستعلام عن البيانات من قاعدة البيانات:
*  '''Many-to-Many:'''  علاقة كثير لكثير.


راجع [[Django relationships]] لمزيد من المعلومات.
[[User:Admin|Admin]] ([[User talk:Admin|talk]])python
products = Product.objects.all() # استرداد جميع المنتجات
expensive_products = Product.objects.filter(price__gt=100) # استرداد المنتجات التي سعرها أكبر من 100
[[User:Admin|Admin]] ([[User talk:Admin|talk]])


### التجميع (Aggregation)
'''العمليات CRUD'''
Django ORM يوفر طرقًا لإجراء عمليات CRUD (Create, Read, Update, Delete):
* '''إنشاء (Create):''' `Product.objects.create(name="New Product", price=50)`
* '''قراءة (Read):'''  كما هو موضح في أمثلة الاستعلامات أعلاه.
* '''تحديث (Update):''' `product = Product.objects.get(pk=1); product.price = 75; product.save()`
* '''حذف (Delete):''' `product = Product.objects.get(pk=1); product.delete()`


يمكنك استخدام التجميع لحساب القيم الإجمالية للبيانات.  يدعم Django ORM دوال تجميعية مثل `Count`, `Sum`, `Avg`, `Max`, و `Min`.  راجع [[Django aggregation]] لمزيد من التفاصيل.
== مفاهيم متقدمة في Django ORM ==


==  مفاهيم إضافية ==
'''استعلامات معقدة (Complex Queries)'''
Django ORM يسمح لك بكتابة استعلامات معقدة باستخدام `Q` objects و `annotate` و `aggregate` وغيرها. [[استعلامات معقدة في ORM]]


*  '''Migrations:''' تستخدم لتتبع التغييرات في النماذج وتطبيقها على قاعدة البيانات.  راجع [[Django migrations]].
'''التعامل مع العلاقات (Working with Relationships)'''
*  '''Managers:'''  تستخدم لتخصيص طريقة الوصول إلى النماذج.  راجع [[Django managers]].
يمكنك الوصول إلى البيانات المرتبطة من خلال العلاقات بين النماذج.  [[الوصول إلى البيانات المرتبطة]]
*  '''Indexes:'''  تستخدم لتحسين أداء الاستعلامات.  راجع [[Django indexes]].
*  '''Raw SQL:'''  في بعض الحالات، قد تحتاج إلى كتابة استعلامات SQL مباشرة.  يوفر Django ORM طرقًا للقيام بذلك. راجع [[Django raw SQL]].


== استخدام ORM في التداول ==
'''تحسين الأداء (Performance Optimization)'''
تأكد من تحسين استعلاماتك لتجنب المشاكل المتعلقة بالأداء.  [[تحسين أداء ORM]]


يمكن تطبيق Django ORM في تطبيقات التداول لتخزين وإدارة بيانات السوق، مثل أسعار الأصول، وحجم التداول، وبيانات الحساب. يمكن استخدام النماذج لتمثيل البيانات المتعلقة بالصفقات، والمراكز، والتنبيهات.
== أدوات مساعدة ==


'''استراتيجيات التداول التي يمكن دعمها باستخدام Django ORM:'''
'''Django Debug Toolbar'''
أداة مفيدة لتصحيح الأخطاء وتحليل أداء استعلامات ORM. [[Django Debug Toolbar]]


*  [[Moving Average Crossover]]: تخزين بيانات الأسعار لحساب المتوسطات المتحركة.
'''Shell'''
*  [[Relative Strength Index (RSI)]]: تخزين بيانات الأسعار لحساب مؤشر القوة النسبية.
استخدم shell Django لتجربة استعلامات ORM مباشرة. [[Django Shell]]
*  [[MACD]]: تخزين بيانات الأسعار لحساب مؤشر MACD.
*  [[Bollinger Bands]]: تخزين بيانات الأسعار لحساب نطاقات بولينجر.
*  [[Fibonacci Retracement]]: تخزين بيانات الأسعار لتحديد مستويات فيبوناتشي.
*  [[Ichimoku Cloud]]: تخزين بيانات الأسعار لرسم سحابة Ichimoku.
*  [[Candlestick Patterns]]: تخزين بيانات الأسعار لتحليل أنماط الشموع اليابانية.
*  [[Volume Profile]]: تخزين بيانات الحجم لتحديد ملف تعريف الحجم.
*  [[Order Flow Analysis]]: تخزين بيانات الأوامر لتحليل تدفق الأوامر.
*  [[Arbitrage]]: تخزين أسعار الأصول من بورصات مختلفة لتحديد فرص المراجحة.
*  [[Mean Reversion]]: تخزين بيانات الأسعار لتحديد الانحرافات عن المتوسط.
*  [[Trend Following]]: تخزين بيانات الأسعار لتحديد الاتجاهات.
*  [[Breakout Trading]]: تخزين بيانات الأسعار لتحديد الاختراقات.
*  [[News Sentiment Analysis]]: تخزين بيانات الأخبار وتحليل المشاعر.
*  [[Algorithmic Trading]]: تنفيذ استراتيجيات التداول الآلية.


'''تحليل حجم التداول باستخدام Django ORM:'''
== استراتيجيات وتكاملات ذات صلة ==


*   [[On Balance Volume (OBV)]]: تخزين بيانات الحجم لحساب OBV.
* [[تحليل الفجوة]]
*   [[Accumulation/Distribution Line]]: تخزين بيانات الحجم لحساب خط التجميع/التوزيع.
* [[التحليل الأساسي]]
*   [[Chaikin Money Flow]]: تخزين بيانات الحجم لحساب تدفق أموال Chaikin.
* [[التحليل الفني]]
* [[تحليل حجم التداول]]
* [[استراتيجية الاختراق]]
* [[استراتيجية المتوسط المتحرك]]
* [[استراتيجية مؤشر القوة النسبية]]
* [[استراتيجية بولينجر باند]]
* [[استراتيجية MACD]]
* [[استراتيجية ستوكاستيك]]
* [[تداول الأخبار]]
* [[تداول الاتجاه]]
* [[تداول نطاقات السعر]]
* [[تداول الاختراق الزائف]]
* [[إدارة المخاطر في التداول]]
* [[تنويع المحفظة الاستثمارية]]
* [[التحليل الأساسي للعملات المشفرة]]
* [[التحليل الفني للعملات المشفرة]]
* [[التحليل الكمي للأسواق المالية]]
* [[تداول الخيارات الثنائية]]


== الموارد الإضافية ==
=== خاتمة ===


*  [[Django documentation]]: الوثائق الرسمية لـ Django.
Django ORM هو أداة قوية ومرنة تسمح لك بالتفاعل مع قواعد البيانات بسهولة وفعالية.  من خلال فهم أساسيات Django ORM واستخدام الوثائق الرسمية، يمكنك بناء تطبيقات ويب قوية وقابلة للتطوير.  تذكر أن الممارسة والتجربة هما المفتاح لإتقان Django ORM.
*  [[Django tutorial]]: دليل تعليمي لـ Django.
*  [[Django Q&A]]: منتدى أسئلة وأجوبة لـ Django.
*  [[Stack Overflow - Django]]: أسئلة وأجوبة حول Django على Stack Overflow.


[[Category: Django]]
[[Category: Django]]

Latest revision as of 13:21, 23 April 2025

Django ORM Documentation

مقدمة Django Object-Relational Mapper (ORM) هو أداة قوية تسمح لك بالتفاعل مع قواعد البيانات باستخدام كود بايثون بدلاً من كتابة استعلامات SQL مباشرة. يوفر Django ORM تجريدًا لقواعد البيانات المختلفة، مما يعني أنك يمكنك تغيير قاعدة البيانات المستخدمة (مثل PostgreSQL أو MySQL أو SQLite) دون الحاجة إلى تغيير الكثير من الكود الخاص بك. هذه المقالة موجهة للمبتدئين وتهدف إلى تقديم نظرة عامة شاملة على وثائق Django ORM وكيفية استخدامها بفعالية.

فهم أساسيات Django ORM

النماذج (Models) النماذج هي فئات بايثون التي تمثل جداول في قاعدة البيانات. كل نموذج يحدد بنية الجدول والأعمدة (الحقول) الخاصة به. النماذج هي نقطة البداية للتفاعل مع قاعدة البيانات. يمكنك تعريف النماذج في ملف `models.py` داخل تطبيق Django الخاص بك.

الحقول (Fields) الحقول هي أنواع البيانات التي تمثل أعمدة الجدول. يوفر Django مجموعة واسعة من الحقول، بما في ذلك `CharField` (للنصوص)، `IntegerField` (للأعداد الصحيحة)، `FloatField` (للأعداد العشرية)، `BooleanField` (للقيم المنطقية)، `DateField` (للتواريخ)، و `ForeignKey` (للعلاقات بين الجداول). حقول النموذج في Django توفر مرونة كبيرة في تعريف هياكل البيانات.

العلاقات (Relationships) Django ORM يدعم أنواعًا مختلفة من العلاقات بين النماذج:

  • واحد إلى واحد (One-to-One): نموذج واحد يرتبط بنموذج آخر واحد فقط.
  • واحد إلى متعدد (One-to-Many): نموذج واحد يرتبط بالعديد من النماذج الأخرى.
  • متعدد إلى متعدد (Many-to-Many): العديد من النماذج ترتبط بالعديد من النماذج الأخرى. العلاقات بين النماذج مهمة جدًا في تصميم قاعدة البيانات.

وثائق Django ORM: المصادر الرئيسية

وثائق Django الرسمية المصدر الأساسي للوثائق هو وثائق Django الرسمية. تغطي هذه الوثائق جميع جوانب Django ORM بالتفصيل، بما في ذلك:

  • النماذج (Models): تعريف النماذج، الحقول، العلاقات، والخيارات المتاحة. تعريف النماذج
  • الاستعلامات (Queries): كيفية كتابة الاستعلامات لاسترداد البيانات من قاعدة البيانات. استعلامات قاعدة البيانات
  • المديرون (Managers): تخصيص طريقة الوصول إلى النماذج وتنفيذ الاستعلامات المعقدة. المديرون في Django
  • الترحيلات (Migrations): كيفية إنشاء وتطبيق التغييرات على هيكل قاعدة البيانات. الترحيلات في Django
  • وظائف قاعدة البيانات (Database Functions): استخدام وظائف قاعدة البيانات الأصلية داخل استعلامات ORM. وظائف قاعدة البيانات

أمثلة عملية الوثائق الرسمية تحتوي على العديد من الأمثلة العملية التي توضح كيفية استخدام Django ORM في سيناريوهات مختلفة. أمثلة ORM تساعد على فهم المفاهيم بشكل أفضل.

استخدام Django ORM في الممارسة العملية

إنشاء النماذج ابدأ بتعريف النماذج الخاصة بك في ملف `models.py`. على سبيل المثال:

Admin (talk)python from django.db import models

class Product(models.Model): 

   name = models.CharField(max_length=100)
   price = models.FloatField()
   created_at = models.DateTimeField(auto_now_add=True)

   def __str__(self):
       return self.name

Admin (talk)

الترحيلات بعد تعريف النماذج، قم بإنشاء الترحيلات وتطبيقها على قاعدة البيانات:

Admin (talk)bash python manage.py makemigrations python manage.py migrate Admin (talk)

الاستعلامات يمكنك استخدام Django ORM للاستعلام عن البيانات من قاعدة البيانات:

Admin (talk)python products = Product.objects.all() # استرداد جميع المنتجات expensive_products = Product.objects.filter(price__gt=100) # استرداد المنتجات التي سعرها أكبر من 100 Admin (talk)

العمليات CRUD Django ORM يوفر طرقًا لإجراء عمليات CRUD (Create, Read, Update, Delete):

  • إنشاء (Create): `Product.objects.create(name="New Product", price=50)`
  • قراءة (Read): كما هو موضح في أمثلة الاستعلامات أعلاه.
  • تحديث (Update): `product = Product.objects.get(pk=1); product.price = 75; product.save()`
  • حذف (Delete): `product = Product.objects.get(pk=1); product.delete()`

مفاهيم متقدمة في Django ORM

استعلامات معقدة (Complex Queries) Django ORM يسمح لك بكتابة استعلامات معقدة باستخدام `Q` objects و `annotate` و `aggregate` وغيرها. استعلامات معقدة في ORM

التعامل مع العلاقات (Working with Relationships) يمكنك الوصول إلى البيانات المرتبطة من خلال العلاقات بين النماذج. الوصول إلى البيانات المرتبطة

تحسين الأداء (Performance Optimization) تأكد من تحسين استعلاماتك لتجنب المشاكل المتعلقة بالأداء. تحسين أداء ORM

أدوات مساعدة

Django Debug Toolbar أداة مفيدة لتصحيح الأخطاء وتحليل أداء استعلامات ORM. Django Debug Toolbar

Shell استخدم shell Django لتجربة استعلامات ORM مباشرة. Django Shell

استراتيجيات وتكاملات ذات صلة

خاتمة

Django ORM هو أداة قوية ومرنة تسمح لك بالتفاعل مع قواعد البيانات بسهولة وفعالية. من خلال فهم أساسيات Django ORM واستخدام الوثائق الرسمية، يمكنك بناء تطبيقات ويب قوية وقابلة للتطوير. تذكر أن الممارسة والتجربة هما المفتاح لإتقان Django ORM.

ابدأ التداول الآن

سجل في IQ Option (الحد الأدنى للإيداع $10) افتح حساباً في Pocket Option (الحد الأدنى للإيداع $5)

انضم إلى مجتمعنا

اشترك في قناة Telegram الخاصة بنا @strategybin للحصول على: ✓ إشارات تداول يومية ✓ تحليلات استراتيجية حصرية ✓ تنبيهات باتجاهات السوق ✓ مواد تعليمية للمبتدئين

Баннер
Retrieved from "https://binaryoption.wiki/ar/index.php?title=Django_ORM_Documentation&oldid=34491"