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

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

فیلدهای مهمی که باید بر اساس metadata سرور بررسی شوند عبارت‌اند از duration، cpu_time، logical_reads، physical_reads، writes، row_count. این نام‌ها نقش راهنما دارند؛ چون نسخه نصب‌شده تعیین می‌کند هر ستون Data یا Action دقیقاً با چه نوعی در دسترس باشد. رویدادهای همراه پیشنهادی نیز sql_statement_completed، query_post_execution_showplan، error_reported، attention هستند. انتخاب هم‌زمان همه آن‌ها همیشه لازم نیست و باید از سؤال عیب‌یابی مشتق شود.

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

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

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

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

پیش از ساخت Session باید وجود رویداد، Package و توضیح ثبت‌شده روی همان سرور بررسی شود. این کار برای sql_batch_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'sql_batch_completed';

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

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

ستون‌های Event باید از metadata خوانده شوند تا فیلتر و تحلیل بر اساس فیلدهای واقعاً موجود انجام شود. در این مثال، ستون‌های پیشنهادی مانند duration, cpu_time, logical_reads, physical_reads, writes, row_count با تعریف سرور مقایسه می‌شوند.

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'sql_batch_completed'
ORDER BY c.column_id;

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

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

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

IF EXISTS (SELECT 1 FROM sys.server_event_sessions WHERE name = N'XE_sql_batch_completed_1')
    DROP EVENT SESSION [XE_sql_batch_completed_1] ON SERVER;
GO
CREATE EVENT SESSION [XE_sql_batch_completed_1] ON SERVER
ADD EVENT sqlserver.sql_batch_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 برای نمونه‌برداری سریع مناسب است؛ برای نگه‌داری طولانی یا حجم بالای sql_batch_completed بهتر است event_file انتخاب شود.

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

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

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

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

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

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

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

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

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

برای دیدن رخدادهای ring_buffer، داده Target به XML تبدیل می‌شود. این روش برای مشاهده سریع مناسب است و نیاز به فایل خارجی ندارد. این نکته در پرونده فنی sql_batch_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_sql_batch_completed_1'
  AND t.target_name = N'ring_buffer';

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

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

در Sessionهای پایدار، event_file قابلیت مرور و آرشیو مناسب‌تری دارد. این Query همه فایل‌های چرخشی مرتبط با sql_batch_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\sqlbatchcompleted_filtered*.xel',
    NULL, NULL, NULL
)
WHERE object_name = N'sql_batch_completed'
ORDER BY file_name, file_offset;

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

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

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

WITH EventData AS
(
    SELECT CAST(event_data AS xml) AS x
    FROM sys.fn_xe_file_target_read_file
    (N'C:\XE\sqlbatchcompleted_filtered*.xel', NULL, NULL, NULL)
    WHERE object_name = N'sql_batch_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 به‌صورت صریح انجام دهید.

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

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

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

یک Batch ممکن است چند دستور متفاوت داشته باشد؛ در نتیجه هزینه کلی را نشان می‌دهد اما الزاماً مشخص نمی‌کند کدام Statement عامل اصلی بوده است. هزینه Session فقط از نام Event تعیین نمی‌شود؛ تعداد رخداد در ثانیه، Actionهای انتخابی، Predicate، نوع Target، سرعت دیسک و MAX_DISPATCH_LATENCY همگی اثر دارند. بهترین روش، اجرای آزمایشی در بار مشابه تولید و مقایسه CPU، I/O، حجم XEL و نرخ از دست رفتن رخدادها است.

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

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

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

WITH Parsed AS
(
    SELECT
        CAST(event_data AS xml) AS x
    FROM sys.fn_xe_file_target_read_file
    (N'C:\XE\sqlbatchcompleted_filtered*.xel', NULL, NULL, NULL)
    WHERE object_name = N'sql_batch_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: پایش کم‌هزینه و قابل حذف برای sql_batch_completed

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

CREATE EVENT SESSION [XE_sql_batch_completed_1_Production] ON SERVER
ADD EVENT sqlserver.sql_batch_completed
(
    ACTION (sqlserver.database_id, sqlserver.session_id, sqlserver.client_app_name)
    WHERE ([duration] > (2000000))
)
ADD TARGET package0.event_file
(SET filename = N'C:\XE\sqlbatchcompleted_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_sql_batch_completed_1_Production] ON SERVER;
GO

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

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

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

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

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

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

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

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

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

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

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

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

تفاوت sql_batch_completed با sql_statement_completed چیست؟

sql_batch_completed روی پایان Batchهای کامل T-SQL تمرکز دارد، در حالی که sql_statement_completed زاویه دیگری از اجرای درخواست را ثبت می‌کند؛ ترکیب آن‌ها تصویر کامل‌تری می‌دهد.

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

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

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

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

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

اثر آن به نرخ رویداد، Actionها، Target و فیلتر بستگی دارد. یک Batch ممکن است چند دستور متفاوت داشته باشد؛ در نتیجه هزینه کلی را نشان می‌دهد اما الزاماً مشخص نمی‌کند کدام Statement عامل اصلی بوده است. بنابراین آزمایش سربار و تعیین آستانه ضروری است.

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

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

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

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

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

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

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

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

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

sql_batch_completed زمانی ارزشمند است که به‌صورت هدفمند برای اندازه‌گیری زمان، CPU، خواندن منطقی و تعداد ردیف در سطح Batch و مقایسه بارهای ارسالی از ابزارها یا برنامه‌ها استفاده شود. Session خوب، کوچک، قابل توقف، دارای خروجی قابل تحلیل و متصل به تصمیم فنی است. با اجرای مثال‌های این مقاله می‌توان از کشف metadata تا ساخت فایل XEL و تحلیل خروجی پیش رفت، سپس یافته‌ها را با sql_statement_completed و query_post_execution_showplan تکمیل کرد.

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

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

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

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

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

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

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

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

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

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

تماس با ما