مسئله‌ای که این دستور حل می‌کند

وقتی یک نشست Extended Events فقط در حد تعریف باقی نماند و قرار باشد در چرخه استقرار، عیب‌یابی و نگهداری استفاده شود، شناخت دقیق STATE = STOP ضروری است. این مقاله مسئله عملی «برای پایان پنجره عیب‌یابی، تغییر امن اجزا یا کنترل هزینه استفاده می‌شود.» را از دید SQL Server بررسی می‌کند و تفاوت Metadata با وضعیت Runtime را روشن نگه می‌دارد.

پیش‌نیاز مطالعه، آشنایی پایه با Event، Action، Predicate و Target است. در پایان می‌توانید Syntax را درست بنویسید، نتیجه را از Catalog یا DMV کنترل کنید، خطاهای رایج را پیش از اجرا تشخیص دهید و اثر Performance را متناسب با state-stop بسنجید.

برای دیدن جایگاه این دستور در کل چرخه، راهنمای جامع دستورات Extended Events را نیز در دسترس داشته باشید؛ این صفحه روی جزئیات مستقل همین Topic تمرکز می‌کند.

دسترسی سریع

1. تعریف و جایگاه
2. نحو و اجزا
3. ده مثال عملی
4. کارایی و خطاها
5. پرسش‌های تکمیلی

تعریف و جایگاه فنی

STATE = STOP جمع‌آوری Runtime یک Session را متوقف می‌کند، در حالی که تعریف آن در Catalog باقی می‌ماند.

برای پایان پنجره عیب‌یابی، تغییر امن اجزا یا کنترل هزینه استفاده می‌شود.

در معماری Extended Events، این Topic در گروه «state-stop» قرار می‌گیرد. تصمیم درباره Scope، وضعیت Session و مقصد داده باید قبل از اجرا روشن باشد؛ زیرا موفقیت DDL لزوماً به معنی دریافت داده قابل استفاده نیست.

Syntax، پارامترها و رفتار خروجی

Syntax استاندارد

ALTER EVENT SESSION [SessionName]
ON SERVER
STATE = STOP;

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

• SessionName باید در Catalog موجود باشد.
• اگر Session فعال نباشد، اجرای بی‌محابای Stop می‌تواند خطای عملیاتی یا رفتار وابسته به نسخه ایجاد کند؛ Runtime را کنترل کنید.
• پس از Stop می‌توان داده Target را با ثبات بیشتری استخراج کرد.

Return Type، NULL و سازگاری

Result Set ندارد؛ ردیف Runtime از sys.dm_xe_sessions حذف می‌شود ولی Metadata در sys.server_event_sessions می‌ماند.

این یک دستور DDL یا عبارت کنترلی است و Return Type تابعی ندارد؛ بنابراین رفتار NULL فقط در Predicateها، SET valueها یا Queryهای کنترلی اطراف آن مطرح می‌شود. Scopeهای Server و Database، نام DMVها و دسترسی‌های لازم می‌توانند بین نسخه‌ها و سرویس‌های Azure تفاوت داشته باشند؛ قبل از انتقال اسکریپت، مستندات نسخه مقصد و sys.dm_xe_objects همان Instance را کنترل کنید.

منطق اجرا و نکات فنی

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

مثال 1: Stop ساده

سناریو: در این مرحله هدف، Stop ساده برای Session نمونه است. Query عمداً کامل نوشته شده تا بتوان آن را در محیط آزمایشی اجرا یا با نام واقعی جایگزین کرد.

ALTER EVENT SESSION [XE_Article_Demo] ON SERVER
STATE = STOP;
GO

این مثال روی جنبه «Stop ساده» تمرکز دارد. در محیط واقعی نام Session، مسیر فایل، Scope و سطح دسترسی را با استاندارد استقرار خود هماهنگ کنید.

مثال 2: Stop Idempotent

سناریو: در این مرحله هدف، Stop Idempotent برای Session نمونه است. Query عمداً کامل نوشته شده تا بتوان آن را در محیط آزمایشی اجرا یا با نام واقعی جایگزین کرد.

IF EXISTS (SELECT 1 FROM sys.dm_xe_sessions WHERE name=N'XE_Article_Demo')
    ALTER EVENT SESSION [XE_Article_Demo] ON SERVER STATE=STOP;
GO

این مثال روی جنبه «Stop Idempotent» تمرکز دارد. در محیط واقعی نام Session، مسیر فایل، Scope و سطح دسترسی را با استاندارد استقرار خود هماهنگ کنید.

مثال 3: کنترل خروج از Runtime

سناریو: در این مرحله هدف، کنترل خروج از Runtime برای Session نمونه است. Query عمداً کامل نوشته شده تا بتوان آن را در محیط آزمایشی اجرا یا با نام واقعی جایگزین کرد.

SELECT s.name, s.create_time, t.target_name
FROM sys.dm_xe_sessions AS s
LEFT JOIN sys.dm_xe_session_targets AS t
  ON t.event_session_address = s.address
WHERE s.name = N'XE_Article_Demo';

این مثال روی جنبه «کنترل خروج از Runtime» تمرکز دارد. در محیط واقعی نام Session، مسیر فایل، Scope و سطح دسترسی را با استاندارد استقرار خود هماهنگ کنید.

مثال 4: Stop نشست Database-scoped

سناریو: در این مرحله هدف، Stop نشست Database-scoped برای Session نمونه است. Query عمداً کامل نوشته شده تا بتوان آن را در محیط آزمایشی اجرا یا با نام واقعی جایگزین کرد.

ALTER EVENT SESSION [XE_DbScope] ON DATABASE
STATE = STOP;
GO

این مثال روی جنبه «Stop نشست Database-scoped» تمرکز دارد. در محیط واقعی نام Session، مسیر فایل، Scope و سطح دسترسی را با استاندارد استقرار خود هماهنگ کنید.

مثال 5: توقف بعد از بازتولید

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

IF EXISTS (SELECT 1 FROM sys.dm_xe_sessions WHERE name=N'XE_Incident')
    ALTER EVENT SESSION [XE_Incident] ON SERVER STATE=STOP;
GO

این مثال روی جنبه «توقف بعد از بازتولید» تمرکز دارد. در محیط واقعی نام Session، مسیر فایل، Scope و سطح دسترسی را با استاندارد استقرار خود هماهنگ کنید.

مثال 6: ثبت آخرین شمارنده‌ها

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

SELECT name, buffered_event_count, dropped_event_count, largest_event_dropped_size
FROM sys.dm_xe_sessions
WHERE name=N'XE_Article_Demo';

این مثال روی جنبه «ثبت آخرین شمارنده‌ها» تمرکز دارد. در محیط واقعی نام Session، مسیر فایل، Scope و سطح دسترسی را با استاندارد استقرار خود هماهنگ کنید.

مثال 7: خواندن فایل بعد از Stop

سناریو: در این مرحله هدف، خواندن فایل بعد از Stop برای Session نمونه است. Query عمداً کامل نوشته شده تا بتوان آن را در محیط آزمایشی اجرا یا با نام واقعی جایگزین کرد.

SELECT object_name, timestamp_utc, event_data
FROM sys.fn_xe_file_target_read_file(N'D:\SqlData\XE\Article*.xel', NULL, NULL, NULL)
ORDER BY timestamp_utc DESC;

این مثال روی جنبه «خواندن فایل بعد از Stop» تمرکز دارد. در محیط واقعی نام Session، مسیر فایل، Scope و سطح دسترسی را با استاندارد استقرار خود هماهنگ کنید.

مثال 8: Stop برای ALTER ساختاری

سناریو: در این مرحله هدف، Stop برای ALTER ساختاری برای Session نمونه است. Query عمداً کامل نوشته شده تا بتوان آن را در محیط آزمایشی اجرا یا با نام واقعی جایگزین کرد.

ALTER EVENT SESSION [XE_Article_Demo] ON SERVER STATE=STOP;
ALTER EVENT SESSION [XE_Article_Demo] ON SERVER ADD EVENT sqlserver.attention;
ALTER EVENT SESSION [XE_Article_Demo] ON SERVER STATE=START;
GO

این مثال روی جنبه «Stop برای ALTER ساختاری» تمرکز دارد. در محیط واقعی نام Session، مسیر فایل، Scope و سطح دسترسی را با استاندارد استقرار خود هماهنگ کنید.

مثال 9: روش اشتباه و اصلاح

سناریو: در این مرحله هدف، روش اشتباه و اصلاح برای Session نمونه است. Query عمداً کامل نوشته شده تا بتوان آن را در محیط آزمایشی اجرا یا با نام واقعی جایگزین کرد.

-- اشتباه: توقف نشست Audit حیاتی بدون هماهنگی
-- اصلاح: ابتدا وابستگی Alert، مالک سرویس و برنامه Start مجدد را ثبت کنید.
IF EXISTS (SELECT 1 FROM sys.dm_xe_sessions WHERE name=N'XE_Article_Demo')
    ALTER EVENT SESSION [XE_Article_Demo] ON SERVER STATE=STOP;
GO

این مثال روی جنبه «روش اشتباه و اصلاح» تمرکز دارد. در محیط واقعی نام Session، مسیر فایل، Scope و سطح دسترسی را با استاندارد استقرار خود هماهنگ کنید.

مثال 10: توقف زمان‌بندی‌شده

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

-- مناسب برای Job پایان پنجره عیب‌یابی
IF EXISTS (SELECT 1 FROM sys.dm_xe_sessions WHERE name=N'XE_Article_Demo')
BEGIN
    ALTER EVENT SESSION [XE_Article_Demo] ON SERVER STATE=STOP;
    PRINT N'XE_Article_Demo stopped at ' + CONVERT(nvarchar(30), SYSDATETIME(), 126);
END;
GO

این مثال روی جنبه «توقف زمان‌بندی‌شده» تمرکز دارد. در محیط واقعی نام Session، مسیر فایل، Scope و سطح دسترسی را با استاندارد استقرار خود هماهنگ کنید.

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

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

در پروژه سازمانی بهتر است اجرای STATE = STOP بخشی از Runbook باشد: مالک Session، زمان شروع و پایان، مسیر داده، سقف نگهداری و Query کنترل بعد از اجرا ثبت شود. این ساختار به تیم DBA و توسعه اجازه می‌دهد تغییر را از یک اقدام دستی به فرآیند قابل حسابرسی تبدیل کنند.

برای محیط‌های پرترافیک، ابتدا نشست را در بار مشابه Production آزمایش کنید. مقدار Event تولیدشده، حجم فایل، رخدادهای Drop و زمان Parse باید با هدف مانیتورینگ مقایسه شوند؛ تنها مشاهده چند Event موفق معیار کافی نیست.

هشدار مهم

توقف یک نشست حیاتی بدون هماهنگی می‌تواند پوشش Alert یا Audit را قطع کند.

دستور را ابتدا در محیط آزمایشی اجرا کنید و برای نشست‌های امنیتی، Audit یا system_health از تغییر بدون تأیید مالک سرویس پرهیز کنید.

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

• اجرای STATE = STOP با Scope اشتباه؛ راه اصلاح: محل ایجاد Session را از Catalog متناظر پیدا کنید و ON SERVER یا ON DATABASE را همان‌جا به کار ببرید.
• اتکا به پیام Commands completed successfully؛ راه اصلاح: نتیجه را با Catalog و در صورت نیاز DMV Runtime تأیید کنید.
• استفاده از نام Package یا Object ناقص؛ راه اصلاح: نام رسمی را از sys.dm_xe_objects استخراج کنید.
• نادیده‌گرفتن مصرف Target و فایل؛ راه اصلاح: ظرفیت، Rollover و سیاست پاک‌سازی را قبل از اجرا تعیین کنید.
• تغییر مستقیم در Production بدون Script بازگشت؛ راه اصلاح: نسخه قبل و بعد DDL را در کنترل نسخه ثبت کنید.

Performance Considerations

Stop هزینه جمع‌آوری را صفر می‌کند، اما استخراج و Parse فایل‌های موجود همچنان می‌تواند I/O و CPU مصرف کند.

Extended Events نسبت به بسیاری از روش‌های قدیمی سبک‌تر است، اما بدون طراحی درست بی‌هزینه نیست. Actionهای Context، Eventهای بسیار پرتکرار، Predicate ضعیف، Target حافظه‌ای بزرگ یا فایل با Rollover نامناسب می‌توانند CPU، حافظه، I/O و زمان تحلیل را افزایش دهند.

برای سنجش واقعی، شمارنده‌های sys.dm_xe_sessions، اندازه target_data، نرخ رشد xel و زمان Queryهای Parser را در یک بازه ثابت ثبت کنید. مقایسه قبل و بعد از تغییر بهتر از اتکا به حدس یا توصیه عمومی است.

Best Practices

قبل از Stop دلیل و زمان را ثبت کنید، داده نهایی را Flush/خوانش کنید و برای نشست‌های دائمی برنامه Start مجدد داشته باشید.

1. Session را با نام و هدف قابل جست‌وجو تعریف کنید.
2. Scope و Permission را پیش از DDL کنترل کنید.
3. برای Eventهای پرتکرار Predicate دقیق بنویسید.
4. پس از هر تغییر Catalog و Runtime را جداگانه اعتبارسنجی کنید.
5. اسکریپت توقف، حذف یا بازگشت را کنار اسکریپت اصلی نگه دارید.
6. ظرفیت Target و عمر داده را به Runbook اضافه کنید.

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

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

آیا این دستور داده‌ای برمی‌گرداند؟

Result Set ندارد؛ ردیف Runtime از sys.dm_xe_sessions حذف می‌شود ولی Metadata در sys.server_event_sessions می‌ماند.

چطور بفهمیم تغییر در Catalog ثبت شده است؟

برای Scope سطح Server از sys.server_event_sessions و Viewهای وابسته استفاده کنید؛ برای Session فعال، sys.dm_xe_sessions و sys.dm_xe_session_targets را نیز بررسی کنید.

آیا می‌توان آن را در Transaction برنامه کاربردی قرار داد؟

DDLهای Extended Events را بهتر است در اسکریپت مدیریت مستقل، با TRY/CATCH و کنترل وضعیت اجرا کنید؛ رفتار Transaction را در نسخه مقصد آزمایش کنید و به Rollback منطقی متکی باشید.

تفاوت ON SERVER و ON DATABASE چیست؟

Scope مالکیت، Permission، Catalog و DMVها را تغییر می‌دهد. اسکریپت نباید این دو را بدون بررسی سرویس مقصد جایگزین یکدیگر کند.

چرا Session در Catalog هست ولی داده ندارد؟

ممکن است Start نشده باشد، Predicate هیچ Eventی را عبور نداده باشد، Target باز نشده باشد یا مسیر فایل/مجوز مشکل داشته باشد.

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

وجود Session، وضعیت Runtime، وجود Event/Target، Permission، مسیر فایل، نتیجه DDL و Query اعتبارسنجی بعد از اجرا را ثبت کنید.

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

در یک مصاحبه چگونه نقش STATE = STOP را توضیح می‌دهید؟

با تفکیک نقش آن در state-stop، اثر روی Metadata/Runtime و نیاز به کنترل Scope پاسخ دهید.

چرا Predicate روی Performance مهم است؟

زیرا رویداد نامرتبط را پیش از Dispatch حذف می‌کند و حجم Target و Parse را کاهش می‌دهد.

چه تفاوتی میان Catalog و DMV Runtime وجود دارد؟

Catalog تعریف پایدار را نگه می‌دارد؛ DMV Runtime فقط وضعیت نشست فعال و Targetهای باز را نشان می‌دهد.

چطور یک تغییر Extended Events را قابل بازگشت می‌کنید؟

DDL فعلی را ثبت، تغییر را کوچک، Query کنترل را مشخص و Script معکوس یا Recreate را آماده می‌کنید.

چه زمانی event_file را به ring_buffer ترجیح می‌دهید؟

وقتی دوام، حجم بیشتر، تحلیل بعدی و مدیریت Rollover مهم است؛ ring_buffer برای مشاهده کوتاه و محدود مناسب‌تر است.

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

1. هدف مانیتورینگ و Scope را ثبت کنید.
2. وجود پیش‌نیازهای STATE = STOP را کنترل کنید.
3. DDL را با نام Session آزمایشی اجرا کنید.
4. Catalog و Runtime را جداگانه Query بگیرید.
5. حجم Target و رخداد Drop را بسنجید.
6. اسکریپت بازگشت را ذخیره کنید.
7. زمان و مالک تغییر را در Runbook ثبت کنید.

جمع‌بندی تصمیم‌محور

STATE = STOP زمانی انتخاب درستی است که نقش آن در چرخه Session روشن، پیش‌نیازهای Scope و Permission کنترل و نتیجه با Viewهای Metadata و Runtime تأیید شود. برای این دستور، توصیه محوری چنین است: قبل از Stop دلیل و زمان را ثبت کنید، داده نهایی را Flush/خوانش کنید و برای نشست‌های دائمی برنامه Start مجدد داشته باشید.

قدم بعدی، مرور نقشه کامل دستورات Extended Events و سپس آزمایش Queryهای همین مقاله روی یک Session غیرحیاتی است.

خدمات برنامه‌نویسی و پایگاه داده

قبول سفارش‌های برنامه‌نویسی و پایگاه داده در اصفهان با شماره 09131253620؛ مجموعه‌ای معتبر با سابقه فعالیت حرفه‌ای از سال ۱۳۷۵ شمسی تاکنون.

انجام پروژه، آموزش برنامه‌نویسی و آموزش پایگاه داده SQL Server برای دانشجویان، برنامه‌نویسان و سازمان‌ها انجام می‌شود. برای سفارش پروژه از ایتا، واتساپ یا تماس مستقیم استفاده کنید.

• دانلود پروژه‌های رایگان C#
• دانلود پروژه‌های رایگان SQL Server
• دانلود پروژه‌های رایگان Microsoft Access
• دانلود پروژه‌های رایگان UML
• دانلود پروژه‌های ASP.NET Web Forms
• گزارش‌های کارآموزی
• طرح‌های توجیهی و کارآفرینی
• پروژه‌های Multimedia Builder
• تماس مستقیم: 09131253620
• تماس با ما