Article
03/31/2012

replace value of (XML DML)

Met à jour la valeur d'un nœud dans le document.

Syntaxe

replace value of 
      Expression1 
with
      Expression2

Arguments

Expression1
Identifie un nœud dont la valeur doit être mise à jour. Un seul nœud doit être désigné, c'est-à-dire qu'Expression1 doit être un singleton statique. Si le XML est typé, le type du nœud doit être un type simple. Si plusieurs nœuds sont sélectionnés, une erreur est générée. Si Expression1 retourne une séquence vide, aucun remplacement de valeur n'a lieu et aucune erreur n'est retournée. Expression1 doit retourner un seul élément avec un contenu simplement typé (type liste ou atomique), un nœud de texte ou d'attribut. Expression1 ne peut pas être d'un type union ou complexe, elle ne peut pas correspondre à une instruction de traitement, à un nœud de document ou de commentaire. Sans quoi un message d'erreur est retourné.
Expression2
Identifie la nouvelle valeur du nœud. Ce peut être une expression retournant un nœud simplement typé, car data() sera utilisé implicitement. Si la valeur est en réalité une liste de valeurs, l'instruction update remplace l'ancienne valeur par la liste. En modifiant une instance XML typée, Expression2 doit être du même type que Expression1 ou un sous-type de ce type. Sinon, une erreur est retournée. En modifiant une instance XML non typée, Expression2 doit être une expression pouvant être atomisée. Sinon, une erreur est retournée.

Exemples

Les exemples ci-dessous de l'instruction XML DML replace value of illustrent comment mettre à jour des nœuds dans un document XML.

A. Remplacement de valeur dans une instance XML

Dans cet exemple, une instance de document est d'abord assignée à une variable de type xml. Ensuite, des instructions XML DML replace value of mettent à jour des valeurs dans le document.

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

Veuillez noter que la cible de la mise à jour doit être, tout au plus, un seul nœud explicitement spécifié dans l'expression de chemin d'accès par l'ajout de « [1] » à la fin de l'expression.

B. Utilisation de l'expression if pour déterminer la valeur de remplacement

Vous pouvez préciser l'expression if dans Expression2 de l'expression XML DML replace value of, comme dans l'exemple ci-dessous. Expression1 identifie l'attribut LaborHours du premier centre de travail comme étant la valeur à mettre à jour. Expression2 utilise une expression if pour déterminer la nouvelle valeur à affecter à cet attribut.

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

C. Mise à jour du code XML stocké dans une colonne XML non typée

L'exemple suivant met à jour du code XML dans une colonne.

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;

C. Mise à jour du code XML stocké dans une colonne XML typée

Cet exemple remplace des valeurs dans un document contenant des instructions de fabrication et stockées dans une colonne XML typée.

Vous créez d'abord une table (T) avec une colonne XML typée dans la base données AdventureWorks2008R2. Ensuite, vous copiez une instance XML des instructions de fabrication de la colonne Instructions dans la table ProductModel vers la table T. Les insertions sont ensuite appliquées à l'instance XML dans la table T.

use AdventureWorks2008R2;
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;

Il convient de noter l'emploi de cast lors du remplacement de la valeur de LotSize. Celui-ci est requis lorsque la valeur doit être d'un type spécifique. Dans cet exemple, si 500 était la valeur, une conversion explicite ne serait pas nécessaire.