فیلترهای قالب بندی شده و پارامترهای مایع

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

Looker به طور خودکار با ایجاد فیلترها ، که بر اساس ابعاد و اقدامات است ، امکان دستکاری در نمایش داده های خود را در اختیار کاربران قرار می دهد. در حالی که این روش ساده بسیاری از موارد استفاده را برآورده می کند ، اما نمی تواند هر نیاز تحلیلی را فعال کند. فیلترهای قالب بندی شده و پارامترهای مایع به طور گسترده موارد استفاده احتمالی را که می توانید از آنها پشتیبانی کنید ، گسترش می دهند.

از منظر SQL ، ابعاد و اقدامات فقط می تواند بیرونی ترین جایی را که یا بندهایی در پرس و جو شما دارند تغییر دهد. با این حال ، ممکن است متوجه شوید که می خواهید به کاربران اجازه دهید بخش های دیگر SQL را دستکاری کنند. تنظیم بخشی از یک جدول مشتق شده ، تنظیم کدام جدول پایگاه داده پرس و جو می شود ، یا ایجاد ابعاد و فیلترهای چند منظوره فقط برخی از ویژگی هایی است که می توانید با فیلترهای قالب بندی شده و پارامترهای مایع فعال کنید.

هشدار: پایداری برای جداول مشتق شده که از فیلترهای قالب بندی شده یا پارامترهای مایع استفاده می کنند ، پشتیبانی نمی شود.

فیلترهای قالب بندی شده و پارامترهای مایع از زبان قالب بندی مایع برای وارد کردن ورودی کاربر در نمایش داده های SQL استفاده می کنند. ابتدا از یک پارامتر LookML استفاده می کنید تا زمینه ای را برای تعامل کاربران ایجاد کنید. در مرحله بعد ، شما از یک متغیر مایع برای تزریق ورودی کاربر به نمایش داده های SQL استفاده می کنید.

مثال ها

بیایید چند نمونه را بررسی کنیم تا مقدار فیلترهای قالب بندی شده و پارامترهای مایع را نشان دهیم.

تهیه یک جدول مشتق از پویا با فیلتر قالب

یک جدول مشتق شده را در نظر بگیرید که هزینه طول عمر مشتری را در منطقه شمال شرقی محاسبه می کند:

مشاهده: مشتری_> 

در این پرس و جو ، می توانید ابعادی از مشتری_id و lifetime_spend ایجاد کنید. با این حال ، فرض کنید شما می خواستید که کاربر به جای اینکه آن را به "شمال شرقی" کدگذاری کند ، بتواند منطقه را مشخص کند. منطقه نمی تواند به عنوان یک بعد در معرض دید قرار گیرد ، بنابراین کاربر نمی تواند بر روی آن به صورت عادی فیلتر کند.

یک گزینه استفاده از یک فیلتر قالب بندی شده است که به نظر می رسد:

مشاهده: مشتری_فیلتر: order_region> 

برای دستورالعمل های گام به گام در زیر بیشتر بخوانید.

اگر یک جدول مشتق شده از یک فیلتر قالب استفاده کند ، نمی توانید جدول را پایدار کنید.

انجام یک اندازه گیری پویا با یک پارامتر مایع

یک اندازه گیری فیلتر شده را در نظر بگیرید که تعداد شلوار فروخته شده را اضافه می کند:

اندازه گیری: شلوار_

این ساده است ، اما اگر ده ها گروه وجود داشته باشد ، ایجاد یک اندازه گیری برای هر یک خسته کننده خواهد بود. علاوه بر این ، ممکن است تجربه اکتشاف را برای کاربران به هم ریخته باشد.

یک گزینه جایگزین ایجاد یک اندازه گیری پویا مانند این است:

اندازه گیری: رده_ countپارامتر: رده_تو_کونت

برای دستورالعمل های گام به گام در زیر بیشتر بخوانید.

استفاده اساسی

مرحله اول: چیزی را برای تعامل کاربر ایجاد کنید

• برای فیلترهای قالب بندی ، یک فیلتر اضافه کنید.
• برای پارامترهای مایع ، یک پارامتر اضافه کنید.

در هر صورت ، این قسمت ها تحت بخش فیلتر فقط قسمت های انتخاب کننده فیلتر در کاربر ظاهر می شوند.

هر دو قسمت فیلتر و پارامتر می توانند یک سری از پارامترهای کودک را بپذیرند و به شما امکان می دهد نحوه عملکرد آنها را سفارشی کنید. برای لیست کامل به صفحه اسناد پارامترهای Field مراجعه کنید. دو گزینه وجود دارد که دارای ذکر ویژه ای برای قسمت های پارامتر است.

اول ، قسمت های پارامتر می توانند نوع خاصی به نام Unquoted داشته باشند:

پارامتر: Table_Name

این نوع اجازه می دهد تا مقادیر وارد SQL شوند بدون اینکه در نقل قول ها محصور شوند ، همانطور که یک رشته وجود دارد. این می تواند در صورت نیاز به وارد کردن مقادیر SQL مانند نام جدول مفید باشد.

دوم ، قسمت های پارامتر گزینه ای به نام مقادیر مجاز دارند که به شما امکان می دهد یک نام کاربر پسند را با مقداری که می خواهید درج کنید ، مرتبط کنید. مثلا:

 پارامتر: sale_price_metric_pickerمجاز_ مقطع:مجاز_ مقطع:مجاز_ مقطع:> 

مرحله دوم: ورودی کاربر را اعمال کنید

مرحله دوم استفاده از مایع برای افزودن فیلتر قالب یا پارامتر مایع به صورت دلخواه است.

فیلترهای قالب بندی شده

نحو برای فیلترهای قالب بندی مانند این تجزیه می شود:

sql_or_lookml_reference

• شرایط و شرایط پایان کلمات هرگز تغییر نمی کند.
• Filter_Name را با نام فیلتر ایجاد شده در مرحله اول جایگزین کنید. همچنین اگر یک فیلد فقط فیلتر ایجاد نکردید ، می توانید از یک بعد استفاده کنید.
• SQL_OR_LOOKML_REFERENCE را با SQL یا LookML جایگزین کنید که باید "برابر" برای ورودی کاربر تنظیم شود (جزئیات زیر را در زیر بخوانید). در صورت استفاده از LookML ، از Syntax $ LookML استفاده کنید.

در مثال بالا ما استفاده کردیم:

سفارش. منطقه

تعامل بین برچسب های مایع و SQL که بین آنها می نویسید ، درک آن مهم است. برچسب های فیلتر قالب همیشه به یک عبارت منطقی تبدیل می شوند. به عنوان مثال ، اگر کاربر "شمال شرقی" را وارد فیلتر Order_Region کند ، نگاهگر این برچسب ها را به: Order. region = "شمال شرقی" تبدیل می کند. به عبارت دیگر ، Looker ورودی کاربر را درک می کند و بیان منطقی مناسب را تولید می کند.

این اغلب نقطه سردرگمی در بین توسعه دهندگان نگاه کننده است. فیلترهای قالب بندی شده همیشه منجر به بیان منطقی از نوعی می شوند و نه مقدار فردی که توسط کاربر وارد می شود.

از آنجا که فیلترهای قالب بندی یک عبارت منطقی را برمی گردانند ، می توانید از آنها با سایر اپراتورهای منطقی و عبارات منطقی استفاده کنید که در SQL WHERS معتبر هستند. با استفاده از مثال بالا ، اگر می خواهید تمام مقادیر را به جز منطقه ای که کاربر انتخاب کرده است برگردانید ، می توانید از موارد زیر در عبارت WHERE استفاده کنید:

نه (Order. Region) 

همچنین استفاده از یک فیلد LookML به عنوان شرایط فیلتر معتبر است. هر فیلری که مستقیماً در قسمت LEOKML اعمال می شود ، مقدار عبارت WHERE را تعیین می کند:

مشاهده: مشتری_بعد: منطقه 

پارامترهای مایع

نحو برای پارامترهای مایع مانند این تجزیه می شود:

• پارامتر کلمه هرگز تغییر نمی کند.
• PARAMETER_NAME را با نام پارامتر ایجاد شده در مرحله اول جایگزین کنید.

به عنوان مثال ، برای استفاده از ورودی از قسمت پارامتر در مرحله اول ، در بالا می توانید اندازه ای مانند این را ایجاد کنید:

 اندازه گیری: sale_price_metric 

انتخاب بین فیلترهای قالب بندی شده و پارامترهای مایع

اگرچه فیلترهای قالب بندی شده و پارامترهای مایع مشابه هستند ، تفاوت مهمی بین آنها وجود دارد:

• پارامترهای مایع ورودی کاربر را مستقیماً وارد می کنند (یا با استفاده از مقادیری که با مقادیر مجاز تعریف می کنید).
• فیلترهای قالب بندی شده مقادیر را به عنوان بیانیه های منطقی درج می کنند ، همانطور که در بالا توضیح داده شد.

در مواقعی که می خواهید ورودی انعطاف پذیر تری به کاربران ارائه دهید (مانند انواع مختلف محدوده تاریخ یا جستجوهای رشته ای) ، سعی کنید در صورت امکان از فیلترهای قالب بندی شده استفاده کنید. Looker می تواند ورودی کاربر را تفسیر کند و SQL مناسب را در پشت صحنه بنویسد. این امر مانع از حساب کردن هر نوع ورودی کاربر می شود.

در شرایطی که یک عبارت منطقی در آن وارد نشود ، یا جایی که می دانید مجموعه ای از گزینه های محدودی که کاربر ممکن است وارد کنید ، از پارامترهای مایع استفاده کنید.

ارسال بازخورد

به جز آنچه در غیر این صورت ذکر شد ، محتوای این صفحه تحت مجوز Creative Commons Attribution 4. 0 مجوز دارد و نمونه های کد تحت مجوز Apache 2. 0 مجوز دارند. برای جزئیات بیشتر ، به سیاست های سایت Google Developers مراجعه کنید. جاوا یک علامت تجاری ثبت شده اوراکل و/یا شرکت های وابسته به آن است.

آخرین به روز شده 2023-03-06 UTC.