replace value of (XML DML)

Статья
06/18/2013

Обновляет значение узла в документе.

Синтаксис

replace value of 
      Expression1 
with
      Expression2

Аргументы

Expression1
Определяет узел, значение которого должно быть обновлено. Оно должно определять только один узел. Таким образом, Expression1 должно быть статическим одноэлементным. Если XML типизирован, тип узла должен быть простым типом. Выбор нескольких узлов вызовет ошибку. Если Expression1 возвращает пустую последовательность, то замены значения не произойдет и не будет возвращено сообщение об ошибке. Expression1 должно возвратить одиночный элемент, имеющий простое типизированное содержимое (список или атомарные типы), текстовый узел или узел атрибута. Expression1 не может быть типом объединения, сложным типом, инструкцией по обработке, узлом документа или узлом комментария. Если же оно является чем-либо из вышеперечисленного, будет возвращена ошибка.
Expression2
Определяет новое значение узла. Он может быть выражением, которое возвращает простой типизированный узел, потому что data() будет использоваться неявно. Если значение — это список значений, инструкция update заменит старое значение списком. При изменении типизированного экземпляра XML выражение Expression2 должно быть такого же типа или подтипа, что и выражение Expression1. В противном случае возвращается ошибка. При изменении нетипизированного экземпляра XML Expression2 должно быть выражением, которое может быть атомизировано. Иначе возвращается ошибка.

Примеры

Следующие примеры инструкции замещения значения XML DML иллюстрируют, как обновить узлы в документе XML.

А.Замена значений в экземпляре XML

В следующем примере экземпляр документа сначала будет назначен переменной типа xml. Затем инструкции замещения значения XML DML обновят значение в документе.

DECLARE @myDoc xml
SET @myDoc = '<Root>
<Location LocationID="10" 
            LaborHours="1.1"
            MachineHours=".2" >Manufacturing steps are described here.
<step>Manufacturing step 1 at this work center</step>
<step>Manufacturing step 2 at this work center</step>
</Location>
</Root>'
SELECT @myDoc

-- update text in the first manufacturing step
SET @myDoc.modify('
  replace value of (/Root/Location/step[1]/text())[1]
  with     "new text describing the manu step"
')
SELECT @myDoc
-- update attribute value
SET @myDoc.modify('
  replace value of (/Root/Location/@LaborHours)[1]
  with     "100.0"
')
SELECT @myDoc

Учтите, что обновляемый адресат должен быть, самое большее, одним узлом, который явно указан в выражении пути путем добавления «[1]» в конце выражения.

Б.Использование выражения «if» для определения замещающего значения

Можно указать выражение if в Expression2 инструкции замещения значения в XML DML , как показано в следующем примере. Expression1 определяет, что атрибут LaborHours первого рабочего центра должен быть обновлен. Expression2 использует выражение if для определения нового значения атрибута LaborHours.

DECLARE @myDoc xml
SET @myDoc = '<Root>
<Location LocationID="10" 
            LaborHours=".1"
            MachineHours=".2" >Manu steps are described here.
<step>Manufacturing step 1 at this work center</step>
<step>Manufacturing step 2 at this work center</step>
</Location>
</Root>'
--SELECT @myDoc

SET @myDoc.modify('
  replace value of (/Root/Location[1]/@LaborHours)[1]
  with (
       if (count(/Root/Location[1]/step) > 3) then
         "3.0"
       else
          "1.0"
      )
')
SELECT @myDoc

В.Обновление XML, сохраненного в нетипизированном столбце XML

Следующий пример обновляет XML, сохраненный в столбце:

drop table T
go
CREATE TABLE T (i int, x xml)
go
INSERT INTO T VALUES(1,'<Root>
<ProductDescription ProductID="1" ProductName="Road Bike">
<Features>
  <Warranty>1 year parts and labor</Warranty>
  <Maintenance>3 year parts and labor extended maintenance is available</Maintenance>
</Features>
</ProductDescription>
</Root>')
go
-- verify the current <ProductDescription> element
SELECT x.query(' /Root/ProductDescription')
FROM T
-- update the ProductName attribute value
UPDATE T
SET x.modify('
  replace value of (/Root/ProductDescription/@ProductName)[1]
  with "New Road Bike" ')
-- verify the update
SELECT x.query(' /Root/ProductDescription')
FROM T

Г.Обновление XML, сохраненного в типизированном столбце XML

Этот пример заменяет значения в документе производственных команд, сохраненном в типизированном столбце XML.

В примере сначала создается таблица (T) с типизированным столбцом XML в базе данных AdventureWorks. Затем копируются производственные инструкции экземпляра XML из столбца Instructions таблицы ProductModel в таблицу T. После этого вставленные данные применяются к XML в таблице T.

use AdventureWorks
go
drop table T
go
create table T(ProductModelID int primary key, 
Instructions xml (Production.ManuInstructionsSchemaCollection))
go
insert  T 
select ProductModelID, Instructions
from Production.ProductModel
where ProductModelID=7
go
--insert a new location - <Location 1000/>. 
update T
set Instructions.modify('
  declare namespace MI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";
insert <MI:Location LocationID="1000"  LaborHours="1000"  LotSize="1000" >
           <MI:step>Do something using <MI:tool>hammer</MI:tool></MI:step>
         </MI:Location>
  as first
  into   (/MI:root)[1]
')
go
select Instructions
from T
go
-- Now replace manu. tool in location 1000
update T
set Instructions.modify('
  declare namespace MI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";
  replace value of (/MI:root/MI:Location/MI:step/MI:tool)[1] 
  with   "screwdriver"
')
go
select Instructions
from T
-- Now replace value of lot size
update T
set Instructions.modify('
  declare namespace MI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";
  replace value of (/MI:root/MI:Location/@LotSize)[1] 
  with   500 cast as xs:decimal ?
')
go
select Instructions
from T

Обратите внимание на использование cast при замене значения LotSize. Это необходимо, когда значение должно иметь определенный тип. Если бы в этом примере значением было 500, явное приведение было бы не нужно.