Django
मॉडल फ़ील्ड संदर्भ

पैरामीटर

टिप्पणियों

नंबर फील्ड्स

संख्यात्मक क्षेत्रों के उदाहरण दिए गए हैं:

AutoField

एक ऑटो-इंक्रीमेंटिंग पूर्णांक आमतौर पर प्राथमिक कुंजी के लिए उपयोग किया जाता है।

from django.db import models

class MyModel(models.Model):
    pk = models.AutoField()

प्रत्येक मॉडल को डिफ़ॉल्ट रूप से एक प्राथमिक कुंजी फ़ील्ड ( id कहा जाता है) मिलता है। इसलिए, प्राथमिक कुंजी के प्रयोजनों के लिए मॉडल में आईडी फ़ील्ड को डुप्लिकेट करना आवश्यक नहीं है।

BigIntegerField

एक पूर्णांक फिटिंग संख्या -9223372036854775808 से 9223372036854775807 ( 8 Bytes 9223372036854775807 )।

from django.db import models

class MyModel(models.Model):
    number_of_seconds = models.BigIntegerField()

IntegerField

IntegerField का उपयोग पूर्णांक मानों को -2147483648 से 2147483647 ( 4 Bytes ) तक संग्रहीत करने के लिए किया जाता है।

from django.db import models

class Food(models.Model):
    name = models.CharField(max_length=255)
    calorie = models.IntegerField(default=0)

default पैरामीटर अनिवार्य नहीं है। लेकिन डिफ़ॉल्ट मान सेट करना उपयोगी है।

PositiveIntegerField

एक IntegerField की तरह, लेकिन या तो सकारात्मक होना चाहिए या शून्य (0)। PositiveIntegerField का उपयोग पूर्णांक मानों को 0 से 2147483647 ( 4 Bytes ) तक संग्रहीत करने के लिए किया जाता है। यह उस क्षेत्र में उपयोगी हो सकता है जो शब्दार्थात्मक रूप से सकारात्मक होना चाहिए। उदाहरण के लिए यदि आप इसकी कैलोरी के साथ खाद्य पदार्थ रिकॉर्ड कर रहे हैं, तो यह नकारात्मक नहीं होना चाहिए। यह क्षेत्र अपनी मान्यताओं के माध्यम से नकारात्मक मूल्यों को रोकेगा।

from django.db import models

class Food(models.Model):
    name = models.CharField(max_length=255)
    calorie = models.PositiveIntegerField(default=0)

default पैरामीटर अनिवार्य नहीं है। लेकिन डिफ़ॉल्ट मान सेट करना उपयोगी है।

SmallIntegerField

SmallIntegerField पूर्णांक मान -32768 से 32767 ( 2 Bytes ) को संग्रहीत करने के लिए उपयोग किया जाता है। यह क्षेत्र उन मूल्यों के लिए उपयोगी है जो चरम नहीं हैं।

from django.db import models

class Place(models.Model):
    name = models.CharField(max_length=255)
    temperature = models.SmallIntegerField(null=True)

PositiveSmallIntegerField

SmallIntegerField का उपयोग पूर्णांक मानों को 0to 32767 ( 2 Bytes ) से संग्रहीत करने के लिए किया जाता है। SmallIntegerField की तरह ही यह क्षेत्र उन मूल्यों के लिए उपयोगी है जो इतने अधिक नहीं हैं और शब्दार्थात्मक रूप से सकारात्मक होना चाहिए। उदाहरण के लिए यह उम्र को संग्रहीत कर सकता है जो नकारात्मक नहीं हो सकता।

from django.db import models

class Staff(models.Model):
    first_name = models.CharField(max_length=255)
    last_name = models.CharField(max_length=255)
    age = models.PositiveSmallIntegerField(null=True)

पॉजिटिवस्मॉलइंटरफ़िल्ड के अलावा विकल्पों के लिए उपयोगी है, यह Enum को लागू करने का Djangoic तरीका है:

from django.db import models
from django.utils.translation import gettext as _

APPLICATION_NEW = 1
APPLICATION_RECEIVED = 2
APPLICATION_APPROVED = 3
APPLICATION_REJECTED = 4

APLICATION_CHOICES = (
    (APPLICATION_NEW, _('New')),
    (APPLICATION_RECEIVED, _('Received')),
    (APPLICATION_APPROVED, _('Approved')),
    (APPLICATION_REJECTED, _('Rejected')),
)

class JobApplication(models.Model):
    first_name = models.CharField(max_length=255)
    last_name = models.CharField(max_length=255)
    status = models.PositiveSmallIntegerField(
        choices=APLICATION_CHOICES, 
        default=APPLICATION_NEW
    )
    ...

स्थिति के अनुसार वर्ग चर या मॉड्यूल चर के रूप में विकल्पों की परिभाषा उनका उपयोग करने का एक अच्छा तरीका है। यदि विकल्प मैत्रीपूर्ण नामों के बिना क्षेत्र में पारित किए जाते हैं तो यह भ्रम पैदा करेगा।

DecimalField

एक निश्चित-सटीक दशमलव संख्या, पायथन में एक दशमलव उदाहरण द्वारा दर्शाई गई है। IntegerField और इसके डेरिवेटिव के विपरीत इस क्षेत्र में 2 आवश्यक तर्क हैं:

1. DecimalField.max_digits : अंकों की अधिकतम संख्या की अनुमति। ध्यान दें कि यह संख्या दशमलव_प्लस से अधिक या उसके बराबर होनी चाहिए।
2. DecimalField.decimal_places : संख्या के साथ संग्रह करने के लिए दशमलव स्थानों की संख्या।

यदि आप 3 दशमलव स्थानों के साथ 99 तक की संख्याएँ संग्रहीत करना चाहते हैं, तो आपको max_digits=5 और decimal_places=3 उपयोग करने की आवश्यकता है:

class Place(models.Model):
    name = models.CharField(max_length=255)
    atmospheric_pressure = models.DecimalField(max_digits=5, decimal_places=3)

BinaryField

यह एक विशेष क्षेत्र है, जिसका उपयोग बाइनरी डेटा को संग्रहीत करने के लिए किया जाता है। यह केवल बाइट्स को स्वीकार करता है। भंडारण पर डेटा बेस 64 अनुक्रमित है।

चूंकि यह बाइनरी डेटा संग्रहीत कर रहा है, इसलिए इस फ़ील्ड का उपयोग फ़िल्टर में नहीं किया जा सकता है।

from django.db import models

class MyModel(models.Model):
    my_binary_data = models.BinaryField()

CharField

CharField का उपयोग पाठ की निर्धारित लंबाई को संग्रहीत करने के लिए किया जाता है। नीचे दिए गए उदाहरण में पाठ के 128 अक्षर क्षेत्र में संग्रहीत किए जा सकते हैं। इससे अधिक लंबी स्ट्रिंग दर्ज करने पर सत्यापन त्रुटि उत्पन्न हो जाएगी।

from django.db import models

class MyModel(models.Model):
    name = models.CharField(max_length=128, blank=True)

DateTimeField

DateTimeField का उपयोग दिनांक समय मानों को संग्रहीत करने के लिए किया जाता है।

class MyModel(models.Model):
    start_time = models.DateFimeField(null=True, blank=True)
    created_on = models.DateTimeField(auto_now_add=True)
    updated_on = models.DateTimeField(auto_now=True)

एक DateTimeField के दो वैकल्पिक पैरामीटर हैं:

• जब ऑब्जेक्ट बनाया जाता है, तो auto_now_add फ़ील्ड का मान वर्तमान auto_now_add सेट करता है।

• हर बार फ़ील्ड के सहेजने के बाद, स्वतः ही फ़ील्ड को वर्तमान auto_now में फ़ील्ड का मान सेट करता है।

ये विकल्प और default पैरामीटर परस्पर अनन्य हैं।

विदेशी कुंजी

फॉरेनके फील्ड का उपयोग मॉडल के बीच many-to-one संबंध बनाने के लिए किया जाता है। अन्य क्षेत्रों के अधिकांश की तरह स्थितिगत तर्कों की आवश्यकता नहीं है। निम्नलिखित उदाहरण कार और मालिक के संबंध को प्रदर्शित करता है:

from django.db import models

class Person(models.Model):
    GENDER_FEMALE = 'F'
    GENDER_MALE = 'M'

    GENDER_CHOICES = (
        (GENDER_FEMALE, 'Female'),
        (GENDER_MALE, 'Male'),
    )

    first_name = models.CharField(max_length=100)
    last_name = models.CharField(max_length=100)
    gender = models.CharField(max_length=1, choices=GENDER_CHOICES)
    age = models.SmallIntegerField()


class Car(model.Model)
    owner = models.ForeignKey('Person')
    plate = models.CharField(max_length=15)
    brand = models.CharField(max_length=50)
    model = models.CharField(max_length=50)
    color = models.CharField(max_length=50)

क्षेत्र का पहला तर्क वह वर्ग है जिससे मॉडल संबंधित है। दूसरा स्थितीय तर्क on_delete तर्क है। वर्तमान संस्करणों में इस तर्क की आवश्यकता नहीं है, लेकिन यह Django 2.0 में आवश्यक होगा। तर्क की डिफ़ॉल्ट कार्यक्षमता निम्नानुसार दिखाई गई है:

class Car(model.Model)
    owner = models.ForeignKey('Person', on_delete=models.CASCADE)
    ...

इससे कार की वस्तुओं को मॉडल से हटा दिया जाएगा जब उसके मालिक को पर्सन मॉडल से हटा दिया जाएगा। यह डिफ़ॉल्ट कार्यक्षमता है।

class Car(model.Model)
    owner = models.ForeignKey('Person', on_delete=models.PROTECT)
    ...

यह कम से कम एक कार ऑब्जेक्ट से संबंधित होने पर व्यक्ति की वस्तुओं को हटाने से रोकता है। कार ऑब्जेक्ट के सभी जो एक व्यक्ति ऑब्जेक्ट को संदर्भित करते हैं, को पहले हटा दिया जाना चाहिए। और फिर व्यक्ति वस्तु को हटाया जा सकता है।