آموزش جامع sys.query_store_query_text در SQL Server؛ از ساختار تا تحلیل عملی

sys.query_store_query_text چیست و چه اطلاعاتی می‌دهد؟

متن T-SQL، شناسه متن، هندل عبارت و وضعیت متن محدود یا رمزگذاری‌شده را نگهداری می‌کند. در عمل، این نما بخشی از زنجیره‌ای است که از متن Query شروع می‌شود، به هویت منطقی و طرح اجرایی می‌رسد و در نهایت آمار اجرا، انتظارها یا تنظیمات مدیریتی را قابل مشاهده می‌کند.

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

ساختار، ستون‌های کلیدی و ارتباط‌ها

ستون‌های مهم این نما عبارت‌اند از query_text_id، query_sql_text، statement_sql_handle، is_part_of_encrypted_module، has_restricted_text. همه ستون‌ها در هر سناریو لازم نیستند؛ انتخاب باید بر اساس سؤال تحلیلی انجام شود.

• query_text_id: یکی از ستون‌های کلیدی برای شناسایی، فیلتر، اتصال یا تفسیر خروجی.
• query_sql_text: یکی از ستون‌های کلیدی برای شناسایی، فیلتر، اتصال یا تفسیر خروجی.
• statement_sql_handle: یکی از ستون‌های کلیدی برای شناسایی، فیلتر، اتصال یا تفسیر خروجی.
• is_part_of_encrypted_module: یکی از ستون‌های کلیدی برای شناسایی، فیلتر، اتصال یا تفسیر خروجی.
• has_restricted_text: یکی از ستون‌های کلیدی برای شناسایی، فیلتر، اتصال یا تفسیر خروجی.

رابطه اصلی با سایر نماها چنین است: از طریق query_text_id به sys.query_store_query متصل می‌شود. این رابطه باید با کلیدهای رسمی برقرار شود تا ضرب ردیف، شمارش تکراری یا نسبت‌دادن اشتباه آمار رخ ندهد.

تصویر نخست، جایگاه sys.query_store_query_text، ستون‌های محوری و مسیر ارتباط آن با تحلیل Query Store را نشان می‌دهد.

نحو پایه و پیش‌نیازهای دسترسی

این موضوع یک Catalog View است و مانند جدول با SELECT خوانده می‌شود. نام قابل استفاده در Queryهای این مقاله «sys.query_store_query_text» است.

SELECT TOP (20)
    query_text_id,
    query_sql_text
FROM sys.query_store_query_text
ORDER BY query_text_id DESC;

برای مشاهده داده‌های Query Store معمولاً مجوزهای مشاهده وضعیت یا عملکرد پایگاه داده لازم است. سطح مجوز دقیق به نسخه SQL Server وابسته است؛ بنابراین اسکریپت تولیدی بهتر است با حساب کم‌اختیار آزمایش و سپس حداقل مجوز لازم مستند شود.

ده مثال عملی و مستقل

SELECT TOP (10) *
FROM sys.query_store_query_text
ORDER BY 1 DESC;

SELECT TOP (20)
    query_text_id,
    query_sql_text
FROM sys.query_store_query_text
ORDER BY query_text_id DESC;

DECLARE @TargetId bigint = 1;

SELECT *
FROM sys.query_store_query_text
WHERE query_text_id = @TargetId;

تصویر دوم، جریان انتخاب داده، فیلتر، اتصال و تبدیل خروجی sys.query_store_query_text به گزارش فنی را نمایش می‌دهد.

SELECT TOP (25)
    q.query_id,
    qt.query_text_id,
    qt.query_sql_text,
    q.count_compiles
FROM sys.query_store_query_text AS qt
INNER JOIN sys.query_store_query AS q
    ON q.query_text_id = qt.query_text_id
ORDER BY q.count_compiles DESC;

SELECT TOP (20)
    query_text_id,
    COALESCE(CONVERT(nvarchar(4000), query_sql_text), N'بدون مقدار') AS safe_value
FROM sys.query_store_query_text
ORDER BY query_text_id DESC;

IF OBJECT_ID(N'sys.query_store_query_text', N'V') IS NULL
BEGIN
    SELECT N'این نما در نسخه یا پیکربندی فعلی در دسترس نیست.' AS message;
END
ELSE
BEGIN
    SELECT TOP (5) *
    FROM sys.query_store_query_text;
END;

DECLARE @Pattern nvarchar(200) = N'%Orders%';
SELECT TOP (50)
    query_text_id,
    query_sql_text
FROM sys.query_store_query_text
WHERE query_sql_text LIKE @Pattern
ORDER BY query_text_id DESC;

تصویر سوم، تفاوت خواندن گسترده با روش فیلترشده و قابل اتکا برای sys.query_store_query_text را مقایسه می‌کند.

-- روش نامناسب برای اجرای پرتکرار
SELECT *
FROM sys.query_store_query_text;

-- نسخه کنترل‌شده
SELECT TOP (100)
    query_text_id,
    query_sql_text
FROM sys.query_store_query_text
WHERE query_text_id IS NOT NULL
ORDER BY query_text_id DESC;

DECLARE @RowLimit int = 50;

SELECT TOP (@RowLimit)
    query_text_id,
    query_sql_text
FROM sys.query_store_query_text
WHERE query_text_id IS NOT NULL
ORDER BY query_text_id DESC
OPTION (RECOMPILE);

DECLARE @AvailableRows bigint;

SELECT @AvailableRows = COUNT_BIG(*)
FROM sys.query_store_query_text;

SELECT
    @AvailableRows AS available_rows,
    CASE
        WHEN @AvailableRows = 0 THEN N'داده‌ای ثبت نشده است'
        ELSE N'داده برای تحلیل موجود است'
    END AS status_message;

خطاهای رایج

• فرض اینکه هر ردیف sys.query_store_query_text به‌تنهایی تصویر کامل عملکرد را نشان می‌دهد؛ در حالی که Join با لایه‌های مرتبط لازم است.
• جست‌وجوی LIKE با الگوی آغازشونده با درصد روی متن‌های فراوان می‌تواند پرهزینه باشد و متن ماژول رمزگذاری‌شده قابل بازیابی نیست.
• جمع‌کردن میانگین‌ها بدون توجه به وزن تعداد اجرا یا بازه زمانی.
• اجرای Query بدون فیلتر روی پایگاه داده پرترافیک و انتقال خروجی حجیم به ابزار گزارش‌گیری.
• نادیده‌گرفتن تفاوت نسخه‌ها و استفاده از ستون یا نمایی که در مقصد وجود ندارد.

ملاحظات کارایی و بهترین روش‌ها

ابتدا با شناسه، بازه زمانی یا آمار اجرا دامنه را محدود کنید و سپس متن کامل را بخوانید.

1. سؤال تحلیلی را قبل از نوشتن Query مشخص کنید؛ گزارش بدون سؤال فقط حجم داده تولید می‌کند.
2. ابتدا شناسه‌ها و بازه‌های لازم را محدود کنید و ستون‌های سنگین را در مرحله آخر بخوانید.
3. برای روندهای تاریخی، Snapshot کنترل‌شده با زمان نمونه‌برداری بسازید و از کپی کامل داده خام بپرهیزید.
4. Query تحلیلی را روی محیط مشابه تولید آزمایش کنید و هزینه IO، CPU و زمان را ثبت کنید.
5. هر Hint، Plan Forcing یا تغییر تنظیمات را با خط مبنا، مسئول تغییر و برنامه بازگشت مستند کنید.

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

فرض کنید سامانه فروش در ساعات اوج کند می‌شود. تیم پشتیبانی ابتدا query_id یا plan_idهای پرهزینه را پیدا می‌کند، سپس از sys.query_store_query_text برای ردیابی متن دقیق یک گزارش کند و یافتن عبارت‌هایی که الگوی خاصی از نام جدول یا پارامتر را دارند. استفاده می‌کند. خروجی با متن Query، Plan، آمار Runtime و Waitها تطبیق داده می‌شود تا مشخص شود مشکل از تغییر طرح، افزایش حجم، قفل، IO، حافظه یا تنظیم مدیریتی است.

در مرحله بعد یک گزارش دوره‌ای ساخته می‌شود که فقط انحراف‌های معنادار را نگهداری می‌کند. این رویکرد از انباشته‌شدن داده بی‌مصرف جلوگیری می‌کند و زمان واکنش تیم را کاهش می‌دهد. معیار موفقیت نیز باید قابل اندازه‌گیری باشد؛ برای نمونه کاهش صدک ۹۵ مدت اجرا، افت CPU یا حذف بازگشت مکرر به طرح نامطلوب.

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

sys.query_store_query_text دقیقاً چه مسئله‌ای را حل می‌کند؟

این نما متن T-SQL، شناسه متن، هندل عبارت و وضعیت متن محدود یا رمزگذاری‌شده را نگهداری می‌کند. و برای تبدیل داده‌های داخلی Query Store به گزارش قابل تحلیل استفاده می‌شود.

برای شروع کار با sys.query_store_query_text کدام ستون‌ها مهم‌ترند؟

ستون‌های query_text_id، query_sql_text، statement_sql_handle، is_part_of_encrypted_module نقطه شروع مناسبی هستند؛ سپس بر اساس سناریو ستون‌های تکمیلی افزوده می‌شوند.

آیا استفاده از sys.query_store_query_text برای گزارش مدیریتی مناسب است؟

بله، به شرط آنکه داده فنی خام به شاخص‌هایی مانند روند، رتبه، تغییر نسبت به بازه قبل و اقدام پیشنهادی تبدیل شود.

چطور می‌توان از داده sys.query_store_query_text در پروژه سازمانی استفاده کرد؟

می‌توان یک Job جمع‌آوری، جدول Snapshot و داشبورد ساخت تا سناریوی «ردیابی متن دقیق یک گزارش کند و یافتن عبارت‌هایی که الگوی خاصی از نام جدول یا پارامتر را دارند.» به‌صورت دوره‌ای پایش شود.

sys.query_store_query_text با نماهای دیگر Query Store چه تفاوتی دارد؟

تمرکز این نما روی «متن پرس‌وجوهای ثبت‌شده در Query Store» است؛ در حالی که نماهای متن، query، plan، runtime و wait هر کدام لایه متفاوتی از زنجیره تحلیل را ارائه می‌کنند.

برای پیاده‌سازی گزارش حرفه‌ای sys.query_store_query_text چه خدمتی لازم است؟

طراحی Query، مدل نگهداری Snapshot، کنترل دسترسی، ساخت داشبورد و تعریف آستانه هشدار معمولاً به تحلیل و پیاده‌سازی تخصصی SQL Server نیاز دارد.

رایج‌ترین خطا در کار با sys.query_store_query_text چیست؟

جست‌وجوی LIKE با الگوی آغازشونده با درصد روی متن‌های فراوان می‌تواند پرهزینه باشد و متن ماژول رمزگذاری‌شده قابل بازیابی نیست.

مهم‌ترین نکته Performance برای sys.query_store_query_text چیست؟

ابتدا با شناسه، بازه زمانی یا آمار اجرا دامنه را محدود کنید و سپس متن کامل را بخوانید.

بهترین روش نگهداری گزارش‌های مبتنی بر sys.query_store_query_text چیست؟

خروجی خام را بی‌هدف کپی نکنید؛ فقط شاخص‌های موردنیاز را با زمان نمونه‌برداری، شناسه پایگاه داده و نسخه موتور در جدول تاریخچه ذخیره کنید.

sys.query_store_query_text در چه نسخه‌هایی در دسترس است؟

SQL Server 2016 و نسخه‌های بعدی. پیش از استقرار اسکریپت روی چند سرور، وجود نما و ستون‌های مورد استفاده را کنترل کنید.

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

1. توضیح دهید sys.query_store_query_text چه داده‌ای می‌دهد و در چه مرحله‌ای از تحلیل Query Store استفاده می‌شود.
2. کلید اصلی اتصال sys.query_store_query_text به نمای مکمل چیست و Join اشتباه چه اثری دارد؟
3. چگونه یک Query پرهزینه روی sys.query_store_query_text را به نسخه سبک‌تر تبدیل می‌کنید؟
4. برای کنترل سازگاری نسخه sys.query_store_query_text چه الگویی پیشنهاد می‌دهید؟
5. چگونه نتیجه حاصل از sys.query_store_query_text را با آمار Runtime یا Waitها اعتبارسنجی می‌کنید؟

چک‌لیست نهایی

1. فعال بودن Query Store و وجود داده کنترل شده است.
2. وجود نمای sys.query_store_query_text و ستون‌های مورد استفاده بررسی شده است.
3. فیلتر شناسه و بازه زمانی قبل از Joinهای سنگین اعمال شده است.
4. خروجی نمونه با متن Query، Plan یا شاخص مکمل تطبیق داده شده است.
5. نتیجه، فرضیه و اقدام پیشنهادی به‌صورت قابل ممیزی ثبت شده است.