آموزش sp_control_plan_guide برای فعال‌سازی، غیرفعال‌سازی و حذف

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

sp_control_plan_guide چرخه عمر Plan Guide را با عملیات ENABLE، DISABLE، DROP و DROP ALL کنترل می‌کند.

جایگاه sp_control_plan_guide در معماری این است که میان نیاز کسب‌وکار و رفتار واقعی موتور SQL Server یک نقطه کنترل یا مشاهده ایجاد کند. مفاهیم محوری آن شامل sp_control_plan_guide، ENABLE، DISABLE، DROP، DROP ALL، Plan Guide State است. هرکدام باید در سطح درست اندازه‌گیری شوند؛ زیرا شباهت نام‌ها به معنای یکسان بودن Scope نیست.

این تصویر جایگاه sp_control_plan_guide را در کنار sp_control_plan_guide، ENABLE، DISABLE، DROP نشان می‌دهد و کمک می‌کند پیش از اجرای دستور، وابستگی‌های اصلی و مسیر تصمیم مشخص شوند.

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

Syntax یا Query پایه

EXEC sys.sp_control_plan_guide N'DISABLE', N'Guide_OrderLookup';
EXEC sys.sp_control_plan_guide N'ENABLE', N'Guide_OrderLookup';

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

• sp_control_plan_guide: باید با Scope واقعی sp_control_plan_guide و نسخه SQL Server هماهنگ شود.
• ENABLE: باید با Scope واقعی sp_control_plan_guide و نسخه SQL Server هماهنگ شود.
• DISABLE: باید با Scope واقعی sp_control_plan_guide و نسخه SQL Server هماهنگ شود.
• DROP: باید با Scope واقعی sp_control_plan_guide و نسخه SQL Server هماهنگ شود.
• DROP ALL: باید با Scope واقعی sp_control_plan_guide و نسخه SQL Server هماهنگ شود.

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

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

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

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

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

مثال 1: سناریوی sp_control_plan_guide در مرحله 1

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

EXEC sys.sp_control_plan_guide N'DISABLE', N'Guide_OrderLookup';
EXEC sys.sp_control_plan_guide N'ENABLE', N'Guide_OrderLookup';

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

مثال 2: سناریوی sp_control_plan_guide در مرحله 2

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

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

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

مثال 3: سناریوی sp_control_plan_guide در مرحله 3

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

SELECT name, query_text, hints
FROM sys.plan_guides
WHERE is_disabled = 0;

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

مثال 4: سناریوی sp_control_plan_guide در مرحله 4

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

EXEC sys.sp_control_plan_guide N'DISABLE', N'Guide_OrderLookup';

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

مثال 5: سناریوی sp_control_plan_guide در مرحله 5

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

EXEC sys.sp_control_plan_guide N'ENABLE', N'Guide_OrderLookup';

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

مثال 6: سناریوی sp_control_plan_guide در مرحله 6

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

SELECT plan_guide_id, name, create_date, modify_date
FROM sys.plan_guides;

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

مثال 7: سناریوی sp_control_plan_guide در مرحله 7

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

SELECT cp.plan_handle, qs.statement_start_offset, qs.execution_count
FROM sys.dm_exec_query_stats AS qs
CROSS APPLY sys.dm_exec_sql_text(qs.sql_handle) AS st
CROSS APPLY (SELECT qs.plan_handle) AS cp
WHERE st.text LIKE N'%Orders%';

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

مثال 8: سناریوی sp_control_plan_guide در مرحله 8

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

EXEC sys.sp_get_query_template
    @querytext = N'SELECT * FROM dbo.Orders WHERE CustomerID = 42',
    @templatetext = @template OUTPUT,
    @parameters = @params OUTPUT;

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

مثال 9: سناریوی sp_control_plan_guide در مرحله 9

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

-- حذف فقط پس از ثبت نام و بررسی وابستگی
EXEC sys.sp_control_plan_guide N'DROP', N'Guide_OrderLookup';

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

مثال 10: سناریوی sp_control_plan_guide در مرحله 10

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

SELECT name, scope_type_desc, is_disabled, hints
FROM sys.plan_guides
ORDER BY modify_date DESC;

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

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

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

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

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

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

Performance Considerations

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

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

Best Practices

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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