通过

使用 XML updategram 插入数据 (SQLXML 4.0)

当记录实例出现在 <after> 块中但不在对应的 <before> 块中出现时，updategram 指示插入操作。这种情况下，updategram 将 <after> 块中的记录插入到数据库中。

以下是 updategram 的插入操作格式：

<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
  <updg:sync [mapping-schema="SampleSchema.xml"]  >
   [<updg:before>
   </updg:before>]
    <updg:after [updg:returnid="x y ...] >
       <ElementName [updg:id="value"] 
                   [updg:at-identity="x"] 
                   [updg:guid="y"]
                   attribute="value" 
                   attribute="value"
                   ...
       />
      [<ElementName .../>... ]
    </updg:after>
  </updg:sync>
</ROOT>

&lt;before&gt; 块

对于插入操作，可以省略 <before> 块。如果未指定可选的 mapping-schema 属性，则在 updategram 中指定的 <ElementName> 将映射到数据库表，并且相应子元素或属性将映射到表中的列。

&lt;after&gt; 块

可以在 <after> 块中指定一个或多个记录。

如果 <after> 块未为特定列提供值，则 updategram 将使用在带批注的架构（如果已指定架构）中指定的默认值。如果架构没有为该列指定默认值，则 updategram 不会为该列指定任何显式值，而是将 Microsoft SQL Server 默认值（如果已指定）分配给该列。如果没有 SQL Server 默认值并且此列接受 NULL 值，则 updategram 将此列的值设置为 NULL。如果此列既没有默认值也不接受 NULL 值，则命令将失败并且 updategram 将返回一个错误。如果要添加记录的表包含一个 IDENTITY 类型的列，则使用 updg:returnid 属性返回系统生成的标识值。

updg:id 属性

如果 updategram 只是要插入记录，则 updategram 不需要 updg:id 属性。有关 updg:id 的详细信息，请参阅 使用 XML Updategram 更新数据 (SQLXML 4.0)。

updg:at-identity 属性

如果 updategram 要在其中插入记录的表包含一个 IDENTITY 类型的列，则 updategram 可通过使用可选的 updg:at-identity 属性捕获系统分配的值。然后，updategram 可以在后续操作中使用此值。一旦执行 updategram，即可通过指定 updg:returnid 属性返回生成的标识值。

updg:guid 属性

updg:guid 属性是一个生成全局唯一标识符的可选属性。在指定了此值的整个 <sync> 块的作用域中，会始终保留此值。可以在 <sync> 块中的任何位置使用此值。该属性调用 NEWGUID()SQL Server 函数来生成唯一标识符。

示例

若要创建使用以下示例的工作示例，则必须满足运行 SQLXML 示例的要求 中指定的要求。

在使用 updategram 示例前，请注意以下事项：

  • 大多数示例使用默认映射（即，未在 updategram 中指定任何映射架构）。有关使用映射架构的 updategram 的更多示例，请参阅在 updategram 中指定带批注的映射架构 (SQLXML 4.0)。

  • 大多数示例使用 AdventureWorks 示例数据库。已对该数据库中的表应用所有更新。您可以还原 AdventureWorks 数据库。有关还原 AdventureWorks 数据库的信息，请参阅 AdventureWorks 示例数据库。

A. 使用 updategram 插入记录

这个以属性为中心的 updategram 在 AdventureWorks 数据库的 HumanResources.Employee 表中插入一条记录。

在此示例中，updategram 没有指定映射架构。因此，updategram 使用默认映射，在默认映射中，元素名称映射到表名，而属性或子元素则映射到该表中的列。

HumanResources.Employee 表的 AdventureWorks 架构对除 ManagerID 和 EmployeeID 之外的所有列施加了“not null”限制。所以，updategram 必须包括为上述两列以外的所有列指定的值。ManagerID 被省略，所以在执行 updategram 时它的值将为 NULL。EmployeeID 是一个 IDENTITY 类型的列。因此，没有为其指定任何值。

<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
  <updg:sync >
    <updg:before>
    </updg:before>
    <updg:after>
       <HumanResources.Employee 
            NationalIDNumber="111111111" 
            ContactID="1156" 
            LoginID="adventure-works\paulw0"
            DepartmentID="7" 
            ShiftID="3" 
            Title="Production Technician - WC40"
            EmergencyContactID="1445" 
            AddressID="157"   
            BirthDate="1970-12-15 00:00:00.000"
            MaritalStatus="S" 
            Gender="M" 
            HireDate="1999-01-05 00:00:00.000"
            SalariedFlag="0" 
            BaseRate="15.00"
            PayFrequency="1" 
            VacationHours="80" 
            SickLeaveHours="80" 
            CurrentFlag="1" 
            rowguid="00001111-2222-3333-4444-555566667777"
            ModifiedDate="1998-12-29 00:00:00.000"/>
    </updg:after>
  </updg:sync>
</ROOT>

针对该架构测试示例 XPath 查询

  1. 复制上面的 updategram，并将它粘贴到文本文件中。将文件另存为 MyUpdategram.xml。

  2. 创建并使用 SQLXML 4.0 测试脚本 (Sqlxml4test.vbs) 执行该模板。

    有关详细信息，请参阅使用 ADO 执行 SQLXML 4.0 查询。

在以元素为中心的映射中，updategram 类似于如下所示：

<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
  <updg:sync >
    <updg:before>
    </updg:before>
    <updg:after>
       <HumanResources.Employee>
            <NationalIDNumber>111111111</NationalIDNumber>
            <ContactID>1156</ContactID>
            <LoginID>adventure-works\paulw0</LoginID>
            <DepartmentID>7</DepartmentID>
            <ShiftID>3</ShiftID>
            <Title>Production Technician - WC40</Title>
            <EmergencyContactID>1445</EmergencyContactID>
            <AddressID>157</AddressID>
            <BirthDate>1970-12-15 00:00:00.000</BirthDate>
            <MaritalStatus>S</MaritalStatus>
            <Gender>M</Gender>
            <HireDate>1999-01-05 00:00:00.000</HireDate>
            <SalariedFlag>0</SalariedFlag>
            <BaseRate>15.00</BaseRate>
            <PayFrequency>1</PayFrequency>
            <VacationHours>80</VacationHours>
            <SickLeaveHours>80</SickLeaveHours>
            <CurrentFlag>1</CurrentFlag>
            <rowguid>00001111-2222-3333-4444-555566667777</rowguid>
            <ModifiedDate>1998-12-29 00:00:00.000</ModifiedDate>
       </HumanResources.Employee>
    </updg:after>
  </updg:sync>
</ROOT>

在混合模式（以元素为中心和以属性为中心）的 updategram 中，元素可以同时具有属性和子元素，如以下 updategram 所示：

<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
  <updg:sync >
    <updg:before>
    </updg:before>
    <updg:after>
       <HumanResources.Employee 
            NationalIDNumber="111111111" 
            ContactID="1156" 
            DepartmentID="7" 
            ShiftID="3" 
            EmergencyContactID="1445" 
            AddressID="157"   
            SalariedFlag="0" 
            BaseRate="15.00"
            PayFrequency="1" 
            VacationHours="80" 
            SickLeaveHours="80" 
            CurrentFlag="1">
            <LoginID>adventure-works\paulw0</LoginID>
            <Title>Production Technician - WC40</Title>
            <BirthDate>1970-12-15 00:00:00.000</BirthDate>
            <HireDate>1999-01-05 00:00:00.000</HireDate>
            <MaritalStatus>S</MaritalStatus>
            <Gender>M</Gender>
            <rowguid>00001111-2222-3333-4444-555566667777</rowguid>
            <ModifiedDate>1998-12-29 00:00:00.000</ModifiedDate>
       </HumanResources.Employee>
    </updg:after>
  </updg:sync>
</ROOT>

B. 使用 updategram 插入多个记录

此 updategram 向 HumanResources.Shift 表添加两个新的轮班记录。updategram 未指定可选的 <before> 块。

<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
  <updg:sync>
    <updg:after >
       <HumanResources.Shift Name="Day-Evening"
                        StartTime="1900-01-01 11:00:00.000"
                        EndTime="1900-01-01 19:00:00.000"
                        ModifiedDate="2004-01-01 00:00:00.000" />
       <HumanResources.Shift Name="Evening-Night"
                        StartTime="1900-01-01 19:00:00.000"
                        EndTime="1900-01-01 03:00:00.000"
                        ModifiedDate="2004-01-01 00:00:00.000" />
    </updg:after>
  </updg:sync>
</ROOT>

针对该架构测试示例 XPath 查询

  1. 复制上面的 updategram，并将它粘贴到文本文件中。将文件另存为 Updategram-AddShifts.xml。

  2. 创建并使用 SQLXML 4.0 测试脚本 (Sqlxml4test.vbs) 执行该模板。

    有关详细信息，请参阅使用 ADO 执行 SQLXML 4.0 查询。

此示例还有另一个版本，该版本的 updategram 使用两个单独的 <after> 块而不是一个块来插入两个雇员。这种做法是有效的，并且可以按照如下形式进行编码：

<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
  <updg:sync>
    <updg:after >
       <HumanResources.Shift Name="Day-Evening"
                        StartTime="1900-01-01 11:00:00.000"
                        EndTime="1900-01-01 19:00:00.000"
                        ModifiedDate="2004-01-01 00:00:00.000" />
    </updg:after>
    <updg:before>
    </updg:before>
    <updg:after >
       <HumanResources.Shift Name="Evening-Night"
                        StartTime="1900-01-01 19:00:00.000"
                        EndTime="1900-01-01 03:00:00.000"
                        ModifiedDate="2004-01-01 00:00:00.000" />
    </updg:after>
  </updg:sync>
</ROOT>

C. 使用在 XML 中无效的有效 SQL Server 字符

在 SQL Server 中，表名可以包括空格，例如 Northwind 数据库中的 Order Details 表。但是，在 XML 字符中这是无效的，这些字符是有效的 SQL Server 标识符，但不是能使用“__xHHHH__”编码为编码值的有效 XML 标识符，此处的 HHHH 代表字符的四位十六进制 UCS-2 代码，最高有效位排在最前面。

注意注意

此示例使用 Northwind 数据库，该数据库作为示例数据库最早随 SQL Server 2000 一起提供。后来的 SQL Server 版本没有附带 Northwind 数据库。但是，可以下载一个 SQL 脚本并使用它安装 Northwind 数据库。有关详细信息，请参阅下载 Northwind 和 pubs 示例数据库。

此外，元素名必须括在方括号 ([ ]) 内。由于字符 [ 和 ] 在 XML 中无效，因而必须将它们分别编码为 _x005B_ 和 _x005D_。（如果使用映射架构，可以提供不包含无效字符（如空格）的元素名。映射架构会执行必要的映射；因此，无需对这些字符进行编码。）

此 updategram 向 Northwind 数据库中的 Order Details 表添加一条记录：

<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
  <updg:sync >
    <updg:before>
    </updg:before>
    <updg:after>
      <_x005B_Order_x0020_Details_x005D_ OrderID="1"
            ProductID="11"
            UnitPrice="$1.0"
            Quantity="1"
            Discount="0.0" />
    </updg:after>
  </updg:sync>
</ROOT>

Order Details 表中的 UnitPrice 列的类型为 money。若要应用适当的类型转换（从 string 类型到 money 类型），必须将美元符号 ($) 添加为该值的一部分。如果 updategram 未指定映射架构，将对 string 值的第一个字符进行计算。如果第一个字符为美元符号 ($)，则会应用适当的转换。

如果是针对某个映射架构指定 updategram，并且在架构中该列相应地标记为 dt:type="fixed.14.4" 或 sql:datatype="money"，则不需要美元符号 ($) 映射就会处理转换。建议采用这种方式以确保能够进行适当的类型转换。

针对该架构测试示例 XPath 查询

  1. 复制上面的 updategram，并将它粘贴到文本文件中。将文件另存为 UpdategramSpacesInTableName.xml。

  2. 创建并使用 SQLXML 4.0 测试脚本 (Sqlxml4test.vbs) 执行该模板。

    有关详细信息，请参阅使用 ADO 执行 SQLXML 4.0 查询。

D. 使用 at-identity 属性检索已在 IDENTITY 类型的列中插入的值

以下 updategram 插入两条记录：在 Sales.SalesOrderHeader 表中插入一条记录而在 Sales.SalesOrderDetail 表中插入另一条记录。

首先，updategram 向 Sales.SalesOrderHeader 表中添加一条记录。在该表中，SalesOrderID 列为 IDENTITY 类型的列。因此，在向该表添加此记录时，updategram 使用 at-identity 属性将已赋值的 SalesOrderID 值捕获为“x”（占位符值）。然后，updategam 将此 at-identity 变量指定为 <Sales.SalesOrderDetail> 元素中 SalesOrderID 属性的值。

<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
 <updg:sync >
  <updg:before>
  </updg:before>
  <updg:after>
   <Sales.SalesOrderHeader updg:at-identity="x" 
             RevisionNumber="1"
             OrderDate="2001-07-01 00:00:00.000"
             DueDate="2001-07-13 00:00:00.000"
             OnlineOrderFlag="0"
             CustomerID="676"
             ContactID="378"
             BillToAddressID="985"
             ShipToAddressID="985"
             ShipMethodID="5"
             SubTotal="24643.9362"
             TaxAmt="1971.5149"
             Freight="616.0984"
             rowguid="00001111-2222-3333-4444-556677889900"
             ModifiedDate="2001-07-08 00:00:00.000" />
      <Sales.SalesOrderDetail SalesOrderID="x"
                LineNumber="1"
                OrderQty="1"
                ProductID="776"
                SpecialOfferID="1"
                UnitPrice="2429.9928"
                UnitPriceDiscount="0.00"
                rowguid="aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
                ModifiedDate="2001-07-01 00:00:00.000" />
    </updg:after>
  </updg:sync>
</ROOT>

如果要返回 updg:at-identity 属性生成的标识值，可以使用 updg:returnid 属性。以下是经过修改的返回此标识值的 updategram。（此 updategram 添加两条订单记录和两条订单详细信息记录，目的在于让示例变得稍微复杂一点。）

<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
 <updg:sync>
  <updg:before>
  </updg:before>
  <updg:after updg:returnid="x y" >
       <HumanResources.Shift updg:at-identity="x" Name="Day-Evening"
                        StartTime="1900-01-01 11:00:00.000"
                        EndTime="1900-01-01 19:00:00.000"
                        ModifiedDate="2004-01-01 00:00:00.000" />
       <HumanResources.Shift updg:at-identity="y" Name="Evening-Night"
                        StartTime="1900-01-01 19:00:00.000"
                        EndTime="1900-01-01 03:00:00.000"
                        ModifiedDate="2004-01-01 00:00:00.000" />
  </updg:after>
 </updg:sync>
</ROOT>

在执行 updategram 时，它会返回类似于如下的结果，包括生成的标识值（用于表标识的 ShiftID 列的生成值）：

<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram"> 
  <returnid> 
    <x>4</x> 
    <y>5</y> 
  </returnid> 
</ROOT>

针对该架构测试示例 XPath 查询

  1. 复制上面的 updategram，并将它粘贴到文本文件中。将文件另存为 Updategram-returnId.xml。

  2. 创建并使用 SQLXML 4.0 测试脚本 (Sqlxml4test.vbs) 执行该模板。

    有关详细信息，请参阅使用 ADO 执行 SQLXML 4.0 查询。

E. 使用 updg:guid 属性生成唯一值

在本示例中，updategram 在 Cust 和 CustOrder 表中插入一条新记录。此外，updategram 还使用 updg:guid 属性，为 CustomerID 属性生成唯一的值。

<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
  <updg:sync >
    <updg:before>
    </updg:before>
    <updg:after updg:returnid="x" >
      <Cust updg:guid="x" >
         <CustID>x</CustID>
         <LastName>Fuller</LastName>
      </Cust>
      <CustOrder>
         <CustID>x</CustID>
         <OrderID>1</OrderID>
      </CustOrder>
    </updg:after>
  </updg:sync>
</ROOT>

updategram 指定 returnid 属性。生成的 GUID 作为结果返回：

<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
  <returnid>
    <x>7111BD1A-7F0B-4CEE-B411-260DADFEFA2A</x> 
  </returnid>
</ROOT>

测试 updategram

  1. 复制上面的 updategram，并将它粘贴到文本文件中。将文件另存为 Updategram-GenerateGuid.xml。

  2. 创建以下各表：

    USE tempdb
CREATE TABLE Cust (CustID uniqueidentifier, LastName varchar(20))
CREATE TABLE CustOrder (CustID uniqueidentifier, OrderID int)

  3. 创建并使用 SQLXML 4.0 测试脚本 (Sqlxml4test.vbs) 执行该模板。

    有关详细信息，请参阅使用 ADO 执行 SQLXML 4.0 查询。

F. 在 updategram 中指定架构

在此示例中，updategram 在以下表中插入一条记录：

CustOrder(OrderID, EmployeeID, OrderType)

在此 updategram 中指定了一个 XSD 架构（即，updategram 元素和属性不存在任何默认映射）。架构提供了元素和属性与数据库表和列之间的必要映射。

以下架构 (CustOrderSchema.xml) 描述由 OrderID 和 EmployeeID 属性组成的 <CustOrder> 元素。若要使该架构更有趣，可以为 EmployeeID 属性分配一个默认值。updategram 仅在执行插入操作以及仅在没有指定该属性时才使用属性的默认值。

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">
  <xsd:element name="CustOrder" >
   <xsd:complexType>
        <xsd:attribute name="OrderID"     type="xsd:integer" /> 
        <xsd:attribute name="EmployeeID"  type="xsd:integer" />
        <xsd:attribute name="OrderType  " type="xsd:integer" default="1"/>
    </xsd:complexType>
  </xsd:element>
</xsd:schema>

此 updategram 在 CustOrder 表中插入一条记录。updategram 仅指定了 OrderID 和 EmployeeID 属性值。它未指定 OrderType 属性值。因此，updategram 使用在前面的架构中指定的 EmployeeID 属性的默认值。

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql"
             xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
<updg:sync mapping-schema='CustOrderSchema.xml'>
<updg:after>
       <CustOrder OrderID="98000" EmployeeID="1" />
</updg:after>
</updg:sync>
</ROOT>

有关指定映射架构的 updategram 的更多示例，请参阅在 updategram 中指定带批注的映射架构 (SQLXML 4.0)。

测试 updategram

  1. 在 tempdb 数据库中创建此表：

    USE tempdb
CREATE TABLE CustOrder(
                 OrderID int, 
                 EmployeeID int, 
                 OrderType int)

  2. 复制上面的架构，并将它粘贴到文本文件中。将文件另存为 CustOrderSchema.xml。

  3. 复制上面的 updategram，并将它粘贴到文本文件中。在与上一步骤中所使用文件夹相同的文件夹中将文件另存为 CustOrderUpdategram.xml。

  4. 创建并使用 SQLXML 4.0 测试脚本 (Sqlxml4test.vbs) 以执行 updategram。

    有关详细信息，请参阅使用 ADO 执行 SQLXML 4.0 查询。

以下是等效的 XDR 架构：

<Schema xmlns="urn:schemas-microsoft-com:xml-data"
        xmlns:sql="urn:schemas-microsoft-com:xml-sql">
 <ElementType name="CustOrder" >
    <AttributeType name="OrderID" />
    <AttributeType name="EmployeeID" />
    <AttributeType name="OrderType" default="1" />
    <attribute type="OrderID"  />
    <attribute type="EmployeeID" />
    <attribute type="OrderType" />
  </ElementType>
</Schema>

G. 使用 xsi:nil 属性在列中插入 null 值

如果要在表的对应列中插入 null 值，可以在 updategram 中指定元素的 xsi:nil 属性。在对应的 XSD 架构中，还必须指定 XSD nillable 属性。

例如，请考虑以下 XSD 架构：

<?xml version="1.0"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">
<xsd:element name="Student" sql:relation="Students">
  <xsd:complexType>
    <xsd:all>
      <xsd:element name="fname" sql:field="first_name" 
                                type="xsd:string" 
                                 nillable="true"/>
    </xsd:all>
    <xsd:attribute name="SID" 
                        sql:field="StudentID"
                        type="xsd:ID"/>    
    <xsd:attribute name="lname"     
                        sql:field="last_name"
                        type="xsd:string"/>
    <xsd:attribute name="minitial"  
                        sql:field="middle_initial" 
                        type="xsd:string"/>
    <xsd:attribute name="years"     
                         sql:field="no_of_years"
                         type="xsd:integer"/>
  </xsd:complexType>
 </xsd:element>
</xsd:schema>

该 XSD 架构为 <fname> 元素指定了 nillable="true"。以下 updategram 使用此架构：

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql"
      xmlns:updg="urn:schemas-microsoft-com:xml-updategram"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<updg:sync mapping-schema='StudentSchema.xml'>
  <updg:before/>
  <updg:after>
    <Student SID="S00004" lname="Elmaci" minitial="" years="2">
      <fname xsi:nil="true">
    </fname>
    </Student>
  </updg:after>
</updg:sync>

</ROOT>

该 updategram 在 <after> 块中为 <fname> 元素指定了 xsi:nil。因此，在执行此 updategram 时，会为表中的 first_name 列插入 NULL 值。

测试 updategram

  1. 在 tempdb 数据库中创建以下表：

    USE tempdb
CREATE TABLE Students (
   StudentID char(6)NOT NULL ,
   first_name varchar(50),
   last_name varchar(50),
   middle_initial char(1),
   no_of_years int NULL)
GO

  2. 复制上面的架构，并将它粘贴到文本文件中。将文件另存为 StudentSchema.xml。

  3. 复制上面的 updategram，并将它粘贴到文本文件中。在与上一步骤中保存 StudentSchema.xml 所使用文件夹相同的文件夹中将文件另存为 StudentUpdategram.xml。

  4. 创建并使用 SQLXML 4.0 测试脚本 (Sqlxml4test.vbs) 以执行 updategram。

    有关详细信息，请参阅使用 ADO 执行 SQLXML 4.0 查询。

H. 在 updategram 中指定命名空间

在 updategram 中，元素所属的命名空间可以在 updategram 中的同一元素中进行声明。在这种情况下，对应的架构也必须声明相同的命名空间，并且元素必须属于该目标命名空间。

例如，在以下 updategram (UpdateGram-ElementHavingNamespace.xml) 中，<Order> 元素便属于在该元素中声明的命名空间。

<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
  <updg:sync mapping-schema='XSD-ElementHavingNameSpace.xml'>
    <updg:after>
       <x:Order  xmlns:x="https://server/xyz/schemas/"
             updg:at-identity="SalesOrderID" 
             RevisionNumber="1"
             OrderDate="2001-07-01 00:00:00.000"
             DueDate="2001-07-13 00:00:00.000"
             OnlineOrderFlag="0"
             CustomerID="676"
             ContactID="378"
             BillToAddressID="985"
             ShipToAddressID="985"
             ShipMethodID="5"
             SubTotal="24643.9362"
             TaxAmt="1971.5149"
             Freight="616.0984"
             rowguid="00009999-8888-7777-6666-554433221100"
             ModifiedDate="2001-07-08 00:00:00.000" />
    </updg:after>
  </updg:sync>
</ROOT>

在这种情况下，架构也必须声明该命名空间，如此架构中所示：

以下架构 (XSD-ElementHavingNamespace.xml) 演示如何必须声明对应的元素和属性。

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
     xmlns:dt="urn:schemas-microsoft-com:datatypes" 
     xmlns:sql="urn:schemas-microsoft-com:mapping-schema"  
     xmlns:x="https://server/xyz/schemas/" 
     targetNamespace="https://server/xyz/schemas/" >
  <xsd:element name="Order" sql:relation="Sales.SalesOrderHeader" type="x:Order_type"/>
  <xsd:complexType name="Order_type">
    <xsd:attribute name="SalesOrderID"  type="xsd:ID"/>
    <xsd:attribute name="RevisionNumber" type="xsd:unsignedByte"/>
    <xsd:attribute name="OrderDate" type="xsd:dateTime"/>
    <xsd:attribute name="DueDate" type="xsd:dateTime"/>
    <xsd:attribute name="ShipDate" type="xsd:dateTime"/>
    <xsd:attribute name="Status" type="xsd:unsignedByte"/>
    <xsd:attribute name="OnlineOrderFlag" type="xsd:boolean"/>
    <xsd:attribute name="SalesOrderNumber" type="xsd:string"/>
    <xsd:attribute name="PurchaseOrderNumber" type="xsd:string"/>
    <xsd:attribute name="AccountNumber" type="xsd:string"/>
    <xsd:attribute name="CustomerID" type="xsd:int"/>
    <xsd:attribute name="ContactID" type="xsd:int"/>
    <xsd:attribute name="SalesPersonID" type="xsd:int"/>
    <xsd:attribute name="TerritoryID" type="xsd:int"/>
    <xsd:attribute name="BillToAddressID" type="xsd:int"/>
    <xsd:attribute name="ShipToAddressID" type="xsd:int"/>
    <xsd:attribute name="ShipMethodID" type="xsd:int"/>
    <xsd:attribute name="CreditCardID" type="xsd:int"/>
    <xsd:attribute name="CreditCardApprovalCode" type="xsd:string"/>
    <xsd:attribute name="CurrencyRateID" type="xsd:int"/>
    <xsd:attribute name="SubTotal" type="xsd:decimal"/>
    <xsd:attribute name="TaxAmt" type="xsd:decimal"/>
    <xsd:attribute name="Freight" type="xsd:decimal"/>
    <xsd:attribute name="TotalDue" type="xsd:decimal"/>
    <xsd:attribute name="Comment" type="xsd:string"/>
    <xsd:attribute name="rowguid" type="xsd:string"/>
    <xsd:attribute name="ModifiedDate" type="xsd:dateTime"/>
  </xsd:complexType>
</xsd:schema>

测试 updategram

  1. 复制上面的架构，并将它粘贴到文本文件中。将文件另存为 XSD-ElementHavingNamespace.xml。

  2. 复制上面的 updategram，并将它粘贴到文本文件中。在用于保存 XSD-ElementHavingnamespace.xml 的同一文件夹中将文件另存为 Updategram-ElementHavingNamespace.xml。

  3. 创建并使用 SQLXML 4.0 测试脚本 (Sqlxml4test.vbs) 以执行 updategram。

    有关详细信息，请参阅使用 ADO 执行 SQLXML 4.0 查询。

I. 将数据插入到 XML 数据类型列

SQL Server 2005 中引入了 xml 数据类型。可以使用 updategram 插入和更新存储在 xml 数据类型列中的数据，但必须遵守以下规定：

  • xml 列不能用于标识现有行。因此，它不能包括在 updategram 的 updg:before 部分中。

  • 将保留插入到 xml 列的 XML 片段的作用域中的命名空间，并且会将其命名空间声明添加到所插入片段的顶级元素中。

例如，在以下 updategram (SampleUpdateGram.xml) 中，<Desc> 元素更新 AdventureWorks 示例数据库的 Production>productModel 表中的 ProductDescription 列。此 updategram 的结果是：使用 <Desc> 元素的 XML 内容更新 ProductDescription 列的 XML 内容。

<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
    <updg:sync mapping-schema="SampleSchema.xml" >
       <updg:before>
<ProductModel ProductModelID="19">
   <Name>Mountain-100</Name>
</ProductModel>
    </updg:before>
    <updg:after>
 <ProductModel>
    <Name>Mountain-100</Name>
    <Desc><?xml-stylesheet href="ProductDescription.xsl" type="text/xsl"?>
        <p1:ProductDescription xmlns:p1="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription" 
              xmlns:wm="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain" 
              xmlns:wf="https://www.adventure-works.com/schemas/OtherFeatures" 
              xmlns:html="http://www.w3.org/1999/xhtml" 
              >
  <p1:Summary>
     <html:p>Insert Example</html:p>
  </p1:Summary>
  <p1:Manufacturer>
    <p1:Name>AdventureWorks</p1:Name>
    <p1:Copyright>2002</p1:Copyright>
    <p1:ProductURL>HTTP://www.Adventure-works.com</p1:ProductURL>
  </p1:Manufacturer>
  <p1:Features>These are the product highlights. 
    <wm:Warranty>
       <wm:WarrantyPeriod>3 years</wm:WarrantyPeriod>
       <wm:Description>parts and labor</wm:Description>
    </wm:Warranty>
    <wm:Maintenance>
       <wm:NoOfYears>10 years</wm:NoOfYears>
       <wm:Description>maintenance contract available through your dealer or any AdventureWorks retail store.</wm:Description>
    </wm:Maintenance>
    <wf:wheel>High performance wheels.</wf:wheel>
    <wf:saddle>
      <html:i>Anatomic design</html:i> and made from durable leather for a full-day of riding in comfort.</wf:saddle>
    <wf:pedal>
       <html:b>Top-of-the-line</html:b> clipless pedals with adjustable tension.</wf:pedal>
    <wf:BikeFrame>Each frame is hand-crafted in our Bothell facility to the optimum diameter and wall-thickness required of a premium mountain frame. The heat-treated welded aluminum frame has a larger diameter tube that absorbs the bumps.</wf:BikeFrame>
    <wf:crankset> Triple crankset; alumunim crank arm; flawless shifting. </wf:crankset>
   </p1:Features>
   <p1:Picture>
      <p1:Angle>front</p1:Angle>
      <p1:Size>small</p1:Size>
      <p1:ProductPhotoID>118</p1:ProductPhotoID>
   </p1:Picture>
   <p1:Specifications> These are the product specifications.
     <Material>Almuminum Alloy</Material>
     <Color>Available in most colors</Color>
     <ProductLine>Mountain bike</ProductLine>
     <Style>Unisex</Style>
     <RiderExperience>Advanced to Professional riders</RiderExperience>
   </p1:Specifications>
  </p1:ProductDescription>
 </Desc>
      </ProductModel>
    </updg:after>
  </updg:sync>
</ROOT>

updategram 引用以下带批注的 XSD 架构 (SampleSchema.xml)。

<?xml version="1.0" encoding="utf-8" ?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
           xmlns:sql="urn:schemas-microsoft-com:mapping-schema"
           xmlns="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription"> 
  <xsd:element name="ProductModel"  sql:relation="Production.ProductModel" >
     <xsd:complexType>
       <xsd:sequence>
          <xsd:element name="Name" type="xsd:string"></xsd:element>
          <xsd:element name="Desc" sql:field="CatalogDescription" sql:datatype="xml">
           <xsd:complexType>
            <xsd:sequence>
              <xsd:element name="ProductDescription">
                 <xsd:complexType>
                   <xsd:sequence>
                     <xsd:element name="Summary" type="xsd:anyType">
                     </xsd:element>
                   </xsd:sequence>
                 </xsd:complexType>
              </xsd:element>
            </xsd:sequence>
           </xsd:complexType>
          </xsd:element> 
       </xsd:sequence>
       <xsd:attribute name="ProductModelID" sql:field="ProductModelID"/>
     </xsd:complexType>
  </xsd:element>
</xsd:schema>

测试 updategram

  1. 复制上面的架构，并将它粘贴到文本文件中。将文件另存为 XSD-SampleSchema.xml。

    注意注意

    由于 updategram 支持默认映射，所以没有办法识别 xml 数据类型的开始和结束。也就是说，在使用 xml 数据类型列插入或更新表时，需要一个映射架构。如果没有提供架构，SQLXML 将返回错误，指出表中缺少某一列。

  2. 复制上面的 updategram，并将它粘贴到文本文件中。在用于保存 SampleSchema.xml 的同一文件夹中将文件另存为 SampleUpdategram.xml。

  3. 创建并使用 SQLXML 4.0 测试脚本 (Sqlxml4test.vbs) 以执行 updategram。

    有关详细信息，请参阅使用 ADO 执行 SQLXML 4.0 查询。