آموزش STATE = START برای اجرای Event Session | آموزش SQL Server

آموزش STATE = START برای اجرای Event Session

توسط admin | گروه SQL Server | 1405/05/06

نظرات 0

آموزش STATE = START برای اجرای Event Session

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

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

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

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

دسترسی سریع

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

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

STATE = START یک نشست تعریف‌شده را وارد حالت فعال می‌کند تا موتور رویدادهای انتخاب‌شده را دریافت و به Targetها Dispatch کند.

مرز میان Metadata و Runtime است؛ وجود نشست در Catalog به‌تنهایی به معنی جمع‌آوری داده نیست.

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

STATE = START — نقشه مفهومینمودار اختصاصی STATE = START — نقشه مفهومی با برچسب‌های فنی مرتبط با Extended Events.STATE = START — نقشه مفهومیSTATE = STARTExecution ScopeRuntime Sessionsys.dm_xe_sessionsDispatchTarget OpenSTARTUP_STATEDropped EventsActivationRecommended Use

این نقشه نشان می‌دهد STATE = START چگونه با Scope، Metadata، Event/Target و کنترل عملیاتی مرتبط می‌شود؛ برچسب‌ها مخصوص همین دستور انتخاب شده‌اند.

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

Syntax استاندارد

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

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

  • SessionName باید ایجاد شده باشد.
  • Scope با محل ایجاد Session تطابق دارد.
  • Target و Eventهای نشست باید پیش از Start از نظر مجوز و تنظیمات معتبر باشند.

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

Result Set ندارد؛ موفقیت را از sys.dm_xe_sessions و sys.dm_xe_session_targets می‌توان کنترل کرد.

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

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

مرز Metadata و Runtime

STATE = START روی یکی از دو لایه تعریف یا اجرا اثر می‌گذارد. Catalog مانند sys.server_event_sessions وضعیت تعریف‌شده را نگه می‌دارد، در حالی که sys.dm_xe_sessions فقط نشست‌های فعال را نشان می‌دهد.

کنترل هر دو لایه مانع برداشت اشتباه از موفقیت عملیات می‌شود.

وابستگی به Scope و Permission

ON SERVER معمولاً به مجوزهای سطح Server نیاز دارد و نام Objectها در sys.server_event_* دیده می‌شود. برای ON DATABASE باید Catalog و Permission متناظر همان Database را به کار برد.

اسکریپت قابل‌انتقال باید Scope را به‌عنوان یک تصمیم صریح نگه دارد، نه یک مقدار ضمنی.

طراحی قابل بازگشت

برای STATE = START همواره یک مسیر Rollback یا Recreate تعریف کنید. تغییرهای Extended Events اغلب در زمان Incident انجام می‌شوند و نبود اسکریپت بازگشت می‌تواند پوشش تشخیصی را ناقص کند.

  • ثبت DDL فعلی
  • کنترل وجود Object
  • اعمال تغییر کوچک
  • اعتبارسنجی Target و Runtime
STATE = START — جریان اجرانمودار اختصاصی STATE = START — جریان اجرا با برچسب‌های فنی مرتبط با Extended Events.STATE = START — جریان اجرا1Runtime Session2sys.dm_xe_sessions3Dispatch4Target Open5STARTUP_STATEPredicateMetric 54DispatchMetric 71TargetMetric 88Output ShapeMetric 35

جریان دوم ترتیب بررسی پیش‌نیاز، اجرای STATE = START، ثبت Metadata و اعتبارسنجی خروجی را نمایش می‌دهد؛ Badgeها نقاط کنترل هزینه و Dispatch هستند.

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

مثال 1: Start ساده

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

ALTER EVENT SESSION [XE_Article_Demo] ON SERVER
STATE = START;
GO
شاخصخروجی نمونه
وضعیتموفق در صورت وجود پیش‌نیازها
کنترل پیشنهادیCatalog یا DMV مرتبط با همان سناریو

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

مثال 2: Start Idempotent

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

IF NOT EXISTS (SELECT 1 FROM sys.dm_xe_sessions WHERE name=N'XE_Article_Demo')
    ALTER EVENT SESSION [XE_Article_Demo] ON SERVER STATE=START;
GO
شاخصخروجی نمونه
وضعیتموفق در صورت وجود پیش‌نیازها
کنترل پیشنهادیCatalog یا DMV مرتبط با همان سناریو

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

مثال 3: کنترل Runtime بعد از Start

سناریو: در این مرحله هدف، کنترل Runtime بعد از Start برای 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';
شاخصخروجی نمونه
ستون نمونهمقدار مورد انتظار
nameXE_Article_Demo یا ردیف‌های مرتبط

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

مثال 4: Start یک نشست Database-scoped

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

ALTER EVENT SESSION [XE_DbScope] ON DATABASE
STATE = START;
GO
شاخصخروجی نمونه
وضعیتموفق در صورت وجود پیش‌نیازها
کنترل پیشنهادیCatalog یا DMV مرتبط با همان سناریو

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

مثال 5: شروع پیش از بازتولید خطا

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

ALTER EVENT SESSION [XE_Article_Demo] ON SERVER STATE=START;
GO
-- اکنون Batch آزمایشی را اجرا کنید.
SELECT 1 / 0;
GO
شاخصخروجی نمونه
وضعیتموفق در صورت وجود پیش‌نیازها
کنترل پیشنهادیCatalog یا DMV مرتبط با همان سناریو

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

مثال 6: کنترل Target بازشده

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

SELECT s.name, t.target_name, DATALENGTH(t.target_data) AS TargetBytes
FROM sys.dm_xe_sessions s
JOIN sys.dm_xe_session_targets t ON t.event_session_address=s.address
WHERE s.name=N'XE_Article_Demo';
شاخصخروجی نمونه
ستون نمونهمقدار مورد انتظار
nameXE_Article_Demo یا ردیف‌های مرتبط

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

مثال 7: شروع گروه نشست‌های Baseline

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

SELECT name
FROM sys.server_event_sessions
WHERE name LIKE N'XE_Baseline[_]%';
-- هر نام تأییدشده را با ALTER ... STATE=START فعال کنید.
شاخصخروجی نمونه
وضعیتموفق در صورت وجود پیش‌نیازها
کنترل پیشنهادیCatalog یا DMV مرتبط با همان سناریو

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

مثال 8: STARTUP_STATE برای راه‌اندازی

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

ALTER EVENT SESSION [XE_Article_Demo] ON SERVER
WITH (STARTUP_STATE = ON);
GO
ALTER EVENT SESSION [XE_Article_Demo] ON SERVER STATE=START;
GO
شاخصخروجی نمونه
وضعیتموفق در صورت وجود پیش‌نیازها
کنترل پیشنهادیCatalog یا DMV مرتبط با همان سناریو

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

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

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

-- اشتباه: Start بدون بررسی وجود Session و مسیر Target
IF EXISTS (SELECT 1 FROM sys.server_event_sessions WHERE name=N'XE_Article_Demo')
AND NOT EXISTS (SELECT 1 FROM sys.dm_xe_sessions WHERE name=N'XE_Article_Demo')
    ALTER EVENT SESSION [XE_Article_Demo] ON SERVER STATE=START;
GO
شاخصخروجی نمونه
وضعیتموفق در صورت وجود پیش‌نیازها
کنترل پیشنهادیCatalog یا DMV مرتبط با همان سناریو

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

مثال 10: پایش اولیه Performance

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

SELECT name, buffered_event_count, dropped_event_count, total_buffer_size
FROM sys.dm_xe_sessions
WHERE name=N'XE_Article_Demo';
شاخصخروجی نمونه
ستون نمونهمقدار مورد انتظار
nameXE_Article_Demo یا ردیف‌های مرتبط

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

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

فعال‌سازی نشست Incident، شروع مانیتورینگ قبل از اجرای Batch آزمایشی یا راه‌اندازی خودکار نشست‌های Baseline.

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

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

هشدار مهم

Start خودکار بدون کنترل ظرفیت Target یا مسیر فایل می‌تواند در آغاز سرویس خطا یا فشار ناخواسته ایجاد کند.

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

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

  • اجرای STATE = START با 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

پس از Start، نرخ Event، dropped_event_count، dispatch latency و رشد فایل را پایش کنید.

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

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

Best Practices

Start را Idempotent و همراه با کنترل Runtime بنویسید؛ برای نشست‌های دائمی STARTUP_STATE را آگاهانه تنظیم کنید.

  1. Session را با نام و هدف قابل جست‌وجو تعریف کنید.
  2. Scope و Permission را پیش از DDL کنترل کنید.
  3. برای Eventهای پرتکرار Predicate دقیق بنویسید.
  4. پس از هر تغییر Catalog و Runtime را جداگانه اعتبارسنجی کنید.
  5. اسکریپت توقف، حذف یا بازگشت را کنار اسکریپت اصلی نگه دارید.
  6. ظرفیت Target و عمر داده را به Runbook اضافه کنید.
STATE = START — تصمیم عملینمودار اختصاصی STATE = START — تصمیم عملی با برچسب‌های فنی مرتبط با Extended Events.STATE = START — تصمیم عملیDecision GridDropped EventsSTARTUP_STATETarget OpenDispatchOverhead vs Coveragesys.dm_xe_sessionsRuntime SessionSTATE = STARTBest PathCommon Error → Fix

ماتریس تصمیم پایانی برای STATE = START تعادل میان پوشش تشخیصی، Overhead، قابلیت بازگشت و مسیر درست اجرا را به‌صورت مقایسه‌ای نشان می‌دهد.

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

بعد تصمیمارزیابی اختصاصی
مزیت اصلیمرز میان Metadata و Runtime است؛ وجود نشست در Catalog به‌تنهایی به معنی جمع‌آوری داده نیست.
محدودیتStart خودکار بدون کنترل ظرفیت Target یا مسیر فایل می‌تواند در آغاز سرویس خطا یا فشار ناخواسته ایجاد کند.
زمان مناسبفعال‌سازی نشست Incident، شروع مانیتورینگ قبل از اجرای Batch آزمایشی یا راه‌اندازی خودکار نشست‌های Baseline.
زمان نامناسبوقتی هدف تشخیصی، Scope یا برنامه نگهداری داده مشخص نیست؛ در این وضعیت ابتدا طراحی Session را کامل کنید.

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

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

Result Set ندارد؛ موفقیت را از sys.dm_xe_sessions و sys.dm_xe_session_targets می‌توان کنترل کرد.

چطور بفهمیم تغییر در 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 = START را توضیح می‌دهید؟

با تفکیک نقش آن در state-start، اثر روی 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 = START را کنترل کنید.
  3. DDL را با نام Session آزمایشی اجرا کنید.
  4. Catalog و Runtime را جداگانه Query بگیرید.
  5. حجم Target و رخداد Drop را بسنجید.
  6. اسکریپت بازگشت را ذخیره کنید.
  7. زمان و مالک تغییر را در Runbook ثبت کنید.

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

STATE = START زمانی انتخاب درستی است که نقش آن در چرخه Session روشن، پیش‌نیازهای Scope و Permission کنترل و نتیجه با Viewهای Metadata و Runtime تأیید شود. برای این دستور، توصیه محوری چنین است: Start را Idempotent و همراه با کنترل Runtime بنویسید؛ برای نشست‌های دائمی STARTUP_STATE را آگاهانه تنظیم کنید.

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

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

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

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

 

0 نظر

نظر محترم شما در مورد مقاله های وب سایت برنامه نویسی و پایگاه داده

نظرات محترم شما در خدمات رسانی بهتر ما را یاری می نمایند. لطفا اگر مایل بودید یک نظر ما را مهمان فرمائید. آدرس ایمیل و وب سایت شما نمایش داده نخواهد شد.

حرف 500 حداکثر