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

sys.dm_exec_input_buffer برای نمایش آخرین دستور یا Input Buffer ارسال‌شده برای یک Session و Request طراحی شده است. این ابزار بخشی از مجموعه 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 و صدور حکم قطعی» جلوگیری می‌کند.

کاربرد شاخص این ابزار: نمایش آخرین دستور یا Input Buffer ارسال‌شده برای یک Session و Request. بنابراین قبل از اجرا مشخص کنید سؤال فنی شما چیست و دقیقاً دنبال کدام Session، Plan یا Query هستید.

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

نحو پایه

SELECT *
FROM sys.dm_exec_input_buffer(@session_id, @request_id);

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

session_id شناسه نشست و request_id شناسه درخواست است. در بسیاری از سناریوها request_id برابر 0 یا NULL استفاده می‌شود.

نوع خروجی

ستون‌های event_type، parameters و event_info را برمی‌گرداند. event_info متن آخرین فرمان یا Batch قابل مشاهده برای Session است.

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

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

برای تحلیل Sessionها، Blocking و بررسی اینکه یک اتصال چه فرمانی ارسال کرده بسیار مناسب است. می‌توان آن را با sys.dm_exec_sessions و sys.dm_exec_requests ترکیب کرد.

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

ساده‌ترین حالت، خواندن آخرین فرمان Session فعلی است.

SELECT *
FROM sys.dm_exec_input_buffer(@@SPID, NULL);

نکته کاربردی: برای تست Permission و آشنایی با خروجی بهترین نقطه شروع است.

مثال 2: Input Buffer همه Sessionهای کاربری

تابع را با sys.dm_exec_sessions و CROSS APPLY ترکیب می‌کنیم.

SELECT
    s.session_id,
    s.login_name,
    ib.event_type,
    ib.event_info
FROM sys.dm_exec_sessions AS s
CROSS APPLY sys.dm_exec_input_buffer(s.session_id, NULL) AS ib
WHERE s.is_user_process = 1;

نکته کاربردی: فیلتر is_user_process نویز Sessionهای سیستمی را کم می‌کند.

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

فقط Requestهای جاری را بررسی می‌کنیم.

SELECT
    r.session_id,
    r.status,
    r.command,
    ib.event_info
FROM sys.dm_exec_requests AS r
CROSS APPLY sys.dm_exec_input_buffer(r.session_id, r.request_id) AS ib
WHERE r.session_id <> @@SPID;

نکته کاربردی: این روش برای Incidentهای زنده مناسب‌تر از بررسی همه Sessionها است.

مثال 4: تحلیل Blocking Chain

فرمان Sessionهای Blocked را در کنار Blocking Session نشان می‌دهیم.

SELECT
    r.session_id,
    r.blocking_session_id,
    r.wait_type,
    ib.event_info
FROM sys.dm_exec_requests AS r
CROSS APPLY sys.dm_exec_input_buffer(r.session_id, r.request_id) AS ib
WHERE r.blocking_session_id > 0;

نکته کاربردی: متن Buffer کمک می‌کند بدانیم Session منتظر چه Batchی ارسال کرده است.

مثال 5: استفاده با Session متغیر

به‌جای عدد ثابت، Session هدف را با متغیر کنترل می‌کنیم.

DECLARE @session_id smallint = @@SPID;

SELECT event_type, parameters, event_info
FROM sys.dm_exec_input_buffer(@session_id, NULL);

نکته کاربردی: این الگو برای Stored Procedureهای عیب‌یابی قابل استفاده مجدد است.

مثال 6: شمارش انواع Event

خروجی Buffer چند Session را بر اساس event_type خلاصه می‌کنیم.

SELECT
    ib.event_type,
    COUNT(*) AS session_count
FROM sys.dm_exec_sessions AS s
CROSS APPLY sys.dm_exec_input_buffer(s.session_id, NULL) AS ib
WHERE s.is_user_process = 1
GROUP BY ib.event_type
ORDER BY session_count DESC;

نکته کاربردی: این گزارش دید کلی از نوع بار ارسالی Clientها می‌دهد.

مثال 7: بررسی Sessionهای Sleeping

آخرین فرمان Sessionهای Sleeping را می‌خوانیم.

SELECT TOP (50)
    s.session_id,
    s.status,
    s.program_name,
    ib.event_info
FROM sys.dm_exec_sessions AS s
CROSS APPLY sys.dm_exec_input_buffer(s.session_id, NULL) AS ib
WHERE s.is_user_process = 1
  AND s.status = N'sleeping'
ORDER BY s.last_request_end_time DESC;

نکته کاربردی: برای Connection Pool و Last Command مفید است، اما به معنی Query فعال نیست.

مثال 8: ترکیب با اطلاعات Login و Host

Buffer را با Context اتصال تکمیل می‌کنیم.

SELECT TOP (100)
    s.session_id,
    s.login_name,
    s.host_name,
    s.program_name,
    ib.event_info
FROM sys.dm_exec_sessions AS s
CROSS APPLY sys.dm_exec_input_buffer(s.session_id, NULL) AS ib
WHERE s.is_user_process = 1
ORDER BY s.session_id;

نکته کاربردی: برای پیدا کردن منبع Application یک Query مزاحم بسیار کاربردی است.

مثال 9: محدود کردن متن‌های طولانی در گزارش

برای داشبورد مانیتورینگ فقط ابتدای event_info را نمایش می‌دهیم.

SELECT
    s.session_id,
    LEFT(ib.event_info, 300) AS event_info_preview
FROM sys.dm_exec_sessions AS s
CROSS APPLY sys.dm_exec_input_buffer(s.session_id, NULL) AS ib
WHERE s.is_user_process = 1;

نکته کاربردی: کاهش طول متن برای داشبورد مفید است و از انتقال داده غیرضروری جلوگیری می‌کند.

مثال 10: تمرکز روی Sessionهای طولانی

فقط Requestهایی با زمان اجرای قابل توجه را به Buffer می‌فرستیم.

SELECT
    r.session_id,
    r.total_elapsed_time,
    ib.event_info
FROM sys.dm_exec_requests AS r
CROSS APPLY sys.dm_exec_input_buffer(r.session_id, r.request_id) AS ib
WHERE r.session_id <> @@SPID
  AND r.total_elapsed_time >= 5000
ORDER BY r.total_elapsed_time DESC;

نکته کاربردی: این فیلتر سربار مانیتورینگ را کم و تمرکز را روی Queryهای مهم حفظ می‌کند.

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

Input Buffer الزاماً همان Statement دقیق در حال اجرا نیست و ممکن است کل Batch یا آخرین فرمان ارسال‌شده را نشان دهد. محدودیت‌های Permission نیز باید در نظر گرفته شوند.

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

برای یک Session بسیار سبک است، اما CROSS APPLY روی همه Sessionها در سرورهای بسیار شلوغ بهتر است با فیلتر is_user_process و وضعیت Session محدود شود.

برای ابزارهای مانیتورینگ سازمانی یک الگوی دو مرحله‌ای مناسب است: مرحله اول 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_input_buffer را فقط برای همان هدف اجرا کنید و خروجی را همراه 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_input_buffer برای نمایش آخرین دستور یا Input Buffer ارسال‌شده برای یک Session و Request استفاده می‌شود. داده حاصل با 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_input_buffer دقیقاً چه کاری انجام می‌دهد؟

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

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

session_id شناسه نشست و request_id شناسه درخواست است. در بسیاری از سناریوها request_id برابر 0 یا NULL استفاده می‌شود. در عمل بهتر است ورودی را از DMVهای همان لحظه یا Plan Cache به‌صورت پویا استخراج کنید تا Handleهای قدیمی، Session اشتباه یا داده‌های نامعتبر وارد تحلیل نشوند.

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

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

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

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

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

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

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

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

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

Input Buffer الزاماً همان Statement دقیق در حال اجرا نیست و ممکن است کل Batch یا آخرین فرمان ارسال‌شده را نشان دهد. محدودیت‌های Permission نیز باید در نظر گرفته شوند. خطای رایج دیگر این است که یک Snapshot را به‌عنوان حقیقت دائمی در نظر بگیریم؛ Plan Cache و وضعیت Session پویا هستند و ممکن است چند ثانیه بعد تغییر کنند.

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

برای یک Session بسیار سبک است، اما CROSS APPLY روی همه Sessionها در سرورهای بسیار شلوغ بهتر است با فیلتر is_user_process و وضعیت Session محدود شود. اصل مهم این است که Diagnostic Query هم باید خودش بهینه باشد؛ خواندن بی‌قید حجم زیادی XML، متن یا ردیف‌های Profiling می‌تواند در زمان Incident فشار اضافی ایجاد کند.

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

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

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

برای تحلیل Sessionها، Blocking و بررسی اینکه یک اتصال چه فرمانی ارسال کرده بسیار مناسب است. می‌توان آن را با sys.dm_exec_sessions و sys.dm_exec_requests ترکیب کرد. همیشه مستندات نسخه دقیق SQL Server و سطح Permission را بررسی کنید، زیرا نام Permissionها و برخی جزئیات Profiling یا دسترسی DMVها بین نسخه‌ها و سرویس‌های ابری تفاوت دارد.

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

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

می‌گویم این ابزار برای نمایش آخرین دستور یا Input Buffer ارسال‌شده برای یک Session و Request است و سپس توضیح می‌دهم چگونه آن را با DMVهای مرتبط ترکیب می‌کنم تا از یک شناسه خام به شواهد قابل اقدام برسم.

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

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

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

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

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

زمان جمع‌آوری، نام 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_input_buffer یک ابزار تخصصی برای نمایش آخرین دستور یا Input Buffer ارسال‌شده برای یک Session و Request است. ارزش واقعی آن در ترکیب با Context و متریک‌های دیگر نمایان می‌شود. با فیلتر هدفمند، ثبت Timestamp، رعایت Permission و تحلیل چندمنبعی می‌توان از آن برای Troubleshooting سریع و مستند در محیط‌های جدی SQL Server استفاده کرد.

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