آموزش sp_create_plan_guide_from_handle از روی Plan Cache

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

sp_create_plan_guide_from_handle یک Plan Guide را از روی Plan Cache و Handle مشخص می‌سازد تا برنامه اجرایی یا Hint مشاهده‌شده حفظ شود.

جایگاه sp_create_plan_guide_from_handle در معماری این است که میان نیاز کسب‌وکار و رفتار واقعی موتور SQL Server یک نقطه کنترل یا مشاهده ایجاد کند. مفاهیم محوری آن شامل sp_create_plan_guide_from_handle، plan_handle، statement_start_offset، Plan Cache، USE PLAN، sys.dm_exec_query_stats است. هرکدام باید در سطح درست اندازه‌گیری شوند؛ زیرا شباهت نام‌ها به معنای یکسان بودن Scope نیست.

این تصویر جایگاه sp_create_plan_guide_from_handle را در کنار sp_create_plan_guide_from_handle، plan_handle، statement_start_offset، Plan Cache نشان می‌دهد و کمک می‌کند پیش از اجرای دستور، وابستگی‌های اصلی و مسیر تصمیم مشخص شوند.

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

Syntax یا Query پایه

EXEC sys.sp_create_plan_guide_from_handle
    @name = N'Guide_FromCache',
    @plan_handle = @plan_handle,
    @statement_start_offset = @statement_start_offset;

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

• sp_create_plan_guide_from_handle: باید با Scope واقعی sp_create_plan_guide_from_handle و نسخه SQL Server هماهنگ شود.
• plan_handle: باید با Scope واقعی sp_create_plan_guide_from_handle و نسخه SQL Server هماهنگ شود.
• statement_start_offset: باید با Scope واقعی sp_create_plan_guide_from_handle و نسخه SQL Server هماهنگ شود.
• Plan Cache: باید با Scope واقعی sp_create_plan_guide_from_handle و نسخه SQL Server هماهنگ شود.
• USE PLAN: باید با Scope واقعی sp_create_plan_guide_from_handle و نسخه SQL Server هماهنگ شود.

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

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

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

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

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

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

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

EXEC sys.sp_create_plan_guide_from_handle
    @name = N'Guide_FromCache',
    @plan_handle = @plan_handle,
    @statement_start_offset = @statement_start_offset;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

در این سناریو هدف آن است که بُعد شماره 7 از sp_create_plan_guide_from_handle به‌صورت کنترل‌شده بررسی شود. 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_create_plan_guide_from_handle در مرحله 8

در این سناریو هدف آن است که بُعد شماره 8 از sp_create_plan_guide_from_handle به‌صورت کنترل‌شده بررسی شود. 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_create_plan_guide_from_handle در مرحله 9

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

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

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

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

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

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

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

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

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

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

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

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

Performance Considerations

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

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

Best Practices

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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