مقدمه

متد modify() با زبان XML DML یک تغییر insert، delete یا replace value of را روی مقدار xml انجام می‌دهد و فقط در SET دستور UPDATE یا روی متغیر xml قابل استفاده است. شناخت دقیق نقش این متد باعث می‌شود میان پردازش رابطه‌ای و XQuery مرز روشنی ایجاد شود و Query به‌جای تبدیل‌های ضمنی و رفتار حدسی، خروجی قابل پیش‌بینی داشته باشد.

در این مقاله از مثال‌های کوچک شروع می‌کنیم و سپس به جدول، شرط، NULL، حالت مرزی، سناریوی سازمانی، خطای رایج و نکته کارایی می‌رسیم. همه Queryها مستقل و قابل اجرا هستند و نتیجه نمونه کنار هر کد آمده است تا بتوانید رفتار را در SSMS سریع کنترل کنید.

بازگشت به راهنمای جامع توابع XML در SQL Server

تعریف و مدل ذهنی modify()

متد modify() با زبان XML DML یک تغییر insert، delete یا replace value of را روی مقدار xml انجام می‌دهد و فقط در SET دستور UPDATE یا روی متغیر xml قابل استفاده است.

insert می‌تواند گره را as first، as last، before یا after مقصد درج کند.

delete همه گره‌های مطابق عبارت را حذف می‌کند؛ انتخاب دقیق برای جلوگیری از حذف گسترده ضروری است.

نحو استاندارد

SET xml_variable.modify('XML_DML');
UPDATE TableName SET XmlColumn.modify('XML_DML') WHERE ...;

پارامترها

نوع خروجی

متد مقدار قابل SELECT برنمی‌گرداند و اثر جانبی آن تغییر نمونه xml است. روی مقدار SQL NULL قابل اجرا نیست و Context برگشتی از nodes() نیز مستقیم قابل ویرایش نیست.

نکات فنی پایه

• insert می‌تواند گره را as first، as last، before یا after مقصد درج کند.
• delete همه گره‌های مطابق عبارت را حذف می‌کند؛ انتخاب دقیق برای جلوگیری از حذف گسترده ضروری است.
• replace value of باید حداکثر یک گره اتمی را هدف بگیرد و معمولاً [1] لازم دارد.
• برای مقدار پویا می‌توان sql:variable() یا sql:column() را در جای مجاز XML DML استفاده کرد.

مثال‌های عملی از مقدماتی تا حرفه‌ای

مثال 1: درج Element جدید

عنصر status به انتهای order افزوده می‌شود.

DECLARE @x xml=N'<order id="1" />';
SET @x.modify('insert <status>new</status> as last into (/order)[1]');
SELECT @x AS Result;

نکته کاربردی: مقصد insert باید یک گره مشخص باشد؛ (/order)[1] تک‌مقداری بودن را روشن می‌کند.

مثال 2: درج Attribute

Attribute وضعیت به عنصر موجود اضافه می‌شود.

DECLARE @x xml=N'<order id="1" />';
SET @x.modify('insert attribute state {"open"} into (/order)[1]');
SELECT @x AS Result;

نکته کاربردی: پیش از درج Attribute تکراری، نبود آن را با exist() بررسی کنید.

مثال 3: به‌روزرسانی ستون جدول

وضعیت XML فقط برای سفارش رابطه‌ای مشخص تغییر می‌کند.

DECLARE @T table(ID int, Doc xml);
INSERT INTO @T VALUES(1,N'<o><status>new</status></o>'),(2,N'<o><status>new</status></o>');
UPDATE @T
SET Doc.modify('replace value of (/o/status/text())[1] with "done"')
WHERE ID=1;
SELECT * FROM @T;

نکته کاربردی: Predicate رابطه‌ای دقیق از تغییر ناخواسته چند ردیف جلوگیری می‌کند.

مثال 4: حذف گره حساس

عنصر token پیش از اشتراک‌گذاری سند حذف می‌شود.

DECLARE @x xml=N'<user><name>Ali</name><token>secret</token></user>';
SET @x.modify('delete /user/token');
SELECT @x AS Sanitized;

نکته کاربردی: حذف داده حساس بهتر است روی یک کپی یا در لایه خروجی انجام شود تا داده مرجع ناخواسته از بین نرود.

مثال 5: جایگزینی با متغیر SQL

مبلغ جدید از پارامتر T-SQL به XML DML منتقل می‌شود.

DECLARE @amount decimal(10,2)=175.50;
DECLARE @x xml=N'<order><total>100.00</total></order>';
SET @x.modify('replace value of (/order/total/text())[1] with sql:variable("@amount")');
SELECT @x AS Result;

نکته کاربردی: sql:variable() از ساخت عبارت XML DML با الحاق رشته جلوگیری می‌کند.

مثال 6: مدیریت XML برابر NULL

پیش از modify() برای نمونه تهی یک ریشه معتبر می‌سازیم.

DECLARE @x xml=NULL;
SET @x=COALESCE(@x,CONVERT(xml,N'<settings/>'));
SET @x.modify('insert <theme>dark</theme> into (/settings)[1]');
SELECT @x AS Result;

نکته کاربردی: modify() روی NULL اجرا نمی‌شود؛ مقدار پایه باید با قرارداد داده سازگار باشد.

مثال 7: درج گره قبل از مقصد

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

DECLARE @x xml=N'<flow><step>payment</step></flow>';
SET @x.modify('insert <step>validation</step> before (/flow/step[1])[1]');
SELECT @x AS Result;

نکته کاربردی: before و after ترتیب عناصر را کنترل می‌کنند و مقصد باید یک گره منفرد باشد.

مثال 8: مهاجرت نسخه پیام

Attribute نسخه و عنصر جدید در دو فراخوانی کنترل‌شده اضافه می‌شوند.

DECLARE @x xml=N'<message version="1"><id>9</id></message>';
SET @x.modify('replace value of (/message/@version)[1] with "2"');
SET @x.modify('insert <source>migration</source> as last into (/message)[1]');
SELECT @x AS Result;

نکته کاربردی: هر modify() یک عبارت XML DML دارد؛ تغییرات چندمرحله‌ای روی جدول باید داخل Transaction باشند.

مثال 9: اصلاح هدف چندمقداری

برای تغییر فقط نخستین tag، هدف با [1] تک‌مقداری می‌شود.

DECLARE @x xml=N'<r><tag>A</tag><tag>B</tag></r>';
SET @x.modify('replace value of (/r/tag/text())[1] with "X"');
SELECT @x AS Result;

نکته کاربردی: اگر همه گره‌ها باید تغییر کنند، XML DML را با منطق مرحله‌ای یا بازسازی سند طراحی کنید.

مثال 10: Update شرطی برای کاهش نوشتن

فقط اسنادی که status قدیمی دارند تغییر می‌کنند.

DECLARE @T table(ID int, Doc xml);
INSERT INTO @T VALUES(1,N'<o><status>old</status></o>'),(2,N'<o><status>new</status></o>');
UPDATE @T
SET Doc.modify('replace value of (/o/status/text())[1] with "new"')
WHERE Doc.exist('/o/status[text()="old"]')=1;
SELECT * FROM @T;

نکته کاربردی: Predicate exist() از Update بدون تغییر و ثبت لاگ اضافه برای ردیف دوم جلوگیری می‌کند.

خطاهای رایج و روش تشخیص

عیب‌یابی modify() باید از نمونه XML واقعی و عبارت XQuery دقیق شروع شود. پیام خطا را همراه نوع ستون، Namespace، Compatibility Level و پارامترهای همان اجرا نگه دارید. بازنویسی تصادفی مسیر معمولاً علت را پنهان می‌کند و ممکن است نتیجه ظاهراً صحیح اما ناقص تولید کند.

• فراخوانی modify() روی XML برابر NULL خطا می‌دهد و باید ابتدا مقدار پایه ساخته شود.
• هدف چندمقداری در replace value of خطای singleton ایجاد می‌کند.
• حذف مسیر عمومی می‌تواند داده بیشتری از انتظار پاک کند.
• اجرای چند UPDATE جدا برای یک سند بزرگ باعث ثبت لاگ و بازنویسی مکرر می‌شود.

برای بازتولید، یک متغیر xml با کوچک‌ترین سندی که خطا را نشان می‌دهد بسازید، سپس هر بخش مسیر را جدا بررسی کنید. تفاوت SQL NULL، توالی خالی، گره متنی خالی و چند گره را در تست‌های مستقل قرار دهید. این چهار حالت در پروژه واقعی اغلب معنای کسب‌وکاری متفاوت دارند.

ملاحظات کارایی و ابزارهای اندازه‌گیری

هزینه modify() به اندازه سند، تعداد ردیف‌های ورودی، پیچیدگی مسیر، تعداد دفعات اجرای اپراتور و ایندکس‌های XML وابسته است. درصد هزینه نمایشی در Execution Plan به‌تنهایی معیار کافی نیست؛ Baseline قابل تکرار بسازید و مقدار CPU، Elapsed Time و Logical Reads را کنار تعداد ردیف واقعی ثبت کنید.

• تغییر XML عملیاتی بزرگ Log-intensive است؛ اندازه Transaction و رشد Log را پایش کنید.
• WHERE رابطه‌ای دقیق قرار دهید تا فقط ردیف هدف تغییر کند.
• قبل از تصمیم به XML، هزینه Updateهای پرتکرار را با مدل رابطه‌ای مقایسه کنید.
• XML Indexها خواندن را سریع می‌کنند اما هزینه نوشتن modify() را افزایش می‌دهند؛ توازن را با workload واقعی بسنجید.

برای آزمایش محلی از SET STATISTICS IO,TIME ON و Actual Execution Plan استفاده کنید. برای مشاهده روند در محیط پایدار Query Store مفید است و Extended Events می‌تواند اجرای کند یا خطاهای منتخب را بدون Trace گسترده ثبت کند. هر تغییر ایندکس باید هم مسیر خواندن و هم سربار نوشتن، Backup و فضای ذخیره‌سازی را پوشش دهد.

بهترین روش‌ها

• پیش از تغییر، Backup منطقی یا نسخه قبلی سند را در Audit نگه دارید.
• شرط exist() را در WHERE قرار دهید تا Update فقط روی مقصد موجود اجرا شود.
• برای مقدارهای ورودی از sql:variable() استفاده و از الحاق رشته پرهیز کنید.
• تغییرات چندمرحله‌ای حساس را در Transaction و با کنترل @@ROWCOUNT اجرا کنید.

بهترین راه استفاده پایدار از modify() این است که قرارداد داده و Query کنار هم نسخه‌بندی شوند. اگر تولیدکننده XML ساختار یا Namespace را عوض کند، تست‌های یکپارچه باید پیش از انتشار شکست را آشکار کنند. نمونه‌های مرزی را از رخدادهای واقعی پشتیبانی جمع کنید و به Regression Suite بیفزایید.

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

modify() در سناریوهایی مانند افزودن وضعیت به پیام، اصلاح مبلغ یا نام، حذف داده حساس، درج آیتم جدید در سفارش، مهاجرت نسخه ساختار XML کاربرد دارد. بااین‌حال وجود XML به‌معنی اجرای همه منطق داخل XQuery نیست. کلیدهای پرتکرار، تاریخ‌های فیلتر، وضعیت و ستون‌های Join معمولاً باید رابطه‌ای باشند یا هنگام ورود داده استخراج شوند.

در سامانه سازمانی، دسترسی به داده XML باید از Stored Procedure یا View کنترل‌شده عبور کند، ورودی اعتبارسنجی شود و عملیات نوشتن Audit داشته باشد. برای تصمیم خرید سخت‌افزار یا طراحی ایندکس، ابتدا Queryهای پرتکرار و حجم رشد واقعی را اندازه‌گیری کنید؛ بهینه‌سازی بدون Baseline به‌سادگی هزینه را از یک بخش به بخش دیگر منتقل می‌کند.

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

۱. modify() در SQL Server دقیقاً چه کاری انجام می‌دهد؟

متد modify() با زبان XML DML یک تغییر insert، delete یا replace value of را روی مقدار xml انجام می‌دهد و فقط در SET دستور UPDATE یا روی متغیر xml قابل استفاده است. انتخاب این متد باید بر اساس نوع خروجی موردنیاز باشد، نه صرفاً کوتاه‌تر بودن Query.

۲. مهم‌ترین نکته آموزشی هنگام نوشتن modify() چیست؟

insert می‌تواند گره را as first، as last، before یا after مقصد درج کند. بهتر است این قاعده با تست‌های کوچک روی NULL، گره غایب و چند گره تثبیت شود.

۳. آیا آموزش سازمانی modify() برای تیم‌های داده ارزش تجاری دارد؟

بله؛ خطا در استفاده از modify() می‌تواند هزینه پردازش، خطای گزارش و زمان پشتیبانی را بالا ببرد. یک کارگاه مبتنی بر Queryهای واقعی سازمان معمولاً سریع‌تر از آموزش صرفاً نظری به نتیجه می‌رسد.

۴. چه زمانی بازبینی حرفه‌ای Queryهای modify() مقرون‌به‌صرفه است؟

وقتی جدول بزرگ، XML Index، گزارش حساس یا SLA جدی دارید، بازبینی Execution Plan و اندازه‌گیری CPU و Logical Reads می‌تواند هزینه توسعه و زیرساخت را کاهش دهد.

۵. modify() با متدهای دیگر XML چه تفاوتی دارد؟

modify() برای «ویرایش داده XML با XML DML» طراحی شده است؛ value() اسکالر می‌دهد، query() قطعه XML می‌سازد، exist() وجود را می‌آزماید، nodes() ردیف تولید می‌کند و modify() داده را تغییر می‌دهد.

۶. برای پیاده‌سازی modify() در یک پروژه واقعی از کجا شروع کنیم؟

ابتدا قرارداد XML، Namespace، حجم اسناد و Queryهای پرتکرار را ثبت کنید؛ سپس نمونه کوچک، تست صحت، Baseline کارایی و برنامه استقرار مرحله‌ای بسازید. در پروژه حساس، مشاوره SQL Server باید مبتنی بر همین شواهد باشد.

۷. خطای رایج modify() چیست؟

فراخوانی modify() روی XML برابر NULL خطا می‌دهد و باید ابتدا مقدار پایه ساخته شود. پیام خطا، XQuery دقیق و نمونه XML مسئله‌دار را کنار هم نگه دارید تا علت به‌جای حدس‌زدن قابل بازتولید باشد.

۸. چگونه Performance متد modify() را بررسی کنیم؟

تغییر XML عملیاتی بزرگ Log-intensive است؛ اندازه Transaction و رشد Log را پایش کنید. از SET STATISTICS IO,TIME ON، Actual Execution Plan و Query Store برای مقایسه قبل و بعد استفاده کنید.

۹. بهترین روش استفاده از modify() چیست؟

پیش از تغییر، Backup منطقی یا نسخه قبلی سند را در Audit نگه دارید. علاوه بر آن، تست واحد داده‌های مرزی و مستندسازی Namespace مانع بازگشت خطا در نسخه‌های بعد می‌شود.

۱۰. modify() با کدام نسخه‌های SQL Server سازگار است؟

متدهای نوع داده xml از SQL Server 2005 در دسترس‌اند، اما رفتار دقیق Optimizer و مزیت ایندکس‌ها را باید روی نسخه و Compatibility Level محیط مقصد آزمایش کرد. پیش از مهاجرت نیز Regression Test اجرا کنید.

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

1. نقش اصلی modify() چیست و نوع خروجی آن چه اثری بر انتخاب متد دارد؟
2. رفتار modify() با SQL NULL و مسیر بدون نتیجه چگونه است؟
3. Static Typing یا Context Item چه محدودیتی برای modify() ایجاد می‌کند؟
4. یک خطای رایج modify() را چگونه با نمونه حداقلی بازتولید می‌کنید؟
5. برای سنجش Performance متد modify() چه شاخص‌ها و ابزارهایی به کار می‌برید؟
6. چه زمانی مدل رابطه‌ای را به استفاده بیشتر از modify() ترجیح می‌دهید؟

در پاسخ حرفه‌ای، فقط Syntax کافی نیست. نام بردن از یک Trade-off، یک حالت مرزی و یک روش اندازه‌گیری نشان می‌دهد داوطلب تجربه طراحی و عملیات واقعی دارد.

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

• نقش modify() با نوع خروجی موردنیاز منطبق است.
• Namespace و Context مسیر صریح و تست‌شده‌اند.
• حالت‌های NULL، گره غایب، چند گره و مقدار نامعتبر تست شده‌اند.
• Query روی داده نماینده با Actual Plan و STATISTICS IO,TIME سنجیده شده است.
• ساخت XML Index فقط با مقایسه قبل و بعد انجام شده است.
• امنیت، مجوز، Audit و قرارداد تغییر ساختار مستند هستند.

جمع‌بندی

متد modify() با زبان XML DML یک تغییر insert، delete یا replace value of را روی مقدار xml انجام می‌دهد و فقط در SET دستور UPDATE یا روی متغیر xml قابل استفاده است. استفاده درست از آن نیازمند فهم توالی XQuery، نوع خروجی، Namespace و رفتار داده‌های مرزی است. ده مثال این مقاله الگوهای خواندن، شرط، جدول، NULL، خطا و Performance را در قالب قابل اجرای SQL Server پوشش دادند.

برای مقایسه این متد با چهار متد دیگر و انتخاب معماری مناسب، راهنمای جامع توابع XML در SQL Server را مطالعه کنید. پیش از انتقال هر Query به محیط تولید، آن را با حجم و توزیع داده واقعی، Plan واقعی و سیاست امنیتی همان سامانه اعتبارسنجی کنید.