/
/
/
/
Query Provider یکی از انواع Providerهای مبتنی بر بانک اطلاعاتی است که برای دریافت اطلاعات از طریق اجرای Query روی Database استفاده می‌شود. در این نوع Provider، ساختار Query، پارامترهای ورودی، فیلدهای خروجی و تنظیمات Paging برای مدیریت حجم داده تعریف می‌شوند.
Provider از نوع Query
در Query Provider، منطق دریافت اطلاعات توسط Query تعریف می‌شود. این Provider برای سناریوهایی مناسب است که داده مورد نیاز با یک دستور Query قابل استخراج بوده و نیاز به اجرای Stored Procedure یا Function وجود ندارد.
نکته مهم
Query Provider فقط مسئول تعریف نحوه دریافت داده است و ساختار خروجی آن باید مطابق نیاز مصرف‌کننده Provider طراحی شود.
ساخت Query Provider
برای ایجاد Query Provider ابتدا نوع Provider روی Query انتخاب شده و سپس اطلاعات مربوط به منبع داده، Query، پارامترها و خروجی‌ها تعریف می‌شوند.
تعریف Query
در این بخش دستور Query مورد نیاز برای دریافت اطلاعات از Database ثبت می‌شود. Query باید دارای ساختار خروجی مشخص باشد تا فیلدهای خروجی Provider قابل تعریف و استفاده باشند.
SELECT
Id,
Name
FROM Customers
پارامترهای Query
برای Queryهایی که نیاز به دریافت مقدار ورودی دارند، پارامتر تعریف می‌شود. مقدار پارامتر در زمان اجرای Provider ارسال شده و در Query مورد استفاده قرار می‌گیرد.
| عنوان | توضیح |
|---|---|
| نام پارامتر | نام پارامتری که در زمان اجرای Provider مقداردهی می‌شود. |
| نوع داده | نوع داده مورد انتظار برای مقدار ورودی. |
| مقدار ورودی | مقداری که هنگام اجرای Provider ارسال می‌شود. |
فیلدهای خروجی Query
پس از تعریف Query، فیلدهای خروجی Provider مشخص می‌شوند. این فیلدها نتیجه اجرای Query را تشکیل داده و در بخش‌های مصرف‌کننده استفاده می‌شوند.
نکته اجرایی
نام و ساختار فیلدهای خروجی باید با نیاز مصرف‌کننده هماهنگ باشد. تغییر ساختار خروجی ممکن است روی بخش‌هایی که از Provider استفاده می‌کنند اثر بگذارد.
Paging در Query Provider
برای مدیریت حجم داده‌های خروجی، Query Provider از Paging استفاده می‌کند. Paging باعث می‌شود اطلاعات در چند بخش دریافت شوند و تمام داده‌ها به‌صورت هم‌زمان بارگذاری نشوند.
مزایای استفاده از Paging
- کاهش حجم داده منتقل‌شده در هر درخواست
- بهبود سرعت نمایش اطلاعات
- کنترل بهتر مصرف منابع در زمان اجرای Queryهای بزرگ
Warning
رفتار دقیق Paging وابسته به تنظیمات Provider و نحوه استفاده مصرف‌کننده است. سناریوهای اجرایی باید در همان Build مقصد تست و مستند شوند.