یادگیری بیشتر درباره فیلترها و متغیرهای SQL

یاد بگیرید چگونه از فیلترهای فیلد متابیس در پرس‌وجوهای SQL برای ساخت widgetهای فیلتر هوشمندتر استفاده کنید.

آموزش: فیلترهای فیلد برای سؤال‌های SQL

یاد بگیرید چگونه از فیلترهای فیلد متابیس در پرس‌وجوهای SQL برای ساخت widgetهای فیلتر هوشمندتر استفاده کنید.

به دنبال مستندات درباره فیلترهای فیلد هستید؟ مستندات: فیلترهای فیلد را ببینید.

این مقاله نشان می‌دهد چگونه widgetهای فیلتر SQL هوشمند را به پرس‌وجوهای SQL خود در متابیس با استفاده از نوع خاصی از متغیر به نام فیلتر فیلد اضافه کنید.

مقدمه‌ای بر فیلترهای فیلد

برای سؤال‌های متابیس نوشته شده در SQL، می‌توانیم از انواع متغیر پایه—Text، Number، و Date—برای ایجاد widgetهای فیلتر SQL ساده استفاده کنیم. برای ایجاد widgetهای فیلتر "هوشمندتر" که می‌توانند گزینه‌های خاص به داده‌های ستون‌های فیلتر شده را نمایش دهند، مثل ایجاد یک منوی dropdown از مقادیر، می‌توانیم از نوع متغیر خاصی به نام فیلتر فیلد استفاده کنیم.

فیلترهای فیلد می‌توانند در ابتدا برخی افراد را گیج کنند، چون مشتریان انتظار دارند مانند متغیرهای ورودی پایه رفتار کنند (که نمی‌کنند). با این حال، فیلترهای فیلد ارزش یادگیری دارند، چون می‌توانید از آن‌ها برای ایجاد widgetهای فیلتر بسیار پیشرفته‌تر استفاده کنید. این مقاله فیلترهای فیلد را به عمق پوشش می‌دهد، اما ابتدا بیایید تفاوت‌های اصلی بین متغیرهای فیلتر فیلد و متغیرهای Text، Number، و Date ساده را بحث کنیم.

تمایز فیلترهای فیلد از متغیرهای ساده Text، Number، و Date

فیلترهای فیلد به طور پیش‌فرض اختیاری هستند. اگر هیچ مقداری داده نشود، پرس‌وجوی SQL به گونه‌ای اجرا می‌شود که گویی فیلتر فیلد وجود نداشت. با این حال، شما گزینه الزامی کردن یک مقدار را دارید.
فیلترهای فیلد از syntax خاصی استفاده می‌کنند تا بتوانند کد SQL را در پشت صحنه مدیریت کنند. شما به سادگی یک فیلتر فیلد را به یک بند WHERE (بدون ستون یا عملگر) می‌دهید و فیلتر فیلد کد SQL را برای شما مدیریت می‌کند. این به کد اجازه می‌دهد تا انتخاب‌های چندگانه‌ای که مشتریان در widget فیلتر انجام می‌دهند را در نظر بگیرد.

نکته دوم می‌تواند به خصوص گیج‌کننده باشد، پس بیایید آن را با یک مثال باز کنیم.

ما از پایگاه داده نمونه شامل شده با متابیس برای افزودن یک widget فیلتر با منوی dropdown به یک سؤال نوشته شده در SQL استفاده خواهیم کرد. بگویید می‌خواهیم یک سؤال SQL ایجاد کنیم که همه سفارش‌ها را از جدول Orders می‌گیرد، اما می‌خواهیم به مشتریان گزینه فیلتر کردن نتایج بر اساس دسته در جدول Products را بدهیم. ما می‌توانستیم یک فیلتر Products.category با یک متغیر ورودی پایه ایجاد کنیم، مثل این:

SELECT *
FROM Orders
LEFT JOIN Products
ON Orders.product_id = Products.id
[[WHERE Products.category = {{category}}]];

در این مورد، بند WHERE را در براکت‌های دوتایی enclose می‌کنیم تا ورودی اختیاری شود، و از sidebar متغیرها برای تنظیم نوع متغیر به Text و برچسب widget فیلتر به Category استفاده می‌کنیم. این رویکرد کار می‌کند، اما ایده‌آل نیست:

برای فیلتر کردن داده، مشتریان باید بدانند کدام دسته‌ها وجود دارند (و آن‌ها را به درستی هنگام ورود هجی کنند).
علاوه بر این، آن‌ها نمی‌توانند چندین دسته را همزمان انتخاب کنند، چون متغیر {{category}} فقط یک مقدار واحد می‌پذیرد.

در مقابل، یک فیلتر فیلد متغیر را به داده‌های ستون واقعی map می‌کند. widget فیلتر متصل به متغیر سپس "می‌داند" کدام دسته‌ها در دسترس هستند، و می‌تواند یک منوی dropdown از آن دسته‌ها ارائه دهد، مثل این:

یک کلمه درباره widget: منوی dropdown فقط یکی از گزینه‌های در دسترس است. در مورد فیلدهای نوع Category، مثل فیلد category ما در جدول Products، می‌توانستیم widget فیلتر را به عنوان یک جعبه جستجو یا یک جعبه ورودی ساده تنظیم کنیم. مدیران می‌توانند تنظیمات فیلد را در تب مدل داده از پنل ادمین پیکربندی کنند.

توجه کنید که متابیس به طور خودکار از یک جعبه جستجو استفاده می‌کند اگر تعداد مقادیر متمایز در ستون بیشتر از 300 باشد، حتی اگر گزینه dropdown را انتخاب کنید. درباره ویرایش فراداده در مستندات ما بیشتر بیاموزید.

حالا، بیایید به سؤال خود برگردیم. در اینجا syntax برای فیلتر فیلد Products.category است. توجه کنید حذف ستون و عملگر قبل از متغیر در بند WHERE—ما در زیر بیشتر درباره syntax فیلتر فیلد صحبت خواهیم کرد:

SELECT *
FROM orders
LEFT JOIN products
ON orders.product_id = products.id
WHERE {{category}};

با متغیر ما در جای خود در بند WHERE، می‌توانیم از sidebar متغیرها برای wire up کردن متغیر خود به عنوان یک فیلتر فیلد استفاده کنیم. تنظیم می‌کنیم:

نوع متغیر را به فیلتر فیلد .
فیلد برای map کردن را به Products → Category . این تنظیم به متابیس می‌گوید متغیر در کد SQL ما را به ستون category جدول Products متصل کند.
نوع widget فیلد را به category .
برچسب widget فیلد را به category .

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

توجه کنید که بند WHERE مشخص نمی‌کند متغیر باید برابر با کدام ستون باشد. این syntax ضمنی (کد SQL پنهان) به فیلتر فیلد اجازه می‌دهد کد SQL را در پشت صحنه برای تطبیق با انتخاب‌های چندگانه مدیریت کند.

می‌توانیم یک متغیر ورودی پایه از نوع Date ایجاد کنیم، که یک widget فیلتر SQL با یک فیلتر تاریخ ساده اضافه می‌کند. اگر، به جای آن، از یک متغیر فیلتر فیلد استفاده کنیم، می‌توانیم آن متغیر را به یک فیلد (ستون) که شامل تاریخ‌ها است متصل کنیم، که گزینه‌های بسیار بیشتری برای پیکربندی widget فیلتر ما باز می‌کند. در اینجا SQL:

SELECT *
FROM ORDERS
WHERE {{created_at}}

در اینجا انواع مختلف widget برای فیلترهای فیلد map شده به فیلدهای تاریخ:

ماه و سال
سه‌ماهه و سال
تاریخ واحد
محدوده تاریخ
تاریخ نسبی
فیلتر تاریخ

هر نوع widget راه‌های مختلفی برای مشتریان برای فیلتر کردن نتایج ارائه می‌دهد. در اینجا سه مثال فیلتر فیلد SQL:

نوع widget فیلتر تاریخ بیشترین انعطاف‌پذیری را ارائه می‌دهد، اجازه فیلتر کردن بر اساس تاریخ‌های نسبی و محدوده‌ها را می‌دهد.

نکات مهم فیلتر فیلد

چند جا وجود دارد که مشتریان معمولاً هنگام تلاش برای پیاده‌سازی فیلترهای فیلد گیر می‌کنند.

حذف انتساب مستقیم در بند WHERE

همانطور که در بالا گفته شد، کد SQL اطراف فیلترهای فیلد دقیقاً street legal نیست. ممکن است وسوسه شوید بنویسید:

-- این کار را نکنید
WHERE category = {{ category }}

چون این syntax صحیح برای یک بند WHERE در SQL استاندارد است. اما آن syntax برای فیلترهای فیلد کار نمی‌کند. syntax صحیح برای فیلترهای فیلد عملگر = را حذف می‌کند:

WHERE {{ category }}

دلیل این shorthand این است که متابیس می‌تواند، در پشت صحنه، کد SQL را برای موقعیت‌هایی مثل انتخاب‌های چندگانه insert کند، مثلاً وقتی یک کاربر چندین دسته را از یک dropdown انتخاب می‌کند.