کنترل Parameter Sniffing در SQL Server؛ آموزش کامل PARAMETER_SNIFFING در SQL Server

Parameter Sniffing نه باگ است و نه چیزی که همیشه باید خاموش شود. مشکل وقتی رخ می‌دهد که یک Plan ذخیره‌شده برای دامنه بزرگی از پارامترها مناسب نباشد.

Parameter Sniffing معمولاً مفید است چون Plan را با مقدار واقعی Compile می‌کند، اما در داده‌های بسیار نامتوازن یک Plan ذخیره‌شده ممکن است نماینده همه پارامترها نباشد. خاموش‌کردن سراسری باید آخرین انتخاب باشد. در این مقاله از Syntax و خواندن مقدار فعلی شروع می‌کنیم و بعد به سناریوی واقعی، روش اندازه‌گیری، خطاهای رایج و تصمیم Production می‌رسیم.

برای دیدن ارتباط این گزینه با سایر تنظیمات، راهنمای جامع Database Scoped Performance Configuration را هم ببینید.

تعریف و منطق فنی

کنترل استفاده Optimizer از مقدار پارامتر زمان Compile برای ساخت Plan در سطح Database.

Parameter Sniffing معمولاً مفید است چون Plan را با مقدار واقعی Compile می‌کند، اما در داده‌های بسیار نامتوازن یک Plan ذخیره‌شده ممکن است نماینده همه پارامترها نباشد. خاموش‌کردن سراسری باید آخرین انتخاب باشد.

اصل عملی: تنظیم Performance فقط وقتی ارزش دارد که مسئله، معیار موفقیت و راه برگشت آن از قبل روشن باشد.

Syntax اصلی

ALTER DATABASE SCOPED CONFIGURATION SET PARAMETER_SNIFFING = ON;

مقادیر و رفتار

• مقدار یا فرمان: ON یا OFF.
• سناریوی مناسب: Stored Procedure گزارش سفارش‌ها برای مشتری کم‌سفارش و مشتری بسیار پرتراکنش
• ریسک اصلی: OFF کردن سراسری می‌تواند Plan عمومی و متوسط بسازد؛ ON بودن هم در داده Skewed ممکن است Plan ناپایدار ایجاد کند.
• نکته نسخه: این تنظیم رفتار Parameter Sniffing را در سطح Database کنترل می‌کند؛ برای مشکل محدود، Query Store Hint، RECOMPILE یا بازنویسی دقیق‌تر است.

این نقشه رابطه PARAMETER_SNIFFING را با Compile Value، Plan Cache و شاخص‌های Runtime نشان می‌دهد. تصویر برای فهم دامنه اثر است و جای Execution Plan واقعی را نمی‌گیرد.

چطور قبل از تغییر تصمیم بگیریم

قبل از اجرای تغییر، Queryهای نماینده را بر اساس اهمیت تجاری و مصرف منابع جدا کنید. Plan آنها را در Query Store نگه دارید و فقط یک متغیر را تغییر دهید. اگر هم‌زمان Index، Compatibility Level و PARAMETER_SNIFFING را عوض کنید، Attribution نتیجه از بین می‌رود.

معیار تک Query و معیار کل Workload را جدا ببینید. ممکن است یک Query سریع‌تر شود اما Throughput کل افت کند. OFF کردن سراسری می‌تواند Plan عمومی و متوسط بسازد؛ ON بودن هم در داده Skewed ممکن است Plan ناپایدار ایجاد کند. به همین دلیل Concurrency و مصرف منابع باید کنار زمان پاسخ سنجیده شود.

اشتباه رایج: استفاده از OFF به‌عنوان درمان عمومی کندی Stored Procedureها بدون ثبت Planها و توزیع واقعی داده. راه حرفه‌ای این است که فرضیه، Baseline، Change و Rollback در یک سند کوتاه و قابل بازبینی ثبت شوند.

جریان PARAMETER_SNIFFING از مشاهده وضعیت، اعمال Change، Compile یا Runtime Behavior و سپس Measure عبور می‌کند. نقاط اندازه‌گیری قبل و بعد باید یکسان باشند.

۱۰ مثال عملی و قابل اجرا

SELECT name, value, value_for_secondary
FROM sys.database_scoped_configurations
WHERE name = N'PARAMETER_SNIFFING';

ALTER DATABASE SCOPED CONFIGURATION SET PARAMETER_SNIFFING = ON;

ALTER DATABASE SCOPED CONFIGURATION SET PARAMETER_SNIFFING = OFF;

SELECT DB_NAME() AS DatabaseName, compatibility_level
FROM sys.databases
WHERE database_id = DB_ID();

SELECT TOP (20) qsq.query_id, qsp.plan_id, rs.avg_duration, rs.avg_cpu_time
FROM sys.query_store_query AS qsq
JOIN sys.query_store_plan AS qsp ON qsp.query_id = qsq.query_id
JOIN sys.query_store_runtime_stats AS rs ON rs.plan_id = qsp.plan_id
ORDER BY rs.avg_duration DESC;

CREATE OR ALTER PROCEDURE dbo.usp_OrderLookup @ObjectType char(2)
AS
BEGIN
    SELECT object_id,name,type_desc FROM sys.objects WHERE type=@ObjectType;
END;

SELECT counter_name, cntr_value
FROM sys.dm_os_performance_counters
WHERE object_name LIKE N'%SQL Statistics%'
  AND counter_name IN (N'Batch Requests/sec',N'SQL Compilations/sec',N'SQL Re-Compilations/sec');

SELECT TOP (20) qs.execution_count, qs.total_worker_time, qs.total_elapsed_time,
       SUBSTRING(st.text,1,300) AS sample_sql
FROM sys.dm_exec_query_stats AS qs
CROSS APPLY sys.dm_exec_sql_text(qs.sql_handle) AS st
ORDER BY qs.total_worker_time DESC;

IF CAST(SERVERPROPERTY('ProductMajorVersion') AS int) >= 13
BEGIN
    ALTER DATABASE SCOPED CONFIGURATION SET PARAMETER_SNIFFING = ON;
END
ELSE
    THROW 50010, N'نسخه موتور برای این Deployment بررسی شود.', 1;

-- Rollback کنترل‌شده
ALTER DATABASE SCOPED CONFIGURATION SET PARAMETER_SNIFFING = OFF;
SELECT name, value, value_for_secondary
FROM sys.database_scoped_configurations
WHERE name = N'PARAMETER_SNIFFING';

خطاهای رایج

• استفاده از OFF به‌عنوان درمان عمومی کندی Stored Procedureها بدون ثبت Planها و توزیع واقعی داده.
• اعمال چند تغییر Performance در یک Release و از دست دادن امکان تشخیص علت.
• مقایسه Warm Cache با Cold Cache و نتیجه‌گیری قطعی.
• نادیده گرفتن تفاوت نسخه، CU و Compatibility Level بین Test و Production.
• تمرکز فقط روی Duration و ندیدن CPU، Reads، Memory، Spill، Blocking یا Throughput.

Performance Considerations

اثر PARAMETER_SNIFFING را با Metric همان Feature بسنجید. مفاهیم کلیدی این مقاله: Parameter Sniffing, Compile Value, Plan Cache, Skew, Stored Procedure. اگر معیار انتخابی با این زنجیره ارتباطی ندارد، آزمایش ممکن است نتیجه گمراه‌کننده بدهد.

OFF کردن سراسری می‌تواند Plan عمومی و متوسط بسازد؛ ON بودن هم در داده Skewed ممکن است Plan ناپایدار ایجاد کند. این ریسک دلیل طراحی آزمایش بهتر است، نه دلیل تصمیم عجولانه. Query Store، Actual Plan و DMVهای Runtime را کنار هم ببینید.

بهترین روش‌ها

1. مقدار فعلی، نسخه Engine و Compatibility Level را ثبت کنید.
2. Baseline Queryهای حیاتی را بگیرید.
3. تغییر را ابتدا در محیط مشابه Production یا بازه کم‌ریسک اجرا کنید.
4. فقط یک متغیر Performance را عوض کنید.
5. Rollback را پیش از Deployment بنویسید.
6. Plan و Runtime را در چند بازه بررسی کنید.
7. اگر نتیجه مبهم است تغییر را دائمی نکنید.

سناریوی عملی PARAMETER_SNIFFING سه بخش دارد: Baseline، تغییر کنترل‌شده و تصمیم بر اساس Measure. حذف هر کدام کیفیت تصمیم را پایین می‌آورد.

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

PARAMETER_SNIFFING دقیقاً چه مشکلی را هدف می‌گیرد؟

برای کنترل استفاده Optimizer از مقدار پارامتر زمان Compile برای ساخت Plan در سطح Database طراحی شده است. ارزش آن زمانی روشن می‌شود که قبل از تغییر Baseline داشته باشید و اثر را روی Workload واقعی بسنجید.

مقدار فعلی PARAMETER_SNIFFING را چگونه ببینیم؟

از sys.database_scoped_configurations شروع کنید و خروجی را کنار نسخه Engine، Compatibility Level و وضعیت Query Store ثبت کنید.

آیا PARAMETER_SNIFFING همیشه SQL Server را سریع‌تر می‌کند؟

خیر. OFF کردن سراسری می‌تواند Plan عمومی و متوسط بسازد؛ ON بودن هم در داده Skewed ممکن است Plan ناپایدار ایجاد کند. بنابراین CPU، Duration، Reads و Metric مرتبط با Feature باید قبل و بعد مقایسه شوند.

چه سناریوی تجاری برای PARAMETER_SNIFFING مناسب است؟

نمونه روشن: Stored Procedure گزارش سفارش‌ها برای مشتری کم‌سفارش و مشتری بسیار پرتراکنش. در پروژه واقعی Change Window، Rollback و معیار موفقیت را قبل از تغییر تعریف کنید.

PARAMETER_SNIFFING چه تفاوتی با تنظیم سراسری دارد؟

Database Scoped Configuration دامنه اثر را محدودتر می‌کند و برای Instanceهای چند Workload کنترل دقیق‌تری می‌دهد؛ با این حال Hintهای Query و تنظیمات دیگر ممکن است رفتار نهایی را تغییر دهند.

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

بررسی Query Store، Execution Plan، Baseline، تست بار و Rollback. آموزش و مشاوره زمانی مفید است که تصمیم بر اساس داده همان سامانه گرفته شود.

رایج‌ترین خطا درباره PARAMETER_SNIFFING چیست؟

استفاده از OFF به‌عنوان درمان عمومی کندی Stored Procedureها بدون ثبت Planها و توزیع واقعی داده. این کار اغلب یک درمان موقت را به سیاست دائمی تبدیل می‌کند.

اثر Performance PARAMETER_SNIFFING را چگونه بسنجیم؟

بازه‌های هم‌سطح را مقایسه کنید و CPU، Duration، Reads و Metric تخصصی Feature را بسنجید. Query Store برای Plan Regression بسیار مفید است.

Best Practice تغییر PARAMETER_SNIFFING چیست؟

تغییر را کوچک، مستند و قابل برگشت نگه دارید؛ فقط یک متغیر Performance را در هر آزمایش عوض کنید و نتیجه را چند بار بسنجید.

PARAMETER_SNIFFING با چه نسخه‌هایی سازگار است؟

این تنظیم رفتار Parameter Sniffing را در سطح Database کنترل می‌کند؛ برای مشکل محدود، Query Store Hint، RECOMPILE یا بازنویسی دقیق‌تر است. مستندات همان نسخه و Compatibility Level محیط خود را ملاک نهایی قرار دهید.

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

1. چرا برای PARAMETER_SNIFFING Baseline لازم است؟
2. اگر بعد از تغییر PARAMETER_SNIFFING یک Query بهتر و چند Query بدتر شوند چه می‌کنید؟
3. Query Store در ارزیابی کنترل Parameter Sniffing در SQL Server چه نقشی دارد؟
4. چطور مشکل Statistics را از اثر PARAMETER_SNIFFING جدا می‌کنید؟
5. Rollback شما برای PARAMETER_SNIFFING در Production چیست؟

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

• مقدار فعلی PARAMETER_SNIFFING ثبت شده است.
• Baseline مشخص است.
• نسخه و Compatibility Level کنترل شده‌اند.
• معیار موفقیت و شکست نوشته شده‌اند.
• Rollback آماده است.
• Query Store و Planهای مهم بعد از تغییر بررسی می‌شوند.

جمع‌بندی

کنترل Parameter Sniffing در SQL Server زمانی مفید است که با مسئله واقعی و قابل اندازه‌گیری استفاده شود. کنترل استفاده Optimizer از مقدار پارامتر زمان Compile برای ساخت Plan در سطح Database. به‌جای تغییر بر اساس توصیه عمومی، Workload خودتان را بسنجید و تغییر را قابل برگشت نگه دارید.

برای مقایسه این گزینه با سایر اعضای همین خانواده به مقاله مادر تنظیمات Performance در سطح Database برگردید.