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

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

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

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

دسترسی سریع

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

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

DROP TARGET یک مقصد را از نشست حذف می‌کند و Eventها پس از آن دیگر به آن Target ارسال نمی‌شوند.

برای جایگزینی نوع ذخیره‌سازی، کاهش مصرف حافظه یا پایان دادن به یک مسیر خروجی موقت استفاده می‌شود.

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

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

Syntax استاندارد

ALTER EVENT SESSION [SessionName]
ON SERVER
DROP TARGET package0.ring_buffer;

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

• SessionName باید Target را در تعریف خود داشته باشد.
• نام Target با Package کامل نوشته می‌شود.
• حذف Target داده‌ای را که قبلاً در فایل نوشته شده پاک نمی‌کند.

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

Result Set ندارد؛ Metadata Target حذف می‌شود و در شروع یا ادامه Session مقصد دیگر فعال نیست.

این یک دستور 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
DROP TARGET package0.ring_buffer;
GO

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

مثال 2: حذف event_file

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

ALTER EVENT SESSION [XE_Article_Demo] ON SERVER
DROP TARGET package0.event_file;
GO

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

مثال 3: کنترل وجود Target

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

IF EXISTS
(
 SELECT 1 FROM sys.server_event_session_targets t
 JOIN sys.server_event_sessions s ON s.event_session_id=t.event_session_id
 WHERE s.name=N'XE_Article_Demo' AND t.name=N'ring_buffer'
)
 ALTER EVENT SESSION [XE_Article_Demo] ON SERVER DROP TARGET package0.ring_buffer;
GO

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

مثال 4: خواندن نهایی قبل از حذف

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

SELECT CAST(t.target_data AS xml) AS FinalData
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';

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

مثال 5: توقف و حذف امن

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

ALTER EVENT SESSION [XE_Article_Demo] ON SERVER STATE=STOP;
ALTER EVENT SESSION [XE_Article_Demo] ON SERVER DROP TARGET package0.ring_buffer;
GO

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

مثال 6: جایگزینی ring_buffer با فایل

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

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

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

مثال 7: فهرست Consumerهای Runtime

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

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

مثال 8: حفظ فایل‌های قبلی

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

SELECT file_name, COUNT(*) AS EventCount
FROM sys.fn_xe_file_target_read_file(N'D:\SqlData\XE\Article*.xel', NULL, NULL, NULL)
GROUP BY file_name;

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

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

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

-- اشتباه: حذف آخرین Target بدون برنامه مصرف داده
-- ALTER EVENT SESSION [XE_Article_Demo] ON SERVER DROP TARGET package0.event_file;

-- اصلاح: ابتدا Target جایگزین اضافه و سپس مقصد قدیمی حذف شود.

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

مثال 10: اندازه‌گیری کاهش حافظه

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

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

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

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

حذف ring_buffer پس از انتقال به event_file یا کنارگذاشتن histogram موقتی پس از تکمیل تحلیل توزیع.

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

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

هشدار مهم

اگر آخرین Target حذف شود، Eventها ممکن است تولید شوند اما مسیر مصرف مورد انتظار وجود نداشته باشد؛ طراحی را بررسی کنید.

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

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

• اجرای DROP 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

حذف Target غیرضروری هزینه Dispatch و نگهداری را کم می‌کند؛ ولی اثر آن روی ابزارهای مانیتورینگ باید سنجیده شود.

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

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

Best Practices

قبل از حذف، داده باقیمانده را استخراج کنید و سپس وابستگی Job، Dashboard یا Alert را قطع یا به Target جدید منتقل کنید.

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

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

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

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

Result Set ندارد؛ Metadata Target حذف می‌شود و در شروع یا ادامه Session مقصد دیگر فعال نیست.

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

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

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

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

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

DROP TARGET زمانی انتخاب درستی است که نقش آن در چرخه Session روشن، پیش‌نیازهای Scope و Permission کنترل و نتیجه با Viewهای Metadata و Runtime تأیید شود. برای این دستور، توصیه محوری چنین است: قبل از حذف، داده باقیمانده را استخراج کنید و سپس وابستگی Job، Dashboard یا Alert را قطع یا به Target جدید منتقل کنید.

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

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

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

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

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