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

وقتی یک نشست Extended Events فقط در حد تعریف باقی نماند و قرار باشد در چرخه استقرار، عیب‌یابی و نگهداری استفاده شود، شناخت دقیق ADD TARGET ضروری است. این مقاله مسئله عملی «Target شکل دسترسی، دوام، هزینه I/O و مسیر تحلیل داده را تعیین می‌کند.» را از دید SQL Server بررسی می‌کند و تفاوت Metadata با وضعیت Runtime را روشن نگه می‌دارد.

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

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

دسترسی سریع

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

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

ADD TARGET مقصد مصرف یا ذخیره Eventها را به نشست اضافه می‌کند؛ event_file، ring_buffer و histogram نمونه‌های رایج‌اند.

Target شکل دسترسی، دوام، هزینه I/O و مسیر تحلیل داده را تعیین می‌کند.

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

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

Syntax استاندارد

ALTER EVENT SESSION [SessionName]
ON SERVER
ADD TARGET package0.event_file
(
    SET filename = N'C:\XE\SessionName.xel',
        max_file_size = 100,
        max_rollover_files = 5
);

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

• Target به‌صورت package.target_name مشخص می‌شود.
• SET گزینه‌های مقصد مانند filename و اندازه فایل را مقداردهی می‌کند.
• یک Session می‌تواند بیش از یک Target داشته باشد، اما هرکدام هزینه مستقل دارند.
• مسیر فایل باید برای Service Account قابل نوشتن باشد.

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

خروجی مستقیم ندارد؛ پس از شروع نشست، Eventها طبق Dispatch به Target جدید ارسال می‌شوند.

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

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

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

مثال 1: افزودن ring_buffer

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

ALTER EVENT SESSION [XE_Article_Demo] ON SERVER
ADD TARGET package0.ring_buffer;
GO

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

مثال 2: افزودن event_file

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

ALTER EVENT SESSION [XE_Article_Demo] ON SERVER
ADD TARGET package0.event_file
(SET filename=N'C:\XE\ArticleDemo.xel');
GO

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

مثال 3: تنظیم Rollover

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

ALTER EVENT SESSION [XE_Article_Demo] ON SERVER
ADD TARGET package0.event_file
(SET filename=N'C:\XE\Roll.xel', max_file_size=64, max_rollover_files=5);
GO

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

مثال 4: افزودن histogram

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

ALTER EVENT SESSION [XE_Article_Demo] ON SERVER
ADD TARGET package0.histogram
(SET filtering_event_name=N'sqlserver.error_reported', source=N'error_number');
GO

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

مثال 5: کنترل Target در Catalog

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

SELECT t.name AS target_name, f.name, f.value
FROM sys.server_event_session_targets t
JOIN sys.server_event_sessions s ON s.event_session_id=t.event_session_id
LEFT JOIN sys.server_event_session_fields f ON f.event_session_id=t.event_session_id AND f.object_id=t.target_id
WHERE s.name=N'XE_Article_Demo';

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

مثال 6: کنترل Target در Runtime

سناریو: در این مرحله هدف، کنترل Target در 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';

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

مثال 7: خواندن ring_buffer

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

SELECT CAST(t.target_data AS xml) AS RingBufferXml
FROM sys.dm_xe_session_targets t
JOIN sys.dm_xe_sessions s ON s.address=t.event_session_address
WHERE s.name=N'XE_Article_Demo' AND t.target_name=N'ring_buffer';

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

مثال 8: خواندن event_file

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

SELECT object_name, file_name, timestamp_utc, event_data
FROM sys.fn_xe_file_target_read_file(N'C:\XE\ArticleDemo*.xel', NULL, NULL, NULL);

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

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

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

-- اشتباه: مسیری که Service Account مجوز ندارد
-- SET filename=N'C:\Users\User\Desktop\x.xel'

ALTER EVENT SESSION [XE_Article_Demo] ON SERVER
ADD TARGET package0.event_file
(SET filename=N'D:\SqlData\XE\ArticleDemo.xel');
GO

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

مثال 10: Target پایدار برای Production

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

ALTER EVENT SESSION [XE_Article_Demo] ON SERVER
ADD TARGET package0.event_file
(
 SET filename=N'D:\SqlData\XE\Prod.xel',
     max_file_size=128,
     max_rollover_files=8
);
GO

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

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

افزودن event_file به نشست عیب‌یابی بلندمدت یا histogram برای شمارش سریع توزیع یک فیلد محدود.

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

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

هشدار مهم

مسیر نامعتبر، مجوز ناکافی یا انتخاب ring_buffer برای حجم زیاد باعث از دست‌رفتن یا دشواری تحلیل داده می‌شود.

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

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

• اجرای ADD TARGET با 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

event_file برای حجم پایدار معمولاً مناسب‌تر است؛ اندازه و rollover را با نرخ Event و ظرفیت دیسک هماهنگ کنید.

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

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

Best Practices

Target را بر اساس دوام، حجم، ابزار خواندن و زمان نگهداری انتخاب کنید؛ ظرفیت و پاک‌سازی را به طراحی اضافه کنید.

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

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

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

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

خروجی مستقیم ندارد؛ پس از شروع نشست، Eventها طبق Dispatch به Target جدید ارسال می‌شوند.

چطور بفهمیم تغییر در 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 اعتبارسنجی بعد از اجرا را ثبت کنید.

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

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

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

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

ADD TARGET زمانی انتخاب درستی است که نقش آن در چرخه Session روشن، پیش‌نیازهای Scope و Permission کنترل و نتیجه با Viewهای Metadata و Runtime تأیید شود. برای این دستور، توصیه محوری چنین است: Target را بر اساس دوام، حجم، ابزار خواندن و زمان نگهداری انتخاب کنید؛ ظرفیت و پاک‌سازی را به طراحی اضافه کنید.

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

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

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

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

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