• 项目

使用 XML Updategram 更新数据 (SQLXML 4.0)

更新现有数据时，必须指定 <before> 块和 <after> 块。在 <before> 和 <after> 块中指定的元素用于描述所需的更改。Updategram 使用在 <before> 块中指定的元素来标识数据库中的现有记录。<after> 块中的相应元素指示执行更新操作之后记录应该是怎样的。通过使用该信息，Updategram 创建与 <after> 块匹配的 SQL 语句。然后，Updategram 使用该语句更新数据库。

以下是 Updategram 的更新操作格式：

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

  • <updg:before>
    <before> 块中的元素用于标识数据库表中的现有记录。

  • <updg:after>
    <after> 块中的元素说明 <before> 块中指定的记录在更新之后应该是怎样的。

mapping-schema 属性用于标识要由 Updategram 使用的映射架构。如果 Updategram 指定映射架构，则在 <before> 和 <after> 块中指定的元素和属性名称必须与架构中的名称相匹配。该映射架构将这些元素或属性名称映射到数据库表和列名称。

如果 Updategram 不指定架构，则 Updategam 将使用默认映射。在默认映射中，在 Updategram 中指定的 <ElementName> 将映射到数据库表，而子元素或属性将映射到数据库列。

<before> 块中的元素必须仅与数据库中的一个表行匹配。如果元素要么匹配多个表行，要么不匹配任何表行，则 Updategram 返回错误，并取消整个 <sync> 块。

Updategram 可以包括多个 <sync> 块。每个 <sync> 块均被视为一个事务。每个 <sync> 块可以有多个 <before> 和 <after> 块。例如，如果要更新两个现有记录，则可以指定两个 <before> 和 <after> 对，即为每个要更新的记录各指定一个。

使用 updg:id 属性

在 <before> 和 <after> 块中指定多个元素时，可以使用 updg:id 属性来标记 <before> 和 <after> 块中的行。处理逻辑使用该信息以确定 <after> 块中的什么记录与 <before> 块中的什么记录配对。

如果存在以下任一情况，则 updg:id 属性不是必需属性（尽管推荐使用该属性）：

  • 指定的映射架构中的元素定义了 sql:key-fields 属性。

  • 为 Updategram 中的键字段提供了一个或多个特定值。

如果任一情况成立，则 Updategram 将使用在 sql:key-fields 中指定的键列，对 <before> 和 <after> 块中的元素进行配对。

如果映射架构未标识键列（通过使用 sql:key-fields）或者 Updategram 要更新键列值，则必须指定 updg:id。

在 <before> 和 <after> 块中标识的记录不必有相同的顺序。updg:id 属性强制在 <before> 和 <after> 块中指定的元素之间建立关联。

如果在 <before> 块中指定一个元素并在 <after> 块中指定唯一的对应元素，则可以不使用 updg:id。但是，建议指定 updg:id 以避免多义性。

示例

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

大多数示例使用 AdventureWorks2008R2 示例数据库。

A. 更新记录

以下 Updategram 将 AdventureWorks2008R2 数据库的 Person.Person 表中的雇员姓氏更新为 Fuller。Updategram 不指定任何映射架构，因此，Updategram 使用默认映射。

<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
<updg:sync >
<updg:before>
   <Person.Person BusinessEntityID="1" />
</updg:before>
<updg:after>
   <Person.Person LastName="Fuller" />
</updg:after>
</updg:sync>
</ROOT>

在 <before> 块中描述的记录表示数据库中的当前记录。Updategram 使用在 <before> 块中指定的所有列值以搜索记录。在该 Updategram 中，<before> 块仅提供 BusinessEntityID 列；因此 Updategram 仅使用该值来搜索记录。如果要将 LastName 值添加到该块，则 Updategram 会同时使用 BusinessEntityID 和 LastName 值执行搜索。

在该 Updategram 中，<after> 块仅提供 LastName 列值，因为这是要更改的唯一值。

测试 Updategram

  1. 复制上面的 Updategram 模板，并将它粘贴到文本文件中。将该文件另存为 UpdateLastName.xml。

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

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

B. 使用 updg:id 属性更新多个记录

在该示例中，Updategram 对 AdventureWorks2008R2 数据库中的 HumanResources.Shift 表执行两次更新：

  • 它将 7:00AM 开始的原始白班的名称从“Day”更改为“Early Morning”。

  • 它插入名为“Late Morning”的从 10:00AM 开始的新班。

在此 Updategram 中，updg:id 属性将在 <before> 和 <after> 块中的元素之间创建关联。

<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
  <updg:sync >
    <updg:before>
       <HumanResources.Shift updg:id="x" Name="Day" />
    </updg:before>
    <updg:after>
      <HumanResources.Shift updg:id="y" Name="Late Morning" 
                            StartTime="1900-01-01 10:00:00.000"
                            EndTime="1900-01-01 18:00:00.000"
                            ModifiedDate="2004-06-01 00:00:00.000"/>
      <HumanResources.Shift updg:id="x" Name="Early Morning" />
    </updg:after>
  </updg:sync>
</ROOT>

注意 updg:id 属性如何使 <before> 块中的 <HumanResources.Shift> 元素的第一个实例与 <after> 块中的 <HumanResources.Shift> 元素的第二个实例进行配对。

测试 Updategram

  1. 复制上面的 Updategram 模板，并将它粘贴到文本文件中。将该文件另存为 UpdateMultipleRecords.xml。

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

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

C. 指定多个 <before> 和 <after> 块

若要避免多义性，可以通过使用多个 <before> 和 <after> 块对来编写示例 B 中的 Updategram。指定 <before> 和 <after> 对是指定具有最不易混淆的多个更新的一种方式。而且，如果每个 <before> 和 <after> 块最多指定一个元素，则不必使用 updg:id 属性。

注意注意

若要形成配对，<after> 标记必须紧跟在其对应的 <before> 标记的后面。

在下面的 Updategram 中，第一个 <before> 和 <after> 对将更新白班的名称。第二对将插入新的轮班记录。

<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
  <updg:sync >
    <updg:before>
       <HumanResources.Shift ShiftID="1" Name="Day" />
    </updg:before>
    <updg:after>
      <HumanResources.Shift Name="Early Morning" />
    </updg:after>
    <updg:before>
    </updg:before>
    <updg:after>
      <HumanResources.Shift Name="Late Morning" 
                            StartTime="1900-01-01 10:00:00.000"
                            EndTime="1900-01-01 18:00:00.000"
                            ModifiedDate="2004-06-01 00:00:00.000"/>
    </updg:after>
  </updg:sync>
</ROOT>

测试 Updategram

  1. 复制上面的 Updategram 模板，并将它粘贴到文本文件中。将该文件另存为 UpdateMultipleBeforeAfter.xml。

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

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

D. 指定多个 <sync> 块

可以在 Updategram 中指定多个 <sync> 块。指定的每个 <sync> 块都是独立的事务。

在以下 Updategram 中，第一个 <sync> 块更新 Sales.Customer 表中的记录。出于简化原因，Updategram 仅指定必需的列值：标识值 (CustomerID) 和要更新的值 (SalesPersonID)。

第二个 <sync> 块将两个记录添加到 Sales.SalesOrderHeader 表。对于该表，SalesOrderID 是 IDENTITY 类型的列。因此，Updategram 不在每个 <Sales.SalesOrderHeader> 元素中指定 SalesOrderID 的值。

指定多个 <sync> 块是很有用的，因为如果第二个 <sync> 块（事务）未能将记录添加到 Sales.SalesOrderHeader 表，则第一个 <sync> 块仍然可以更新 Sales.Customer 表中的客户记录。

<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
  <updg:sync >
    <updg:before>
      <Sales.Customer CustomerID="1" SalesPersonID="280" />
    </updg:before>
    <updg:after>
      <Sales.Customer CustomerID="1" SalesPersonID="283" />
    </updg:after>
  </updg:sync>
  <updg:sync >
    <updg:before>
    </updg:before>
    <updg:after>
   <Sales.SalesOrderHeader 
             CustomerID="1"
             RevisionNumber="1"
             OrderDate="2004-07-01 00:00:00.000"
             DueDate="2004-07-13 00:00:00.000"
             OnlineOrderFlag="0"
             SalesPersonID="378"
             BillToAddressID="985"
             ShipToAddressID="985"
             ShipMethodID="5"
             SubTotal="24643.9362"
             TaxAmt="1971.5149"
             Freight="616.0984"
             rowguid="01010101-2222-3333-4444-556677889900"
             ModifiedDate="2004-07-08 00:00:00.000" />
   <Sales.SalesOrderHeader
             CustomerID="1"
             RevisionNumber="1"
             OrderDate="2004-07-01 00:00:00.000"
             DueDate="2004-07-13 00:00:00.000"
             OnlineOrderFlag="0"
             SalesPersonID="378"
             BillToAddressID="985"
             ShipToAddressID="985"
             ShipMethodID="5"
             SubTotal="1000.0000"
             TaxAmt="0.0000"
             Freight="0.0000"
             rowguid="10101010-2222-3333-4444-556677889900"
             ModifiedDate="2004-07-09 00:00:00.000" />
    </updg:after>
  </updg:sync>
</ROOT>

测试 Updategram

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

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

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

E. 使用映射架构

在该示例中，Updategram 通过使用 mapping-schema 属性来指定映射架构。（没有默认映射；就是说，由映射架构提供所需的映射，将 Updategram 中的元素和属性映射到数据库表和列。）

在 Updategram 中指定的元素和属性将引用映射架构中的元素和属性。

以下 XSD 映射架构有 <Customer>、<Order> 和 <OD> 元素，它们映射到数据库中的 Sales.Customer、Sales.SalesOrderHeader 和 Sales.SalesOrderDetail 表。

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">
<xsd:annotation>
  <xsd:appinfo>
    <sql:relationship name="CustomerOrder"
          parent="Sales.Customer"
          parent-key="CustomerID"
          child="Sales.SalesOrderHeader"
          child-key="CustomerID" />

    <sql:relationship name="OrderOD"
          parent="Sales.SalesOrderHeader"
          parent-key="SalesOrderID"
          child="Sales.SalesOrderDetail"
          child-key="SalesOrderID" />
  </xsd:appinfo>
</xsd:annotation>

  <xsd:element name="Customer" sql:relation="Sales.Customer" >
   <xsd:complexType>
     <xsd:sequence>
        <xsd:element name="Order" 
                     sql:relation="Sales.SalesOrderHeader"
                     sql:relationship="CustomerOrder" >
           <xsd:complexType>
              <xsd:sequence>
                <xsd:element name="OD" 
                             sql:relation="Sales.SalesOrderDetail"
                             sql:relationship="OrderOD" >
                 <xsd:complexType>
                  <xsd:attribute name="SalesOrderID" type="xsd:integer" />
                  <xsd:attribute name="ProductID" type="xsd:integer" />
                  <xsd:attribute name="UnitPrice" type="xsd:decimal" />
                  <xsd:attribute name="OrderQty" type="xsd:integer" />
                  <xsd:attribute name="UnitPriceDiscount" type="xsd:decimal" /> 
                 </xsd:complexType>
                </xsd:element>
              </xsd:sequence>
              <xsd:attribute name="CustomerID" type="xsd:string" />
              <xsd:attribute name="SalesOrderID" type="xsd:integer" />
              <xsd:attribute name="OrderDate" type="xsd:date" />
           </xsd:complexType>
        </xsd:element>
      </xsd:sequence>
      <xsd:attribute name="CustomerID"   type="xsd:string" /> 
    </xsd:complexType>
  </xsd:element>
</xsd:schema>

以下 Updategram 指定该映射架构 (UpdategramMappingSchema.xml)。该 Updategram 在 Sales.SalesOrderDetail 表中为特定顺序添加顺序细节项。该 Updategram 包括嵌套元素：嵌套在 <Order> 元素中的 <OD> 元素。在映射架构中指定了这两个元素之间的主键/外键关系。

<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
  <updg:sync mapping-schema="UpdategramMappingSchema.xml" >
    <updg:before>
       <Order SalesOrderID="43659" />
    </updg:before>
    <updg:after>
      <Order SalesOrderID="43659" >
          <OD ProductID="776" UnitPrice="2329.0000"
              OrderQty="2" UnitPriceDiscount="0.0" />
      </Order>
    </updg:after>
  </updg:sync>
</ROOT>

测试 Updategram

  1. 复制上面的映射架构，并将它粘贴到文本文件中。将该文件另存为 UpdategramMappingSchema.xml。

  2. 复制上面的 Updategram 模板，并将它粘贴到文本文件中。在用于保存映射架构 (UpdategramMappingSchema.xml) 的相同文件夹中将该文件另存为 UpdateWithMappingSchema.xml。

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

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

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

F. 将 IDREFS 属性与映射架构一起使用

该示例说明 Updategram 如何在映射架构中使用 IDREFS 属性以更新多个表中的记录。对于该示例，假定数据库由以下表组成：

  • Student(StudentID, LastName)

  • Course(CourseID, CourseName)

  • Enrollment(StudentID, CourseID)

由于学生可以注册参加很多课程，而且一种课程可以有很多学生，因此需要用第三个表 Enrollment 表以表示该 M:N 关系。

通过使用 <Student>、<Course> 和 <Enrollment> 元素，以下 XSD 映射架构提供了该表的 XML 视图。映射架构中的 IDREFS 属性指定了这些元素之间的关系。<Course> 元素的 StudentIDList 属性是一个 IDREFS 类型属性，它引用 Enrollment 表中的 StudentID 列。同样，<Student> 元素的 EnrolledIn 属性是 IDREFS 类型属性，它引用 Enrollment 表中的 CourseID 列。

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">
<xsd:annotation>
  <xsd:appinfo>
    <sql:relationship name="StudentEnrollment"
          parent="Student"
          parent-key="StudentID"
          child="Enrollment"
          child-key="StudentID" />

    <sql:relationship name="CourseEnrollment"
          parent="Course"
          parent-key="CourseID"
          child="Enrollment"
          child-key="CourseID" />
  </xsd:appinfo>
</xsd:annotation>

  <xsd:element name="Course" sql:relation="Course" 
                             sql:key-fields="CourseID" >
    <xsd:complexType>
    <xsd:attribute name="CourseID"  type="xsd:string" /> 
    <xsd:attribute name="CourseName"   type="xsd:string" /> 
    <xsd:attribute name="StudentIDList" sql:relation="Enrollment"
                 sql:field="StudentID"
                 sql:relationship="CourseEnrollment" 
                                     type="xsd:IDREFS" />

    </xsd:complexType>
  </xsd:element>
  <xsd:element name="Student" sql:relation="Student" >
    <xsd:complexType>
    <xsd:attribute name="StudentID"  type="xsd:string" /> 
    <xsd:attribute name="LastName"   type="xsd:string" /> 
    <xsd:attribute name="EnrolledIn" sql:relation="Enrollment"
                 sql:field="CourseID"
                 sql:relationship="StudentEnrollment" 
                                     type="xsd:IDREFS" />
    </xsd:complexType>
  </xsd:element>
</xsd:schema>

一旦在 Updategram 中指定该架构，并在 Course 表中插入记录，则 Updategram 将在 Course 表中插入新的课程记录。如果为 StudentIDList 属性指定一个或多个新学生 ID，则 Updategram 还将在 Enrollment 表中为每个新学生插入记录。该 Updategram 将确保不向 Enrollment 表添加重复项。

测试 Updategram

  1. 在虚拟根目录中所指定的数据库内创建这些表：

    CREATE TABLE Student(StudentID varchar(10) primary key, 
                     LastName varchar(25))
CREATE TABLE Course(CourseID varchar(10) primary key, 
                    CourseName varchar(25))
CREATE TABLE Enrollment(StudentID varchar(10) 
                                  references Student(StudentID),
                       CourseID varchar(10) 
                                  references Course(CourseID))

  2. 添加该示例数据：

    INSERT INTO Student VALUES ('S1','Davoli')
INSERT INTO Student VALUES ('S2','Fuller')

INSERT INTO Course VALUES  ('CS101', 'C Programming')
INSERT INTO Course VALUES  ('CS102', 'Understanding XML')

INSERT INTO Enrollment VALUES ('S1', 'CS101')
INSERT INTO Enrollment VALUES ('S1', 'CS102')

  3. 复制上面的映射架构，并将它粘贴到文本文件中。将该文件另存为 SampleSchema.xml。

  4. 将 Updategram (SampleUpdategram) 保存到上一步中用于保存映射架构的相同文件夹中。（该 Updategram 从 CS102 课程中删除 StudentID="1" 的学生。）

    <ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
  <updg:sync mapping-schema="SampleSchema.xml" >
    <updg:before>
        <Student updg:id="x" StudentID="S1" LastName="Davolio"
                             EnrolledIn="CS101 CS102" />
    </updg:before>
    <updg:after >
        <Student updg:id="x" StudentID="S1" LastName="Davolio"
                             EnrolledIn="CS101" />
    </updg:after>
  </updg:sync>
</ROOT>

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

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

  6. 按照前面描述的步骤，保存并执行以下 Updategram。该 Updategram 在 Enrollment 表中添加记录，从而将 StudentID="1" 的学生重新添加到 CS102 课程中。

    <ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
  <updg:sync mapping-schema="SampleSchema.xml" >
    <updg:before>
        <Student updg:id="x" StudentID="S1" LastName="Davolio"
                             EnrolledIn="CS101" />
    </updg:before>
    <updg:after >
        <Student updg:id="x" StudentID="S1" LastName="Davolio"
                             EnrolledIn="CS101 CS102" />
    </updg:after>
  </updg:sync>
</ROOT>

  7. 按照前面描述的步骤，保存并执行下一个 Updategram。该 Updategram 插入三个新学生，并将他们注册到 CS101 课程。同样，IDREFS 关系将在 Enrollment 表中插入记录。

    <ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
  <updg:sync mapping-schema="SampleSchema.xml" >
    <updg:before>
       <Course updg:id="y" CourseID="CS101" 
                           CourseName="C Programming" />
    </updg:before>
    <updg:after >
       <Student updg:id="x1" StudentID="S3" LastName="Leverling" />
       <Student updg:id="x2" StudentID="S4" LastName="Pecock" />
       <Student updg:id="x3" StudentID="S5" LastName="Buchanan" />
       <Course updg:id="y" CourseID="CS101"
                           CourseName="C Programming"
                           StudentIDList="S3 S4 S5" />
    </updg:after>
  </updg:sync>
</ROOT>

以下是等效的 XDR 架构：

<?xml version="1.0" ?>
<Schema xmlns="urn:schemas-microsoft-com:xml-data"
        xmlns:dt="urn:schemas-microsoft-com:datatypes"
        xmlns:sql="urn:schemas-microsoft-com:xml-sql">
  <ElementType name="Enrollment" sql:relation="Enrollment" sql:key-fields="StudentID CourseID">
    <AttributeType name="StudentID" dt:type="id" />
    <AttributeType name="CourseID" dt:type="id" />

    <attribute type="StudentID" />
    <attribute type="CourseID" />
  </ElementType>
  <ElementType name="Course" sql:relation="Course" sql:key-fields="CourseID">
    <AttributeType name="CourseID" dt:type="id" />
    <AttributeType name="CourseName" />
 
    <attribute type="CourseID" />
    <attribute type="CourseName" />

    <AttributeType name="StudentIDList" dt:type="idrefs" />
    <attribute type="StudentIDList" sql:relation="Enrollment" sql:field="StudentID" >
        <sql:relationship
                key-relation="Course"
                key="CourseID"
                foreign-relation="Enrollment"
                foreign-key="CourseID" />
    </attribute>

  </ElementType>
  <ElementType name="Student" sql:relation="Student">
    <AttributeType name="StudentID" dt:type="id" />
     <AttributeType name="LastName" />

    <attribute type="StudentID" />
    <attribute type="LastName" />

    <AttributeType name="EnrolledIn" dt:type="idrefs" />
    <attribute type="EnrolledIn" sql:relation="Enrollment" sql:field="CourseID" >
        <sql:relationship
                key-relation="Student"
                key="StudentID"
                foreign-relation="Enrollment"
                foreign-key="StudentID" />
    </attribute>

    <element type="Enrollment" sql:relation="Enrollment" >
        <sql:relationship key-relation="Student"
                          key="StudentID"
                          foreign-relation="Enrollment"
                          foreign-key="StudentID" />
    </element>
  </ElementType>

</Schema>

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