آموزش sys.plan_guides و ممیزی Plan Guideهای SQL Server

تعریف و جایگاه موضوع

sys.plan_guides کاتالوگ Plan Guideهای پایگاه داده را با نوع، Scope، متن تطبیق، Hint و وضعیت فعال نمایش می‌دهد.

جایگاه sys.plan_guides در معماری این است که میان نیاز کسب‌وکار و رفتار واقعی موتور SQL Server یک نقطه کنترل یا مشاهده ایجاد کند. مفاهیم محوری آن شامل sys.plan_guides، plan_guide_id، scope_type_desc، query_text، hints، is_disabled است. هرکدام باید در سطح درست اندازه‌گیری شوند؛ زیرا شباهت نام‌ها به معنای یکسان بودن Scope نیست.

این تصویر جایگاه sys.plan_guides را در کنار sys.plan_guides، plan_guide_id، scope_type_desc، query_text نشان می‌دهد و کمک می‌کند پیش از اجرای دستور، وابستگی‌های اصلی و مسیر تصمیم مشخص شوند.

نحو، سطح دسترسی و رفتار اجرایی

Syntax یا Query پایه

SELECT plan_guide_id, name, scope_type_desc, is_disabled, query_text, hints
FROM sys.plan_guides
ORDER BY name;

پارامترها و اجزای اثرگذار

• sys.plan_guides: باید با Scope واقعی sys.plan_guides و نسخه SQL Server هماهنگ شود.
• plan_guide_id: باید با Scope واقعی sys.plan_guides و نسخه SQL Server هماهنگ شود.
• scope_type_desc: باید با Scope واقعی sys.plan_guides و نسخه SQL Server هماهنگ شود.
• query_text: باید با Scope واقعی sys.plan_guides و نسخه SQL Server هماهنگ شود.
• hints: باید با Scope واقعی sys.plan_guides و نسخه SQL Server هماهنگ شود.

نوع خروجی و رفتارهای ویژه

خروجی sys.plan_guides ممکن است یک تغییر DDL، وضعیت کاتالوگی، Snapshot از DMV یا اثر روی کامپایل‌های بعدی باشد. رفتار با NULL، Restart، Reconfigure و Reset به نوع موضوع وابسته است؛ بنابراین نتیجه ظاهری Query را با اثر Runtime اشتباه نگیرید.

منطق اجرا و نقاط کنترل

جریان بالا نشان می‌دهد sys.plan_guides از ورودی و پیکربندی اولیه به مشاهده خروجی، سنجش هزینه و تصمیم نهایی می‌رسد؛ بخش Chart-like برای مقایسه مراحل پرهزینه‌تر طراحی شده است.

مثال‌های عملی از ساده تا پیشرفته

مثال 1: سناریوی sys.plan_guides در مرحله 1

در این سناریو هدف آن است که بُعد شماره 1 از sys.plan_guides به‌صورت کنترل‌شده بررسی شود. Query را ابتدا در محیط Test اجرا کنید و نتیجه را با Baseline همان بازه مقایسه کنید.

SELECT *
FROM sys.plan_guides
;

نکته کاربردی: مثال 1 زمانی معتبر است که خروجی آن با نسخه، Permission و بار همزمان سرور شما سازگار باشد؛ صرف موفق بودن Syntax به معنای مناسب بودن تصمیم نیست.

مثال 2: سناریوی sys.plan_guides در مرحله 2

در این سناریو هدف آن است که بُعد شماره 2 از sys.plan_guides به‌صورت کنترل‌شده بررسی شود. Query را ابتدا در محیط Test اجرا کنید و نتیجه را با Baseline همان بازه مقایسه کنید.

SELECT TOP (20) *
FROM sys.plan_guides
WHERE 1 = 1
ORDER BY 1;

نکته کاربردی: مثال 2 زمانی معتبر است که خروجی آن با نسخه، Permission و بار همزمان سرور شما سازگار باشد؛ صرف موفق بودن Syntax به معنای مناسب بودن تصمیم نیست.

مثال 3: سناریوی sys.plan_guides در مرحله 3

در این سناریو هدف آن است که بُعد شماره 3 از sys.plan_guides به‌صورت کنترل‌شده بررسی شود. Query را ابتدا در محیط Test اجرا کنید و نتیجه را با Baseline همان بازه مقایسه کنید.

SELECT COUNT_BIG(*) AS visible_rows
FROM sys.plan_guides;

نکته کاربردی: مثال 3 زمانی معتبر است که خروجی آن با نسخه، Permission و بار همزمان سرور شما سازگار باشد؛ صرف موفق بودن Syntax به معنای مناسب بودن تصمیم نیست.

مثال 4: سناریوی sys.plan_guides در مرحله 4

در این سناریو هدف آن است که بُعد شماره 4 از sys.plan_guides به‌صورت کنترل‌شده بررسی شود. Query را ابتدا در محیط Test اجرا کنید و نتیجه را با Baseline همان بازه مقایسه کنید.

SELECT *
FROM sys.plan_guides
ORDER BY 1 DESC;

نکته کاربردی: مثال 4 زمانی معتبر است که خروجی آن با نسخه، Permission و بار همزمان سرور شما سازگار باشد؛ صرف موفق بودن Syntax به معنای مناسب بودن تصمیم نیست.

مثال 5: سناریوی sys.plan_guides در مرحله 5

در این سناریو هدف آن است که بُعد شماره 5 از sys.plan_guides به‌صورت کنترل‌شده بررسی شود. Query را ابتدا در محیط Test اجرا کنید و نتیجه را با Baseline همان بازه مقایسه کنید.

SELECT TOP (10) *
FROM sys.plan_guides
OPTION (RECOMPILE);

نکته کاربردی: مثال 5 زمانی معتبر است که خروجی آن با نسخه، Permission و بار همزمان سرور شما سازگار باشد؛ صرف موفق بودن Syntax به معنای مناسب بودن تصمیم نیست.

مثال 6: سناریوی sys.plan_guides در مرحله 6

در این سناریو هدف آن است که بُعد شماره 6 از sys.plan_guides به‌صورت کنترل‌شده بررسی شود. Query را ابتدا در محیط Test اجرا کنید و نتیجه را با Baseline همان بازه مقایسه کنید.

SELECT *
FROM sys.plan_guides
WHERE 1 = 0; -- مشاهده Metadata بدون دریافت ردیف

نکته کاربردی: مثال 6 زمانی معتبر است که خروجی آن با نسخه، Permission و بار همزمان سرور شما سازگار باشد؛ صرف موفق بودن Syntax به معنای مناسب بودن تصمیم نیست.

مثال 7: سناریوی sys.plan_guides در مرحله 7

در این سناریو هدف آن است که بُعد شماره 7 از sys.plan_guides به‌صورت کنترل‌شده بررسی شود. Query را ابتدا در محیط Test اجرا کنید و نتیجه را با Baseline همان بازه مقایسه کنید.

SELECT DB_NAME() AS database_name, COUNT(*) AS item_count
FROM sys.plan_guides;

نکته کاربردی: مثال 7 زمانی معتبر است که خروجی آن با نسخه، Permission و بار همزمان سرور شما سازگار باشد؛ صرف موفق بودن Syntax به معنای مناسب بودن تصمیم نیست.

مثال 8: سناریوی sys.plan_guides در مرحله 8

در این سناریو هدف آن است که بُعد شماره 8 از sys.plan_guides به‌صورت کنترل‌شده بررسی شود. Query را ابتدا در محیط Test اجرا کنید و نتیجه را با Baseline همان بازه مقایسه کنید.

SELECT TOP (25) *
FROM sys.plan_guides
ORDER BY 1 DESC;

نکته کاربردی: مثال 8 زمانی معتبر است که خروجی آن با نسخه، Permission و بار همزمان سرور شما سازگار باشد؛ صرف موفق بودن Syntax به معنای مناسب بودن تصمیم نیست.

مثال 9: سناریوی sys.plan_guides در مرحله 9

در این سناریو هدف آن است که بُعد شماره 9 از sys.plan_guides به‌صورت کنترل‌شده بررسی شود. Query را ابتدا در محیط Test اجرا کنید و نتیجه را با Baseline همان بازه مقایسه کنید.

SELECT *
INTO #snapshot_1424
FROM sys.plan_guides;
SELECT COUNT(*) AS captured_rows FROM #snapshot_1424;

نکته کاربردی: مثال 9 زمانی معتبر است که خروجی آن با نسخه، Permission و بار همزمان سرور شما سازگار باشد؛ صرف موفق بودن Syntax به معنای مناسب بودن تصمیم نیست.

مثال 10: سناریوی sys.plan_guides در مرحله 10

در این سناریو هدف آن است که بُعد شماره 10 از sys.plan_guides به‌صورت کنترل‌شده بررسی شود. Query را ابتدا در محیط Test اجرا کنید و نتیجه را با Baseline همان بازه مقایسه کنید.

SELECT TOP (50) *
FROM sys.plan_guides;
-- خروجی را با Snapshot قبلی مقایسه کنید

نکته کاربردی: مثال 10 زمانی معتبر است که خروجی آن با نسخه، Permission و بار همزمان سرور شما سازگار باشد؛ صرف موفق بودن Syntax به معنای مناسب بودن تصمیم نیست.

کاربردهای واقعی در پروژه

sys.plan_guides در پروژه‌های واقعی برای کنترل یک نقطه مشخص از چرخه عمر داده یا Query به‌کار می‌رود. تیم عملیات می‌تواند از آن برای ساخت Runbook، تیم توسعه برای طراحی رفتار قابل پیش‌بینی و تیم معماری برای مقایسه هزینه گزینه‌ها استفاده کند.

در محیط سازمانی بهتر است اجرای sys.plan_guides از مسیر Change Management عبور کند. Ticket باید شامل دلیل، دامنه، زمان، مالک، Query قبل و بعد و شاخص پذیرش باشد. این رویکرد اختلاف میان نتیجه آزمایش و رفتار Production را کاهش می‌دهد.

اشتباهات رایج و روش اصلاح

• اشتباه: نتیجه یک اجرای کوتاه را معیار قطعی sys.plan_guides دانستن. اصلاح: چند Snapshot در بار مشابه ثبت کنید.
• اشتباه: کپی Syntax از نسخه دیگر. اصلاح: مستندات نسخه مقصد و Metadata همان Instance را کنترل کنید.
• اشتباه: حذف وابستگی‌ها از تحلیل. اصلاح: Object، Group، Pool، Plan یا Indexهای مرتبط را پیش از تغییر فهرست کنید.
• اشتباه: نداشتن فرمان بازگشت. اصلاح: قبل از Apply، دستور معکوس و شرط توقف را آزمایش کنید.

Performance Considerations

اثر کارایی sys.plan_guides باید در سطح درست سنجیده شود. زمان اجرای یک Query ممکن است کاهش یابد اما مصرف حافظه، تعداد Compile، فشار CPU یا هزینه نگهداری افزایش پیدا کند. بنابراین حداقل دو شاخص مستقیم و یک شاخص جانبی ثبت کنید.

در تحلیل Plan و Cardinality، تفاوت میان همبستگی و علت را رعایت کنید. اگر همزمان با sys.plan_guides تغییر دیگری منتشر شده باشد، آزمایش A/B یا بازه کنترل لازم است. Queryهای DMV نیز خودشان هزینه دارند و نباید با نرخ بسیار بالا Poll شوند.

Best Practices

• sys.plan_guides را ابتدا روی نمونه نماینده Workload و نه داده ساختگی بسیار کوچک آزمایش کنید.
• نام‌گذاری اشیا و تغییرات را استاندارد کنید تا ممیزی و حذف بعدی ساده باشد.
• Baseline، مقدار هدف، بازه اندازه‌گیری و آستانه شکست را پیش از اجرا بنویسید.
• پس از تغییر، هم تعریف کاتالوگی و هم رفتار Runtime را بررسی کنید.
• برای تغییرات پرریسک، Maintenance Window و مالک Rollback تعیین کنید.

این نمودار خطاهای رایج sys.plan_guides را در برابر مسیر پیشنهادی قرار می‌دهد؛ فلش‌ها نشان می‌دهند هر خطا با کدام کنترل فنی و معیار Performance اصلاح می‌شود.

مزایا، محدودیت‌ها و زمان نامناسب استفاده

سؤالات متداول

برای شروع کار با sys.plan_guides چه پیش‌نیازی لازم است؟

پیش از اجرا، نسخه و Edition، سطح دسترسی، وضعیت پایگاه داده و یک محیط آزمایشی همسان با Production را بررسی کنید. برای sys.plan_guides ثبت Baseline اولیه باعث می‌شود تغییر واقعی از نوسان عادی جدا شود.

چگونه صحت پیکربندی sys.plan_guides را بررسی کنیم؟

تعریف کاتالوگی را با نمای Runtime مقایسه کنید، سپس یک سناریوی کنترل‌شده اجرا و نتیجه را در بازه زمانی مشخص ثبت کنید. اتکا به یک Snapshot برای قضاوت درباره sys.plan_guides کافی نیست.

sys.plan_guides در چه پروژه‌هایی ارزش تجاری بیشتری ایجاد می‌کند؟

در سامانه‌هایی که تأخیر، پایداری و تفکیک بارکاری مستقیماً بر درآمد یا SLA اثر دارد، sys.plan_guides می‌تواند ارزش بیشتری ایجاد کند؛ البته نتیجه باید با شاخص قابل اندازه‌گیری تأیید شود.

چه زمانی هزینه نگهداری sys.plan_guides از منفعت آن بیشتر می‌شود؟

وقتی حجم عملیات پایین، تیم فاقد مهارت نگهداری یا مسیر بازگشت نامشخص است، پیچیدگی sys.plan_guides ممکن است توجیه نداشته باشد. تصمیم باید بر هزینه کل مالکیت استوار باشد.

sys.plan_guides با روش جایگزین در SQL Server چه تفاوتی دارد؟

روش جایگزین معمولاً Scope، هزینه اجرا و میزان کنترل متفاوتی دارد. مقایسه درست باید روی Workload واقعی، Plan یا مصرف منابع و نه صرفاً زمان یک Query انجام شود.

برای پیاده‌سازی حرفه‌ای sys.plan_guides چه خدماتی لازم است؟

تحلیل Workload، طراحی آزمایش، پیاده‌سازی مرحله‌ای، مستندسازی، آموزش تیم و پایش پس از انتشار اجزای اصلی خدمت حرفه‌ای هستند؛ اجرای مستقیم در Production بدون این زنجیره پرریسک است.

رایج‌ترین خطای عملیاتی در sys.plan_guides چیست؟

خطای رایج، اعمال تنظیم بدون اندازه‌گیری وضعیت پایه و بدون کنترل وابستگی‌هاست. در sys.plan_guides ابتدا Scope را محدود کنید و هر تغییر را با یک معیار موفقیت و یک شرط توقف همراه سازید.

اثر sys.plan_guides بر Performance چگونه اندازه‌گیری می‌شود؟

شاخص مناسب به موضوع بستگی دارد، اما زمان پاسخ، CPU، Memory، تعداد اجرای موفق، صف انتظار و تغییر Plan از معیارهای رایج‌اند. مقایسه باید در پنجره بار مشابه انجام شود.

بهترین روش مستندسازی و Rollback برای sys.plan_guides چیست؟

نام اشیا، دلیل تغییر، مقدار قبل و بعد، مالک تصمیم، زمان اعمال، Query اعتبارسنجی و فرمان بازگشت را در Runbook ثبت کنید تا sys.plan_guides به تنظیمی ناشناخته تبدیل نشود.

sys.plan_guides با کدام نسخه‌های SQL Server سازگار است؟

قابلیت دقیق می‌تواند بین نسخه‌ها و محیط‌های Azure تفاوت داشته باشد. مستندات همان نسخه را بررسی و Syntax را روی محیط Test اجرا کنید؛ از تعمیم رفتار نسخه جدید به سرور قدیمی پرهیز شود.

سؤالات مصاحبه

• چگونه تشخیص می‌دهید sys.plan_guides واقعاً روی Workload اثر گذاشته است؟
• اگر پس از اعمال sys.plan_guides وضعیت بدتر شد، ترتیب عیب‌یابی شما چیست؟
• چه تفاوتی میان تعریف کاتالوگی و وضعیت Runtime در sys.plan_guides وجود دارد؟
• برای جلوگیری از تغییرات ناخواسته در sys.plan_guides چه کنترل‌هایی می‌گذارید؟
• چه زمانی تصمیم می‌گیرید sys.plan_guides را حذف یا به روش دیگری مهاجرت دهید؟

چک‌لیست نهایی

1. Scope دقیق sys.plan_guides را ثبت کنید.
2. Permission و سازگاری نسخه را کنترل کنید.
3. Query پایه و Snapshot قبل از تغییر را ذخیره کنید.
4. ده مثال این مقاله را متناسب با نام اشیای واقعی بازنویسی کنید.
5. شاخص موفقیت و شرط Rollback را تعیین کنید.
6. پس از Apply، Metadata و Runtime را دوباره بررسی کنید.