تعریف و کاربرد اصلی

sys.dm_exec_query_plan برای بازیابی Showplan کامپایل‌شده یک Batch یا Query از روی plan_handle در قالب XML طراحی شده است. این ابزار بخشی از مجموعه Dynamic Management Objects موتور Database Engine است و معمولاً زمانی استفاده می‌شود که DBA یا Developer می‌خواهد از علائم کلی مانند CPU بالا، کندی، Blocking یا Recompile به شواهد دقیق‌تری برسد.

در عمل هیچ DMV یا DMF به‌تنهایی پاسخ کامل نمی‌دهد. بهترین تحلیل زمانی شکل می‌گیرد که اطلاعات این آبجکت با sys.dm_exec_requests، sys.dm_exec_query_stats، sys.dm_exec_cached_plans، Query Store، Wait Statistics و متن SQL کنار هم قرار گیرد. این نگاه ترکیبی از اشتباه رایج «دیدن یک Plan و صدور حکم قطعی» جلوگیری می‌کند.

کاربرد شاخص این ابزار: بازیابی Showplan کامپایل‌شده یک Batch یا Query از روی plan_handle در قالب XML. بنابراین قبل از اجرا مشخص کنید سؤال فنی شما چیست و دقیقاً دنبال کدام Session، Plan یا Query هستید.

Syntax، ورودی و خروجی

نحو پایه

SELECT *
FROM sys.dm_exec_query_plan(@plan_handle);

پارامتر یا Context موردنیاز

plan_handle از نوع varbinary(64) است و معمولاً از sys.dm_exec_cached_plans، sys.dm_exec_query_stats یا sys.dm_exec_requests به دست می‌آید.

نوع خروجی

ستون‌های dbid، objectid، number، encrypted و query_plan را برمی‌گرداند؛ query_plan از نوع XML است و نمای کامپایل‌شده طرح اجرا را نگه می‌دارد.

مقادیر Handle مانند plan_handle و sql_handle شناسه‌های باینری موقت هستند. آنها را به‌عنوان شناسه دائمی کسب‌وکار ذخیره نکنید. Recompile، Eviction، Restart سرویس یا تغییرات Cache می‌تواند اعتبار عملی آنها را تغییر دهد.

پیش‌نیازهای امنیتی و نکات نسخه

در SQL Server و سرویس‌های ابری مرتبط قابل استفاده است. در SQL Server 2022 و نسخه‌های جدیدتر، دسترسی‌های Performance State برای بسیاری از DMVهای اجرایی اهمیت بیشتری پیدا کرده است.

در بسیاری از نسخه‌ها برای مشاهده اطلاعات سراسری Server به مجوزهای خانواده VIEW SERVER STATE یا در نسخه‌های جدیدتر VIEW SERVER PERFORMANCE STATE نیاز دارید. برخی DMVهای Database-scoped نیز مجوزهای Database Performance State می‌خواهند. حساب Service یا Application را صرفاً برای راحتی مانیتورینگ عضو sysadmin نکنید؛ اصل Least Privilege را رعایت کنید.

در Azure SQL Database و Managed Instance دامنه دید Sessionها و نام Permissionها می‌تواند متفاوت باشد. اسکریپت Production باید نسخه، Edition و محیط اجرا را تشخیص دهد و در صورت نبود مجوز، خطای قابل فهم برگرداند.

مثال‌های عملی

مثال 1: دریافت طرح یک Query از Plan Cache

یک plan_handle واقعی را از Query Stats می‌گیریم و Showplan XML همان Plan را می‌خوانیم.

DECLARE @plan_handle varbinary(64);
SELECT TOP (1) @plan_handle = plan_handle
FROM sys.dm_exec_query_stats
ORDER BY last_execution_time DESC;

SELECT dbid, objectid, query_plan
FROM sys.dm_exec_query_plan(@plan_handle);

نکته کاربردی: این الگو برای شروع تحلیل Plan بدون استفاده از Handle ثابت مناسب است.

مثال 2: ترکیب با sys.dm_exec_query_stats

برای Queryهای پرمصرف CPU، Plan را کنار آمار تجمعی نمایش می‌دهیم.

SELECT TOP (10)
    qs.execution_count,
    qs.total_worker_time,
    qp.query_plan
FROM sys.dm_exec_query_stats AS qs
CROSS APPLY sys.dm_exec_query_plan(qs.plan_handle) AS qp
ORDER BY qs.total_worker_time DESC;

نکته کاربردی: ابتدا Queryهای مهم را محدود کنید تا XMLهای غیرضروری خوانده نشوند.

مثال 3: طرح درخواست‌های فعال

برای Requestهای در حال اجرا، plan_handle جاری را به Showplan تبدیل می‌کنیم.

SELECT
    r.session_id,
    r.status,
    r.command,
    qp.query_plan
FROM sys.dm_exec_requests AS r
OUTER APPLY sys.dm_exec_query_plan(r.plan_handle) AS qp
WHERE r.session_id <> @@SPID;

نکته کاربردی: OUTER APPLY باعث می‌شود حتی در صورت NULL بودن Plan اطلاعات Request از دست نرود.

مثال 4: فیلتر بر اساس دیتابیس Compile

Planهایی را که dbid آنها با دیتابیس جاری یکسان است جدا می‌کنیم.

SELECT TOP (20)
    cp.usecounts,
    qp.dbid,
    qp.query_plan
FROM sys.dm_exec_cached_plans AS cp
CROSS APPLY sys.dm_exec_query_plan(cp.plan_handle) AS qp
WHERE qp.dbid = DB_ID()
ORDER BY cp.usecounts DESC;

نکته کاربردی: برای محیط چنددیتابیسی این فیلتر دامنه تحلیل را کوچک می‌کند.

مثال 5: بازیابی Plan یک Stored Procedure

Planهای مربوط به آبجکت‌های ماژولی را با objectid نام‌گذاری می‌کنیم.

SELECT TOP (20)
    DB_NAME(qp.dbid) AS database_name,
    OBJECT_NAME(qp.objectid, qp.dbid) AS object_name,
    qp.query_plan
FROM sys.dm_exec_cached_plans AS cp
CROSS APPLY sys.dm_exec_query_plan(cp.plan_handle) AS qp
WHERE qp.objectid IS NOT NULL;

نکته کاربردی: برای Ad hoc Batchها objectid معمولاً NULL است.

مثال 6: تشخیص Planهای بدون XML

Plan Cache را برای مواردی که Showplan قابل بازیابی نیست بررسی می‌کنیم.

SELECT TOP (50)
    cp.cacheobjtype,
    cp.objtype,
    cp.usecounts,
    qp.query_plan
FROM sys.dm_exec_cached_plans AS cp
OUTER APPLY sys.dm_exec_query_plan(cp.plan_handle) AS qp
WHERE qp.query_plan IS NULL;

نکته کاربردی: NULL می‌تواند به Eviction، نوع Batch یا محدودیت‌های Plan مربوط باشد.

مثال 7: بررسی Reuse کنار Plan

طرح‌هایی با بیشترین استفاده مجدد را برای تحلیل الگوی Cache نمایش می‌دهیم.

SELECT TOP (10)
    cp.usecounts,
    cp.size_in_bytes,
    qp.query_plan
FROM sys.dm_exec_cached_plans AS cp
CROSS APPLY sys.dm_exec_query_plan(cp.plan_handle) AS qp
ORDER BY cp.usecounts DESC;

نکته کاربردی: Reuse بالا معمولاً نشانه مفیدی برای اولویت‌بندی Queryهای پرتکرار است.

مثال 8: ترکیب متن SQL و Plan

متن Query و XML Plan را در یک خروجی کنار هم قرار می‌دهیم.

SELECT TOP (10)
    st.text AS batch_text,
    qp.query_plan
FROM sys.dm_exec_query_stats AS qs
CROSS APPLY sys.dm_exec_sql_text(qs.sql_handle) AS st
CROSS APPLY sys.dm_exec_query_plan(qs.plan_handle) AS qp
ORDER BY qs.last_execution_time DESC;

نکته کاربردی: دیدن متن و Plan کنار هم سرعت Root Cause Analysis را بالا می‌برد.

مثال 9: اولویت‌بندی Planهای بزرگ

ابتدا Planهای بزرگ‌تر را بر اساس اندازه Cache پیدا کرده و XML آنها را می‌خوانیم.

SELECT TOP (10)
    cp.size_in_bytes,
    cp.usecounts,
    qp.query_plan
FROM sys.dm_exec_cached_plans AS cp
CROSS APPLY sys.dm_exec_query_plan(cp.plan_handle) AS qp
ORDER BY cp.size_in_bytes DESC;

نکته کاربردی: Plan بزرگ لزوماً بد نیست، اما برای Cache Pressure می‌تواند مهم باشد.

مثال 10: روش امن برای تحلیل محدود

فقط Queryهایی را که بیش از یک بار اجرا شده‌اند وارد تحلیل Plan می‌کنیم.

SELECT TOP (25)
    qs.execution_count,
    qs.total_logical_reads,
    qp.query_plan
FROM sys.dm_exec_query_stats AS qs
CROSS APPLY sys.dm_exec_query_plan(qs.plan_handle) AS qp
WHERE qs.execution_count > 1
ORDER BY qs.total_logical_reads DESC;

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

خطاهای رایج و روش عیب‌یابی

اگر طرح از Plan Cache خارج شده باشد یا Query اصولاً Cache نشده باشد، query_plan می‌تواند NULL شود. همچنین برای Dynamic SQL و UDFها ممکن است لازم باشد plan_handle جداگانه همان بخش را پیدا کنید.

• Handle یا Session قدیمی را بدون کنترل وضعیت فعلی استفاده نکنید.
• خروجی NULL یا خالی را فوراً به‌عنوان خرابی SQL Server تعبیر نکنید؛ ابتدا Lifecycle داده و Permission را بررسی کنید.
• در Queryهای CROSS APPLY روی کل Plan Cache یا همه Sessionها، ابتدا دامنه را با TOP، WHERE و معیارهای Performance محدود کنید.
• برای مقایسه دو Snapshot، زمان جمع‌آوری و Context بار سیستم را ثبت کنید تا تغییرات طبیعی با Regression اشتباه نشود.
• پاک‌سازی Plan Cache، Restart سرویس یا تغییر SET Option را فقط برای «دیدن نتیجه» انجام ندهید؛ این اقدامات می‌توانند اثر سراسری داشته باشند.

ملاحظات Performance و بهینه‌سازی

خود تابع معمولاً سبک است، اما خواندن تعداد زیادی XML بزرگ از Plan Cache می‌تواند مصرف CPU، حافظه و شبکه را افزایش دهد. فیلتر کردن plan_handleها قبل از CROSS APPLY توصیه می‌شود.

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

اگر خروجی شامل XML یا متن بسیار بزرگ است، آن را در هر Poll ذخیره نکنید. می‌توان Hash، اندازه، Handle، زمان و چند متریک کلیدی را ثبت کرد و فقط در صورت عبور از آستانه یا وقوع Incident جزئیات کامل را گرفت. این رویکرد برای داشبوردهای داخلی و سامانه‌های Alerting بسیار مقیاس‌پذیرتر است.

Best Practices برای محیط Production

1. مسئله را با یک معیار قابل اندازه‌گیری تعریف کنید؛ مانند CPU، Duration، Logical Reads، Blocking یا Plan Regression.
2. ابتدا Session یا Query هدف را با یک DMV سبک شناسایی کنید.
3. سپس sys.dm_exec_query_plan را فقط برای همان هدف اجرا کنید و خروجی را همراه Timestamp ذخیره کنید.
4. متن SQL، Database Context، SET Options و پارامترهای مؤثر را تا حد امکان کنار شواهد نگه دارید.
5. قبل از تغییر Index، Hint یا Configuration، فرضیه را در محیط Test با داده نزدیک به Production آزمایش کنید.
6. اسکریپت عیب‌یابی را Version Control کنید تا تغییرات و نتایج قابل بازبینی باشند.

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

کاربرد واقعی در سناریوهای سازمانی

فرض کنید سامانه فروش در ساعات اوج با افزایش ناگهانی زمان پاسخ مواجه شده است. به‌جای Restart یا پاک‌سازی Cache، ابتدا Queryهای فعال و پرهزینه شناسایی می‌شوند، سپس از sys.dm_exec_query_plan برای بازیابی Showplan کامپایل‌شده یک Batch یا Query از روی plan_handle در قالب XML استفاده می‌شود. داده حاصل با Wait Type، Blocking، Query Store و شاخص‌های CPU و I/O تطبیق داده می‌شود.

در یک سناریوی دیگر ممکن است دو Application با Connection Setting متفاوت یک SQL مشابه را اجرا کنند و Planهای متفاوت بسازند. ابزارهای Execution-related به DBA کمک می‌کنند تفاوت Context، Plan و متن را مستند کند و به جای حدس، علت قابل اثبات ارائه دهد.

برای تیم‌های DevOps نیز می‌توان Snapshotهای محدود و زمان‌دار ساخت و هنگام Alert فقط داده‌های ضروری را ثبت کرد. این الگو برای Postmortem بسیار ارزشمند است؛ زیرا چند ساعت بعد از Incident ممکن است Plan از Cache خارج شده یا Session پایان یافته باشد.

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

sys.dm_exec_query_plan دقیقاً چه کاری انجام می‌دهد؟

sys.dm_exec_query_plan برای بازیابی Showplan کامپایل‌شده یک Batch یا Query از روی plan_handle در قالب XML استفاده می‌شود. ارزش اصلی آن زمانی مشخص می‌شود که اطلاعات خام Plan Cache یا Session را با Context مناسب مانند متن SQL، آمار اجرا و وضعیت Request ترکیب کنید. در آموزش‌های حرفه‌ای SQL Server این تابع معمولاً بخشی از یک زنجیره عیب‌یابی است، نه یک Query مستقل.

از کجا ورودی یا Context مناسب برای sys.dm_exec_query_plan را پیدا کنیم؟

plan_handle از نوع varbinary(64) است و معمولاً از sys.dm_exec_cached_plans، sys.dm_exec_query_stats یا sys.dm_exec_requests به دست می‌آید. در عمل بهتر است ورودی را از DMVهای همان لحظه یا Plan Cache به‌صورت پویا استخراج کنید تا Handleهای قدیمی، Session اشتباه یا داده‌های نامعتبر وارد تحلیل نشوند.

آیا استفاده از sys.dm_exec_query_plan برای پروژه‌های سازمانی ارزش دارد؟

بله، مخصوصاً در سامانه‌هایی که کندی Query، Blocking، مصرف CPU یا رفتار Plan Cache باید سریع ریشه‌یابی شود. تیم DBA می‌تواند خروجی را در Runbookها و ابزارهای مانیتورینگ داخلی قرار دهد و در پروژه‌های بهینه‌سازی SQL Server از آن برای مستندسازی شواهد فنی استفاده کند.

در چه شرایطی مشاوره تخصصی برای تحلیل خروجی sys.dm_exec_query_plan مفید است؟

وقتی خروجی با Queryهای پیچیده، Parallelism، Parameter Sensitivity، Plan Cache Bloat یا Incidentهای Production گره می‌خورد، تفسیر صرف یک ستون کافی نیست. مشاوره SQL Server کمک می‌کند داده این ابزار با Wait Stats، Query Store، Indexها و الگوی بار واقعی کنار هم قرار گیرد.

تفاوت sys.dm_exec_query_plan با نگاه کردن ساده به Activity Monitor چیست؟

Activity Monitor یک نمای عمومی و رابط گرافیکی ارائه می‌کند، اما sys.dm_exec_query_plan داده فنی دقیق‌تری برای Queryهای اسکریپتی و اتوماسیون فراهم می‌کند. برای تحلیل قابل تکرار، Queryهای DMV معمولاً شفاف‌تر، قابل ذخیره‌تر و مناسب‌تر برای مقایسه هستند.

چطور یک اسکریپت آماده مبتنی بر sys.dm_exec_query_plan را در محیط واقعی اجرا کنیم؟

ابتدا Permission لازم را بررسی کنید، سپس Query را در محیط آزمایشی یا با فیلتر محدود اجرا کنید و بعد Session، Database یا Planهای هدف را انتخاب کنید. در سرویس‌های حساس بهتر است اسکریپت مانیتورینگ با TOP، شرط زمان و ثبت حداقلی خروجی ساخته شود.

رایج‌ترین خطا هنگام کار با sys.dm_exec_query_plan چیست؟

اگر طرح از Plan Cache خارج شده باشد یا Query اصولاً Cache نشده باشد، query_plan می‌تواند NULL شود. همچنین برای Dynamic SQL و UDFها ممکن است لازم باشد plan_handle جداگانه همان بخش را پیدا کنید. خطای رایج دیگر این است که یک Snapshot را به‌عنوان حقیقت دائمی در نظر بگیریم؛ Plan Cache و وضعیت Session پویا هستند و ممکن است چند ثانیه بعد تغییر کنند.

آیا sys.dm_exec_query_plan می‌تواند روی Performance اثر بگذارد؟

خود تابع معمولاً سبک است، اما خواندن تعداد زیادی XML بزرگ از Plan Cache می‌تواند مصرف CPU، حافظه و شبکه را افزایش دهد. فیلتر کردن plan_handleها قبل از CROSS APPLY توصیه می‌شود. اصل مهم این است که Diagnostic Query هم باید خودش بهینه باشد؛ خواندن بی‌قید حجم زیادی XML، متن یا ردیف‌های Profiling می‌تواند در زمان Incident فشار اضافی ایجاد کند.

Best Practice استفاده از sys.dm_exec_query_plan چیست؟

بهترین روش، شروع از یک سؤال مشخص است: کدام Session، Query یا Plan مشکل دارد؟ سپس کمترین داده لازم را جمع کنید، Timestamp و Context را ثبت کنید، خروجی را با معیارهای دیگر تطبیق دهید و از پاک‌سازی Cache یا تغییر تنظیمات بدون شواهد کافی خودداری کنید.

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

در SQL Server و سرویس‌های ابری مرتبط قابل استفاده است. در SQL Server 2022 و نسخه‌های جدیدتر، دسترسی‌های Performance State برای بسیاری از DMVهای اجرایی اهمیت بیشتری پیدا کرده است. همیشه مستندات نسخه دقیق SQL Server و سطح Permission را بررسی کنید، زیرا نام Permissionها و برخی جزئیات Profiling یا دسترسی DMVها بین نسخه‌ها و سرویس‌های ابری تفاوت دارد.

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

در مصاحبه چگونه کاربرد sys.dm_exec_query_plan را توضیح می‌دهید؟

می‌گویم این ابزار برای بازیابی Showplan کامپایل‌شده یک Batch یا Query از روی plan_handle در قالب XML است و سپس توضیح می‌دهم چگونه آن را با DMVهای مرتبط ترکیب می‌کنم تا از یک شناسه خام به شواهد قابل اقدام برسم.

اگر خروجی sys.dm_exec_query_plan خالی یا NULL باشد چه می‌کنید؟

ابتدا اعتبار Handle یا Session، وجود Query در حال اجرا، وضعیت Plan Cache، Permission و محدودیت نسخه را بررسی می‌کنم؛ سپس از یک منبع جایگزین مانند Query Store، Actual Plan یا Extended Events استفاده می‌کنم.

چطور از سربار مانیتورینگ با sys.dm_exec_query_plan جلوگیری می‌کنید؟

با فیلتر دقیق، TOP، انتخاب بازه زمانی کوتاه، جلوگیری از Polling بی‌وقفه و جمع‌آوری فقط ستون‌های ضروری. در Production هر Diagnostic Query باید با همان دقت Queryهای کسب‌وکار طراحی شود.

چه داده‌هایی را همراه خروجی sys.dm_exec_query_plan ذخیره می‌کنید؟

زمان جمع‌آوری، نام Instance و Database، session_id یا plan_handle مرتبط، متن Query، معیارهای CPU و I/O، Wait Type و توضیح Incident را ذخیره می‌کنم تا تحلیل بعداً قابل بازسازی باشد.

چرا یک Plan یا Snapshot به‌تنهایی برای نتیجه‌گیری کافی نیست؟

زیرا رفتار SQL Server به پارامترها، حجم داده، Statistics، Concurrency، Memory Grant، Waitها و لحظه اجرای Query وابسته است. شواهد باید از چند منبع مستقل کنار هم قرار گیرند.

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

• نسخه SQL Server و Permission لازم را مشخص کرده‌ام.
• Session، Query یا Plan هدف را قبل از جمع‌آوری جزئیات محدود کرده‌ام.
• خروجی را همراه زمان، Database Context و متن SQL ثبت کرده‌ام.
• نتیجه را با حداقل یک منبع دیگر مانند Query Store، Wait Stats یا Actual Plan تطبیق داده‌ام.
• هیچ اقدام پرریسک مانند Clear Cache را بدون دلیل و برنامه Rollback انجام نداده‌ام.
• اسکریپت را طوری نوشته‌ام که در صورت نبود داده یا Permission، رفتار قابل پیش‌بینی داشته باشد.

جمع‌بندی

sys.dm_exec_query_plan یک ابزار تخصصی برای بازیابی Showplan کامپایل‌شده یک Batch یا Query از روی plan_handle در قالب XML است. ارزش واقعی آن در ترکیب با Context و متریک‌های دیگر نمایان می‌شود. با فیلتر هدفمند، ثبت Timestamp، رعایت Permission و تحلیل چندمنبعی می‌توان از آن برای Troubleshooting سریع و مستند در محیط‌های جدی SQL Server استفاده کرد.

برای دیدن ارتباط این ابزار با سایر توابع، مقاله مادر توابع Execution Plan در SQL Server را مطالعه کنید.