در این جلسه نحوه کارکرد یک Queryset و استفاده از pickle ( خیارشور :)) ) را در جنگو بررسی خواهیم کرد . با ما همراه باشید .

در این بخش به بررسی نحوه کار QuerySet می پردازیم . ابتدا به یاد داشته باشید که query با queryset تفاوت اساسی دارد . در واقع هر کدی که برای جستجو در دیتابیس می نویسید , یک QuerySet است . هنگامی که در دیتابیس اجرا می شود تبدیل به Query خواهد شد .
همچنین از مثال Entry و Blog و Author در این بخش دوباره استفاده خواهیم کرد (در مقالات قبلتر وجود دارد).
به صورت کلی ,یک QuerySet را می توان ساخت ,فیلتر کرد ,برش داد و کارهای دیگری انجام داد بدون اینکه واقعا روی دیتابیس عملیاتی انجام بدهد . در واقع تا زمانی که با QuerySet کاری انجام ندهید که روی دیتابیس اجرا شود (مثال print کردن آن برای اولین بار) در واقع هیچ فعالیتی روی دیتابیس انجام نمی شود .
لیست فعالیت هایی که باعث می شوند تا QuerySet در دیتابیس اجرا شود ,در زیر آمده است :
یک-iteration :یک QuerySet در واقع iterable است . این یعنی می توانید روی آن پیمایش کنید و اعضای آن را ببینید.
توجه داشته باشید که زمانی که اولین بار است که اعضای آن را پیمایش می کنید , روی دیتابیس اجرا می شود و در باقی مواقع از کش استفاده خواهد کرد . برای مثال کد زیر , تمام مقادیر فیلد های headline از اشیا مدل Entry را بازمیگرداند .
for e in Entry.objects.all(): print(e.headline)
البته اگر می خواهید از این کد برای این استفاده کنید که بفهمید آیا حداقل یک شی با مشخصات شما وجود دارد یا خیر بهتر است از ()exists استفاده کنید .
دو-Asynchronous iteration :یک QuerySet همچنین می توانید به صورت async نیز پیمایش شود . برای مثال:
async for e in Entry.objects.all(): results.append(e)
هر دو نوع synchronous و asynchronous حافظه کش یکسانی را به اشتراک می گذارند .
سه-slicing : همانطور که توضیح داده شد یک QuerySet می تواند با استفاده از روش Array-slicing در پایتون, slice یا برش داده شود . Slice کردن یک QuerySet اجرا نشده در دیتابیس معمولا یک QuerySet اجرا نشده دیگر را بازمیگرداند . البته اگر از پارامتر step استفاده کنید ,جنگو QuerySet را دیتابیس اجرا می کند و نتیجه را به صورت لیست به شما بازمی گرداند . Slice کردن یک querySet که اجرا شده است نیز یک لیست بازمیگرداند .
همچنین به یاد داشته باشید که اگر یک QuerySet که slice روی آن اعمال شده است و در دیتابیس هنوز اجرا نشده ,یک QuerySet دیگر را که روی دیتابیس اجرا نشده بازگرداند , افزودن اصلاحات بیشتر (مانند فیلتر کردن آن) مجاز نیست . زیرا موتور دیتابیس های جنگو نمی توانند آن را به SQL به درستی ترجمه کند .
چهار-pickle : یکی از موارد دیگر که باعث اجرای QuerySet روی دیتابیس می شود استفاده از کتابخانه pickle و یا کش کردن QuerySet است . (درباره pickle در گوگل جستجو کنید زیرا مبحث بعدی ما درباره همین است)
پنج-متد ()repr :اگر متد ()repr روی یک QuerySet فراخوانی شود ,روی دیتابیس اجرا خواهد شد . دلیل آن ایجاد قابلیت تعاملی بودن است . برای مثال هنگام استفاده از API دیتابیس در ترمینال می توانید با اینکار نتایج QuerySet را به صورت زنده تماشا کنید .
شش-متد ()len :هنگامی که این متد را برای شمارش اعضای لیست نتیجه فراخوانی کنید , QuerySet روی دیتابیس اجرا می شود .
نکته : اگر شما فقط به تعداد اشیا نیاز دارید و نه به خود آنها (یعنی فقط تعداد آنها را نیاز دارید و کاری با خود آنها ندارید) استفاده از دستور (*)SELECT COUNT در SQL راحت تر است . برای همین جنگو اجازه استفاده از متد ()count را به شما می دهد .
هفت-()list :زمانی که این متد را برای تبدیل QuerySet به یک list استفاده کنید , QuerySet شما در دیتابیس اجرا می شود . برای مثال :
entry_list = list(Entry.objects.all())
هشت-()bool :استفاده از QuerySet در یک محیط منطقی مانند ()bool یا دستور if (هر دستوری که در آن True یا False تعیین شده باشد) باعث می شود QuerySet اجرا شود . اگر حداقل یک شی درون نتیجه وجود داشته باشد به شما True و در غیر این صورت False را بازمیگرداند . مثلا :
if Entry.objects.filter(headline="Test"): print("There is at least one Entry with the headline Test")
نکته : اگر شما فقط به تعداد اشیا نیاز دارید و نه به خود آنها (یعنی فقط تعداد آنها را نیاز دارید و کاری با خود آنها ندارید) استفاده از ()exists مناسب تر است .
نکته : این بخش نیاز به آشنایی اولیه با کتابخانه pickle دارد . پس لطفا قبل از خواندن این بخش حتما در مورد آن بخوانید .
شما در جنگو می توانید یک QuerySet را pickle کنید . با اینکار تمام نتایج QuerySet شما در حافظه بارگذاری خواهند شد . این روش کارایی بالاتری برای زمان هایی که نیاز به دسترسی سریع به اطلاعات دارید ,دارد . البته بهتر است توجه داشته باشید زمانی که شما به اطلاعات ذخیره شده دسترسی پیدا می کنید ,اطلاعات برای زمانی هستند که شما آنها را pickle کردید و آپدیت نمی شوند .
اگر فقط می خواهید اطلاعات ضروری از QuerySet را ذخیره کنید ,باید مقدار query را از QuerySet به شکل زیر pickle یا ذخیره کنید . (در این روش نتایج هیچگاه بارگذاری نمی شود و فقط query شما ذخیره می شود)
>>> import pickle >>> query = pickle.loads(s) # Assuming 's' is the pickled string. >>> qs = MyModel.objects.all() >>> qs.query = query # Restore the original 'query'.
البته باید بدانید که query در اینجا محو است و فقط ساختار داخلی یک query را نشان می دهد . این باعث می شود تا بخشی از API خود جنگو نباشد . با این حال pickle و unpickle کردن به این صورت (یعنی محتوای query) کاملا پشتیبانی می شود .
نکته : به یاد داشته باشید نمی توانید با ورژن n از کتابخانه یک QuerySet را pickle کنید و با ورژن دیگری از کتابخانه آن را unpickle کنید . در آن صورت با ارور مواجه خواهید شد . به همین علت هیچگاه pickle کردن برای ذخیره داده به مدت طولانی مناسب نیست .
در این جلسه در رابطه با Queryset و نحوه استفاده از کتابخانه pickle پرداختیم . در جلسه بعدی در رابطه با متد های قابل استفاده روی Queryset و انواع آن (دو نوع) صحبت خواهیم کرد .