wait_completed چه مسئله‌ای را حل می‌کند؟

هدف اصلی این رویداد، تمرکز بر انتظارهای پایان‌یافته، اندازه‌گیری duration و ساخت نمای زمانی از وقفه‌های یک Session یا عملیات مشخص است. ارزش عملی آن زمانی آشکار می‌شود که تیم پایگاه داده به جای نگاه کردن به میانگین‌های کلی، هر رخداد را با database_id، session_id، نام برنامه، متن SQL و زمان وقوع مرتبط کند. چنین ارتباطی کمک می‌کند کندی گذرا، رفتار پارامتری و تفاوت بار برنامه‌ها از یکدیگر جدا شوند.

فیلدهای مهمی که باید بر اساس metadata سرور بررسی شوند عبارت‌اند از wait_type، duration، session_id، task_address، resource_description، database_id. این نام‌ها نقش راهنما دارند؛ چون نسخه نصب‌شده تعیین می‌کند هر ستون Data یا Action دقیقاً با چه نوعی در دسترس باشد. رویدادهای همراه پیشنهادی نیز wait_info، blocked_process_report، query_thread_profile، error_reported هستند. انتخاب هم‌زمان همه آن‌ها همیشه لازم نیست و باید از سؤال عیب‌یابی مشتق شود.

نحو پایه Session برای wait_completed

CREATE EVENT SESSION [XE_wait_completed] ON SERVER
ADD EVENT sqlos.wait_completed
(
    ACTION
    (
        sqlserver.sql_text,
        sqlserver.database_id,
        sqlserver.session_id
    )
)
ADD TARGET package0.event_file
(SET filename = N'C:\XE\wait_completed.xel');
GO

ده مثال عملی و غیرتکراری برای wait_completed

مثال 1: شناسایی metadata رویداد wait_completed

پیش از ساخت Session باید وجود رویداد، Package و توضیح ثبت‌شده روی همان سرور بررسی شود. این کار برای wait_completed به‌خصوص در محیط‌هایی با نسخه‌های متفاوت از خطای نامعتبر بودن Event جلوگیری می‌کند.

SELECT o.name AS event_name, p.name AS package_name, o.description
FROM sys.dm_xe_objects AS o
INNER JOIN sys.dm_xe_packages AS p ON p.guid = o.package_guid
WHERE o.object_type = N'event'
  AND o.name = N'wait_completed';

نکته کاربردی: اگر خروجی خالی بود، ابتدا نسخه SQL Server و نام دقیق رویداد را بررسی کنید؛ این مرحله برای wait_completed از ساخت اسکریپت ناسازگار جلوگیری می‌کند.

مثال 2: مشاهده ستون‌ها و داده‌های قابل ثبت در wait_completed

ستون‌های Event باید از metadata خوانده شوند تا فیلتر و تحلیل بر اساس فیلدهای واقعاً موجود انجام شود. در این مثال، ستون‌های پیشنهادی مانند wait_type, duration, session_id, task_address, resource_description, database_id با تعریف سرور مقایسه می‌شوند.

SELECT c.name AS column_name, c.type_name, c.column_type, c.description
FROM sys.dm_xe_object_columns AS c
WHERE c.object_name = N'wait_completed'
ORDER BY c.column_id;

نکته کاربردی: این Query مبنای طراحی Parser است؛ به نام ستون‌های حدسی تکیه نکنید و ساختار همان نسخه را مستند سازید.

مثال 3: ساخت Session پایه برای wait_completed با ring_buffer

برای آزمایش کوتاه و کنترل‌شده می‌توان از ring_buffer استفاده کرد. Session زیر اطلاعات زمینه‌ای مانند متن SQL، شناسه پایگاه داده و نام برنامه را در کنار رویداد wait_completed نگه می‌دارد.

IF EXISTS (SELECT 1 FROM sys.server_event_sessions WHERE name = N'XE_wait_completed_1')
    DROP EVENT SESSION [XE_wait_completed_1] ON SERVER;
GO
CREATE EVENT SESSION [XE_wait_completed_1] ON SERVER
ADD EVENT sqlos.wait_completed
(
    ACTION
    (
        sqlserver.sql_text,
        sqlserver.database_id,
        sqlserver.client_app_name,
        sqlserver.session_id
    )
)
ADD TARGET package0.ring_buffer
WITH (MAX_MEMORY = 4096 KB, EVENT_RETENTION_MODE = ALLOW_SINGLE_EVENT_LOSS);
GO

نکته کاربردی: ring_buffer برای نمونه‌برداری سریع مناسب است؛ برای نگه‌داری طولانی یا حجم بالای wait_completed بهتر است event_file انتخاب شود.

مثال 4: اعمال Predicate اختصاصی روی wait_completed

جمع‌آوری بدون فیلتر می‌تواند داده فراوان تولید کند. این نمونه با شرط [duration] > (20000) تنها رخدادهای مهم‌تر را ثبت می‌کند و هزینه تحلیل را کاهش می‌دهد.

IF EXISTS (SELECT 1 FROM sys.server_event_sessions WHERE name = N'XE_wait_completed_1_Filtered')
    DROP EVENT SESSION [XE_wait_completed_1_Filtered] ON SERVER;
GO
CREATE EVENT SESSION [XE_wait_completed_1_Filtered] ON SERVER
ADD EVENT sqlos.wait_completed
(
    ACTION (sqlserver.sql_text, sqlserver.database_id, sqlserver.session_id)
    WHERE ([duration] > (20000))
)
ADD TARGET package0.event_file
(SET filename = N'C:\XE\waitcompleted_filtered.xel', max_file_size = 100, max_rollover_files = 4);
GO

نکته کاربردی: آستانه را بر اساس SLA و نرخ واقعی wait_completed تنظیم کنید؛ مقدار نمونه نباید بدون اندازه‌گیری به محیط تولید منتقل شود.

مثال 5: شروع و توقف امن Session مربوط به wait_completed

فعال‌سازی باید زمان‌بندی‌شده باشد تا داده فقط در بازه عیب‌یابی جمع‌آوری شود. Query زیر وضعیت Session را نیز بررسی می‌کند و از فرمان‌های تکراری جلوگیری می‌کند. این نکته در پرونده فنی wait_completed با داده همان رویداد ارزیابی می‌شود.

IF NOT EXISTS
(
    SELECT 1
    FROM sys.dm_xe_sessions
    WHERE name = N'XE_wait_completed_1'
)
    ALTER EVENT SESSION [XE_wait_completed_1] ON SERVER STATE = START;
GO
-- پس از پایان بازه پایش
IF EXISTS (SELECT 1 FROM sys.dm_xe_sessions WHERE name = N'XE_wait_completed_1')
    ALTER EVENT SESSION [XE_wait_completed_1] ON SERVER STATE = STOP;
GO

نکته کاربردی: در محیط تولید زمان آغاز، پایان، دلیل فعال‌سازی و مالک تحلیل را در Change Log ثبت کنید.

مثال 6: خواندن Target حافظه‌ای wait_completed

برای دیدن رخدادهای ring_buffer، داده Target به XML تبدیل می‌شود. این روش برای مشاهده سریع مناسب است و نیاز به فایل خارجی ندارد. این نکته در پرونده فنی wait_completed با داده همان رویداد ارزیابی می‌شود.

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

نکته کاربردی: ring_buffer ظرفیت محدود دارد و با ورود رخدادهای جدید، داده قدیمی ممکن است حذف شود؛ برای تحلیل تاریخی از فایل استفاده کنید.

مثال 7: خواندن فایل‌های XEL مربوط به wait_completed

در Sessionهای پایدار، event_file قابلیت مرور و آرشیو مناسب‌تری دارد. این Query همه فایل‌های چرخشی مرتبط با wait_completed را به ترتیب زمانی برمی‌گرداند.

SELECT
    object_name,
    file_name,
    file_offset,
    CAST(event_data AS xml) AS event_xml
FROM sys.fn_xe_file_target_read_file
(
    N'C:\XE\waitcompleted_filtered*.xel',
    NULL, NULL, NULL
)
WHERE object_name = N'wait_completed'
ORDER BY file_name, file_offset;

نکته کاربردی: Wildcard فقط باید فایل‌های Session هدف را پوشش دهد تا داده رویدادهای دیگر با تحلیل مخلوط نشود.

مثال 8: تجزیه زمان و Actionهای wait_completed از XML

برای گزارش‌گیری، XML باید به ستون‌های جدولی تبدیل شود. نمونه زیر timestamp، session_id، database_id و sql_text را استخراج می‌کند و می‌توان فیلدهای اختصاصی wait_completed را نیز افزود.

WITH EventData AS
(
    SELECT CAST(event_data AS xml) AS x
    FROM sys.fn_xe_file_target_read_file
    (N'C:\XE\waitcompleted_filtered*.xel', NULL, NULL, NULL)
    WHERE object_name = N'wait_completed'
)
SELECT
    x.value('(event/@timestamp)[1]', 'datetime2(3)') AS utc_time,
    x.value('(event/action[@name="session_id"]/value)[1]', 'int') AS session_id,
    x.value('(event/action[@name="database_id"]/value)[1]', 'int') AS database_id,
    x.value('(event/action[@name="sql_text"]/value)[1]', 'nvarchar(max)') AS sql_text
FROM EventData;

نکته کاربردی: Timestamp رویداد معمولاً باید با منطقه زمانی سامانه گزارش‌گیری هماهنگ شود؛ تبدیل را در لایه نمایش یا ETL به‌صورت صریح انجام دهید.

خطاهای رایج در کار با wait_completed

• ساخت Predicate بر اساس ستونی که در metadata نسخه نصب‌شده وجود ندارد؛ پیش از اجرا، تعریف wait_completed را از DMVها بخوانید.
• فعال کردن wait_completed بدون محدودیت database_id، session_id یا آستانه مناسب و سپس پر شدن سریع Target.
• افزودن Actionهای زیاد مانند sql_text در همه رخدادها بدون ارزیابی امنیت و سربار.؛ با تمرکز اختصاصی بر wait_completed
• خواندن مستقیم XML در هر بار نمایش داشبورد به جای تبدیل دوره‌ای به جدول Stage.؛ با تمرکز اختصاصی بر wait_completed
• نتیجه‌گیری از یک رخداد منفرد بدون مقایسه با طرح اجرا، انتظارها، لاگ برنامه و شاخص‌های سیستم.؛ با تمرکز اختصاصی بر wait_completed

ملاحظات Performance و ظرفیت‌سنجی wait_completed

نام و دسترس‌پذیری جزئیات این رویداد می‌تواند به نسخه و محیط SQL Server وابسته باشد؛ پیش از ساخت Session باید metadata همان سرور بررسی شود. هزینه Session فقط از نام Event تعیین نمی‌شود؛ تعداد رخداد در ثانیه، Actionهای انتخابی، Predicate، نوع Target، سرعت دیسک و MAX_DISPATCH_LATENCY همگی اثر دارند. بهترین روش، اجرای آزمایشی در بار مشابه تولید و مقایسه CPU، I/O، حجم XEL و نرخ از دست رفتن رخدادها است.

برای این موضوع، توصیه عملی چنین است: ابتدا با sys.dm_xe_objects و sys.dm_xe_object_columns وجود و ستون‌های رویداد را تأیید کنید و سپس فیلتر متناسب با نسخه بسازید. همچنین فایل‌ها باید سقف اندازه و تعداد Rollover داشته باشند تا پایش به مصرف کنترل‌نشده فضای ذخیره‌سازی منجر نشود. اگر داده برای حسابرسی لازم است، انتقال به مخزن جداگانه و سیاست Retention مستند ضروری خواهد بود.

مثال 9: مدیریت رفتار NULL هنگام تحلیل wait_completed

همه Actionها یا Data Fieldها در تمام رخدادها مقدار ندارند. با NULLIF و COALESCE می‌توان خروجی خوانا ساخت بدون آنکه نبود داده با مقدار صفر اشتباه گرفته شود. این نکته در پرونده فنی wait_completed با داده همان رویداد ارزیابی می‌شود.

WITH Parsed AS
(
    SELECT
        CAST(event_data AS xml) AS x
    FROM sys.fn_xe_file_target_read_file
    (N'C:\XE\waitcompleted_filtered*.xel', NULL, NULL, NULL)
    WHERE object_name = N'wait_completed'
)
SELECT
    COALESCE
    (
        NULLIF(x.value('(event/action[@name="client_app_name"]/value)[1]', 'nvarchar(256)'), N''),
        N'برنامه نامشخص'
    ) AS client_app_name
FROM Parsed;

نکته کاربردی: در انبار داده، NULL را بدون تصمیم طراحی به رشته ثابت تبدیل نکنید؛ نسخه خام و نسخه نمایشی را جدا نگه دارید.

مثال 10: پایش کم‌هزینه و قابل حذف برای wait_completed

نمونه نهایی Session را با event_file چرخشی، Startup State غیرفعال و تنظیم Dispatch مناسب می‌سازد. سپس دستور حذف کنترل‌شده ارائه می‌شود تا محیط پس از عیب‌یابی پاک بماند. این نکته در پرونده فنی wait_completed با داده همان رویداد ارزیابی می‌شود.

CREATE EVENT SESSION [XE_wait_completed_1_Production] ON SERVER
ADD EVENT sqlos.wait_completed
(
    ACTION (sqlserver.database_id, sqlserver.session_id, sqlserver.client_app_name)
    WHERE ([duration] > (20000))
)
ADD TARGET package0.event_file
(SET filename = N'C:\XE\waitcompleted_prod.xel', max_file_size = 128, max_rollover_files = 8)
WITH
(
    MAX_MEMORY = 8192 KB,
    EVENT_RETENTION_MODE = ALLOW_SINGLE_EVENT_LOSS,
    MAX_DISPATCH_LATENCY = 10 SECONDS,
    TRACK_CAUSALITY = ON,
    STARTUP_STATE = OFF
);
GO
-- پاک‌سازی پس از اتمام تحلیل
DROP EVENT SESSION [XE_wait_completed_1_Production] ON SERVER;
GO

نکته کاربردی: برای wait_completed تعادل میان از دست ندادن رخداد و سربار را بر اساس حساسیت مسئله انتخاب کنید؛ همیشه Session آزمایشی را در بار مشابه تولید بسنجید.

بهترین روش‌های طراحی راهکار wait_completed

1. سؤال عیب‌یابی را پیش از انتخاب wait_completed بنویسید و مشخص کنید چه تصمیمی باید از داده حاصل شود.
2. نام Session، مسیر فایل و مدت فعال بودن wait_completed را استاندارد و قابل ردیابی انتخاب کنید.
3. Actionها را حداقلی نگه دارید و فقط داده‌ای را ثبت کنید که در تحلیل یا همبستگی استفاده خواهد شد.؛ با تمرکز اختصاصی بر wait_completed
4. زمان UTC رویداد را با ساعت برنامه، سیستم‌عامل و داشبورد هم‌تراز کنید.؛ با تمرکز اختصاصی بر wait_completed
5. پس از اصلاح، همان سناریو را تکرار و معیار قبل و بعد را با روش یکسان مقایسه کنید.؛ با تمرکز اختصاصی بر wait_completed
6. Sessionهای موقت را حذف کنید و برای Sessionهای دائمی مالک، هدف، ظرفیت و بازبینی دوره‌ای تعیین کنید.؛ با تمرکز اختصاصی بر wait_completed

سؤالات متداول اختصاصی wait_completed

wait_completed دقیقاً چه زمانی برای تحلیل مفید است؟

هنگامی مفید است که مسئله شما به ثبت پایان انتظارهای قابل اندازه‌گیری مربوط باشد و لازم باشد داده واقعی اجرای SQL Server را با زمان، Session و متن درخواست تطبیق دهید.

آیا می‌توان wait_completed را برای آموزش مبتدیان استفاده کرد؟

بله، بهتر است آموزش با metadata، یک ring_buffer کوتاه و سپس خواندن XML شروع شود تا دانشجو بدون پیچیدگی زیاد چرخه کامل wait_completed را ببیند.

برای پروژه تجاری چه مدت wait_completed را فعال نگه داریم؟

مدت مناسب به نرخ رخداد و SLA وابسته است؛ معمولاً بازه کوتاه و هدفمند با فایل چرخشی بهتر از فعال‌سازی دائمی و بدون فیلتر است. این نکته در پرونده فنی wait_completed با داده همان رویداد ارزیابی می‌شود.

چگونه خروجی wait_completed را وارد داشبورد سازمانی کنیم؟

فایل‌های XEL را در یک فرآیند زمان‌بندی‌شده بخوانید، XML را به جدول Stage تبدیل کنید و سپس شاخص‌های موردنیاز را با کلید زمان، Session و پایگاه داده مدل کنید. این نکته در پرونده فنی wait_completed با داده همان رویداد ارزیابی می‌شود.

تفاوت wait_completed با wait_info چیست؟

wait_completed روی ثبت پایان انتظارهای قابل اندازه‌گیری تمرکز دارد، در حالی که wait_info زاویه دیگری از اجرای درخواست را ثبت می‌کند؛ ترکیب آن‌ها تصویر کامل‌تری می‌دهد.

برای راه‌اندازی پایش wait_completed چه خدماتی لازم است؟

در پروژه‌های حساس، طراحی Predicate، ظرفیت فایل، Parser XML، داشبورد و سیاست نگه‌داری باید متناسب با بار واقعی انجام شود و می‌توان از مشاوره یا اجرای تخصصی SQL Server استفاده کرد. این نکته در پرونده فنی wait_completed با داده همان رویداد ارزیابی می‌شود.

رایج‌ترین خطا هنگام ساخت Session wait_completed چیست؟

استفاده از نام ستون یا Predicate بدون بررسی metadata همان نسخه، فعال‌سازی بدون محدودیت و فراموش کردن توقف Session از خطاهای رایج هستند. این نکته در پرونده فنی wait_completed با داده همان رویداد ارزیابی می‌شود.

wait_completed چه اثری بر Performance دارد؟

اثر آن به نرخ رویداد، Actionها، Target و فیلتر بستگی دارد. نام و دسترس‌پذیری جزئیات این رویداد می‌تواند به نسخه و محیط SQL Server وابسته باشد؛ پیش از ساخت Session باید metadata همان سرور بررسی شود. بنابراین آزمایش سربار و تعیین آستانه ضروری است.

بهترین روش نگه‌داری داده wait_completed چیست؟

برای تحلیل پایدار از event_file چرخشی، مسیر امن، سقف حجم، آرشیو زمان‌دار و پاک‌سازی خودکار استفاده کنید و داده حساس را کنترل دسترسی دهید. این نکته در پرونده فنی wait_completed با داده همان رویداد ارزیابی می‌شود.

آیا wait_completed در همه نسخه‌های SQL Server یکسان است؟

خیر، رویدادها و ستون‌ها ممکن است میان نسخه‌ها، Editionها یا محیط‌های Managed تفاوت داشته باشند؛ sys.dm_xe_objects و sys.dm_xe_object_columns منبع نهایی همان سرور هستند. این نکته در پرونده فنی wait_completed با داده همان رویداد ارزیابی می‌شود.

سؤال‌های مصاحبه درباره wait_completed

1. چگونه وجود wait_completed و ستون‌های آن را روی نسخه هدف بررسی می‌کنید؟
2. چه زمانی ring_buffer را برای wait_completed انتخاب می‌کنید و چه زمانی event_file را؟
3. برای کاهش سربار wait_completed چه Predicate و Actionهایی پیشنهاد می‌دهید؟
4. چگونه داده XML مربوط به wait_completed را به گزارش جدولی تبدیل می‌کنید؟
5. چه رویدادهای همراهی برای تفسیر درست wait_completed لازم می‌دانید و چرا؟

چک‌لیست نهایی اجرای wait_completed

• تأیید metadata و سازگاری نسخه
• تعریف سؤال و آستانه جمع‌آوری
• انتخاب Target و سقف فایل
• آزمون سربار در بار مشابه
• ثبت زمان شروع و پایان
• تجزیه XML و حفظ نسخه خام
• مقایسه قبل و بعد از اصلاح
• حذف یا بازبینی Session پس از پایان؛ با تمرکز اختصاصی بر wait_completed

جمع‌بندی آموزش wait_completed

wait_completed زمانی ارزشمند است که به‌صورت هدفمند برای تمرکز بر انتظارهای پایان‌یافته، اندازه‌گیری duration و ساخت نمای زمانی از وقفه‌های یک Session یا عملیات مشخص استفاده شود. Session خوب، کوچک، قابل توقف، دارای خروجی قابل تحلیل و متصل به تصمیم فنی است. با اجرای مثال‌های این مقاله می‌توان از کشف metadata تا ساخت فایل XEL و تحلیل خروجی پیش رفت، سپس یافته‌ها را با wait_info و blocked_process_report تکمیل کرد.

برای مقایسه این Event با سایر رخدادها، دوباره به مقاله مادر رویدادهای مهم Performance در SQL Server بازگردید. این نکته در پرونده فنی wait_completed با داده همان رویداد ارزیابی می‌شود.

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

برنامه‌نویسی در اصفهان

قبول سفارش‌های برنامه‌نویسی و پایگاه داده: 09131253620؛ ویژه wait_completed

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

مجموعه‌ای معتبر با سابقه فعالیت حرفه‌ای از سال ۱۳۷۵ شمسی؛ ویژه wait_completed

از سال ۱۳۷۵ شمسی تاکنون در زمینه طراحی و اجرای پروژه‌های برنامه‌نویسی، پایگاه داده، سیستم‌های تحت وب، وب‌سایت و راهکارهای نرم‌افزاری فعالیت می‌کنیم. این نکته در پرونده فنی wait_completed با داده همان رویداد ارزیابی می‌شود.

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

برای سفارش پروژه‌های برنامه‌نویسی و پایگاه داده، سیستم‌های تحت وب، وب‌سایت و راهکارهای نرم‌افزاری جدید، با شماره تلفن همراه 09131253620 تماس حاصل فرمایید. این نکته در پرونده فنی wait_completed با داده همان رویداد ارزیابی می‌شود.

ایتا، واتساپ و تماس مستقیم: +989131253620 این نکته در پرونده فنی wait_completed با داده همان رویداد ارزیابی می‌شود.

تماس با ما