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

sys.dm_exec_plan_attributes برای نمایش Attributeهای یک Plan Cache Entry مانند dbid، set_options و Cache Keyها طراحی شده است. این ابزار بخشی از مجموعه 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 و صدور حکم قطعی» جلوگیری می‌کند.

کاربرد شاخص این ابزار: نمایش Attributeهای یک Plan Cache Entry مانند dbid، set_options و Cache Keyها. بنابراین قبل از اجرا مشخص کنید سؤال فنی شما چیست و دقیقاً دنبال کدام Session، Plan یا Query هستید.

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

نحو پایه

SELECT *
FROM sys.dm_exec_plan_attributes(@plan_handle);

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

ورودی plan_handle از نوع varbinary(64) است و معمولاً از sys.dm_exec_cached_plans یا sys.dm_exec_query_stats دریافت می‌شود.

نوع خروجی

سه ستون attribute، value و is_cache_key را برمی‌گرداند. هر ردیف یک ویژگی از Plan را نشان می‌دهد.

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

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

برای تشخیص Plan Cache Bloat، تفاوت SET Options، Database Context و علت وجود چند نسخه از یک Plan بسیار مفید است.

در بسیاری از نسخه‌ها برای مشاهده اطلاعات سراسری 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: مشاهده تمام Attributeهای یک Plan

یک Plan پرتکرار را انتخاب و همه ویژگی‌های آن را نمایش می‌دهیم.

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

SELECT attribute, value, is_cache_key
FROM sys.dm_exec_plan_attributes(@plan_handle)
ORDER BY attribute;

نکته کاربردی: این خروجی مبنای تحلیل Context و Cache Key است.

مثال 2: استخراج dbid از Plan Attributes

فقط Attribute مربوط به دیتابیس را می‌خوانیم.

SELECT TOP (20)
    cp.usecounts,
    CONVERT(int, pa.value) AS dbid
FROM sys.dm_exec_cached_plans AS cp
CROSS APPLY sys.dm_exec_plan_attributes(cp.plan_handle) AS pa
WHERE pa.attribute = 'dbid'
ORDER BY cp.usecounts DESC;

نکته کاربردی: برای Ad hoc Queryها این روش می‌تواند در تعیین Database Context مفید باشد.

مثال 3: بررسی set_options

Planها را همراه مقدار set_options نمایش می‌دهیم.

SELECT TOP (50)
    cp.objtype,
    cp.usecounts,
    CONVERT(int, pa.value) AS set_options
FROM sys.dm_exec_cached_plans AS cp
CROSS APPLY sys.dm_exec_plan_attributes(cp.plan_handle) AS pa
WHERE pa.attribute = 'set_options'
ORDER BY cp.usecounts DESC;

نکته کاربردی: تفاوت SET Options می‌تواند باعث چند نسخه شدن Plan یک Query شود.

مثال 4: نمایش فقط Cache Keyها

Attributeهایی که بخشی از کلید Cache هستند فیلتر می‌شوند.

DECLARE @plan_handle varbinary(64);
SELECT TOP (1) @plan_handle = plan_handle
FROM sys.dm_exec_cached_plans;

SELECT attribute, value
FROM sys.dm_exec_plan_attributes(@plan_handle)
WHERE is_cache_key = 1;

نکته کاربردی: این نما برای فهمیدن اینکه چه چیزی Lookup در Cache را تفکیک می‌کند مفید است.

مثال 5: استخراج sql_handle از Attributes

رابطه Plan و SQL Handle را از Attribute مربوطه می‌خوانیم.

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

SELECT attribute, value
FROM sys.dm_exec_plan_attributes(@plan_handle)
WHERE attribute = 'sql_handle';

نکته کاربردی: برای Trace کردن Plan به متن SQL، این Attribute کاربردی است.

مثال 6: Pivot ویژگی‌های کلیدی

چند Attribute مهم را به یک ردیف برای هر Plan تبدیل می‌کنیم.

SELECT TOP (20)
    cp.plan_handle,
    MAX(CASE WHEN pa.attribute = 'dbid'
             THEN CONVERT(nvarchar(100), pa.value) END) AS dbid,
    MAX(CASE WHEN pa.attribute = 'set_options'
             THEN CONVERT(nvarchar(100), pa.value) END) AS set_options
FROM sys.dm_exec_cached_plans AS cp
CROSS APPLY sys.dm_exec_plan_attributes(cp.plan_handle) AS pa
GROUP BY cp.plan_handle
ORDER BY MAX(cp.usecounts) DESC;

نکته کاربردی: Pivot ساده، مقایسه Planها را در گزارش مدیریتی آسان می‌کند.

مثال 7: پیدا کردن Planهای یک دیتابیس

Attribute dbid را به DB_ID جاری محدود می‌کنیم.

SELECT TOP (100)
    cp.plan_handle,
    cp.usecounts,
    cp.size_in_bytes
FROM sys.dm_exec_cached_plans AS cp
CROSS APPLY sys.dm_exec_plan_attributes(cp.plan_handle) AS pa
WHERE pa.attribute = 'dbid'
  AND CONVERT(int, pa.value) = DB_ID()
ORDER BY cp.size_in_bytes DESC;

نکته کاربردی: این روش برای تحلیل Cache در یک Database Context خاص مفید است.

مثال 8: مقایسه Planهای هم‌متن با SET Options متفاوت

متن SQL، Plan Handle و set_options را کنار هم می‌آوریم.

SELECT TOP (100)
    st.text,
    qs.plan_handle,
    CONVERT(int, pa.value) AS set_options
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_plan_attributes(qs.plan_handle) AS pa
WHERE pa.attribute = 'set_options'
ORDER BY st.text, set_options;

نکته کاربردی: برای تشخیص Plan Cache Bloat ناشی از تنظیمات Session بسیار مهم است.

مثال 9: بررسی Attributeهای Execution Context

ویژگی‌های مرتبط با reuse و context را جدا می‌کنیم.

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

SELECT attribute, value
FROM sys.dm_exec_plan_attributes(@plan_handle)
WHERE attribute IN
(
    'inuse_exec_context',
    'free_exec_context',
    'hits_exec_context',
    'misses_exec_context'
);

نکته کاربردی: این شمارنده‌ها دیدی از Reuse Execution Context می‌دهند.

مثال 10: فیلتر قبل از CROSS APPLY برای کارایی

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

WITH TargetPlans AS
(
    SELECT TOP (25)
        plan_handle,
        usecounts,
        size_in_bytes
    FROM sys.dm_exec_cached_plans
    WHERE usecounts > 5
    ORDER BY size_in_bytes DESC
)
SELECT
    tp.usecounts,
    tp.size_in_bytes,
    pa.attribute,
    pa.value
FROM TargetPlans AS tp
CROSS APPLY sys.dm_exec_plan_attributes(tp.plan_handle) AS pa;

نکته کاربردی: این الگو نسبت به Apply روی کل Cache کنترل‌شده‌تر است.

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

مقادیر value از نوع sql_variant هستند و برای مقایسه یا تبدیل باید نوع داده را درست مدیریت کنید. تفسیر set_options نیز نیازمند شناخت Bitmaskها است.

• 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 و بهینه‌سازی

روی یک plan_handle کم‌هزینه است. در تحلیل Cache وسیع، بهتر است ابتدا Planهای تکراری یا پرمصرف را محدود و سپس Attributeهای آنها را بررسی کنید.

برای ابزارهای مانیتورینگ سازمانی یک الگوی دو مرحله‌ای مناسب است: مرحله اول 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_plan_attributes را فقط برای همان هدف اجرا کنید و خروجی را همراه 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_plan_attributes برای نمایش Attributeهای یک Plan Cache Entry مانند dbid، set_options و Cache Keyها استفاده می‌شود. داده حاصل با 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_plan_attributes دقیقاً چه کاری انجام می‌دهد؟

sys.dm_exec_plan_attributes برای نمایش Attributeهای یک Plan Cache Entry مانند dbid، set_options و Cache Keyها استفاده می‌شود. ارزش اصلی آن زمانی مشخص می‌شود که اطلاعات خام Plan Cache یا Session را با Context مناسب مانند متن SQL، آمار اجرا و وضعیت Request ترکیب کنید. در آموزش‌های حرفه‌ای SQL Server این تابع معمولاً بخشی از یک زنجیره عیب‌یابی است، نه یک Query مستقل.

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

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

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

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

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

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

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

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

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

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

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

مقادیر value از نوع sql_variant هستند و برای مقایسه یا تبدیل باید نوع داده را درست مدیریت کنید. تفسیر set_options نیز نیازمند شناخت Bitmaskها است. خطای رایج دیگر این است که یک Snapshot را به‌عنوان حقیقت دائمی در نظر بگیریم؛ Plan Cache و وضعیت Session پویا هستند و ممکن است چند ثانیه بعد تغییر کنند.

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

روی یک plan_handle کم‌هزینه است. در تحلیل Cache وسیع، بهتر است ابتدا Planهای تکراری یا پرمصرف را محدود و سپس Attributeهای آنها را بررسی کنید. اصل مهم این است که Diagnostic Query هم باید خودش بهینه باشد؛ خواندن بی‌قید حجم زیادی XML، متن یا ردیف‌های Profiling می‌تواند در زمان Incident فشار اضافی ایجاد کند.

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

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

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

برای تشخیص Plan Cache Bloat، تفاوت SET Options، Database Context و علت وجود چند نسخه از یک Plan بسیار مفید است. همیشه مستندات نسخه دقیق SQL Server و سطح Permission را بررسی کنید، زیرا نام Permissionها و برخی جزئیات Profiling یا دسترسی DMVها بین نسخه‌ها و سرویس‌های ابری تفاوت دارد.

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

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

می‌گویم این ابزار برای نمایش Attributeهای یک Plan Cache Entry مانند dbid، set_options و Cache Keyها است و سپس توضیح می‌دهم چگونه آن را با DMVهای مرتبط ترکیب می‌کنم تا از یک شناسه خام به شواهد قابل اقدام برسم.

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

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

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

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

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

زمان جمع‌آوری، نام 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_plan_attributes یک ابزار تخصصی برای نمایش Attributeهای یک Plan Cache Entry مانند dbid، set_options و Cache Keyها است. ارزش واقعی آن در ترکیب با Context و متریک‌های دیگر نمایان می‌شود. با فیلتر هدفمند، ثبت Timestamp، رعایت Permission و تحلیل چندمنبعی می‌توان از آن برای Troubleshooting سریع و مستند در محیط‌های جدی SQL Server استفاده کرد.

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