Поделиться через

Указание схемы аннотированного сопоставления в диаграмме обновления (SQLXML 4.0)

В этом разделе объясняется, как схема сопоставления (XSD или XDR), указанная в диаграмме обновления, используется для обработки обновлений. В диаграмме обновления можно указать имя аннотированной схемы сопоставления, используемой в сопоставлении элементов и атрибутов в диаграмме обновления с таблицами и столбцами в Microsoft SQL Server. Если схема сопоставления указана в диаграмме обновления, имена элементов и атрибутов, указанные в диаграмме обновления, должны сопоставляться с элементами и атрибутами схемы сопоставления.

Чтобы указать схему сопоставления, используйте mapping-schema атрибут элемента синхронизации<>. В следующих примерах показаны две диаграммы обновления: одна, использующая простую схему сопоставления, и ту, которая использует более сложную схему.

Замечание

В этой документации предполагается, что вы знакомы с шаблонами и поддержкой схемы сопоставления в SQL Server. Дополнительные сведения см. в разделе "Общие сведения о аннотированных схемах XSD" (SQLXML 4.0). Устаревшие приложения, использующие XDR, см. в разделе "Аннотированные схемы XDR" (устаревшие в SQLXML 4.0).

Работа с типами данных

Если схема указывает imagebinaryтип данных ( или varbinaryтип данных SQL Server (с помощью) sql:datatypeи не указывает тип xml-данных, то в диаграмме обновления предполагается, что тип данных XML являетсяbinary base 64. Если данные являются bin.base типом, необходимо явно указать тип (dt:type=bin.base или type="xsd:hexBinary").

Если схема указывает dateTimedateтип данных (или time XSD), необходимо также указать соответствующий тип данных SQL Server с помощью sql:datatype="dateTime".

При обработке параметров типа SQL Server money необходимо явно указать sql:datatype="money" на соответствующем узле в схеме сопоставления.

Примеры

Чтобы создать рабочие примеры с помощью следующих примеров, необходимо выполнить требования, указанные в разделе "Требования для выполнения примеров SQLXML".

А. Создание диаграммы обновления с помощью простой схемы сопоставления

Следующая схема XSD (SampleSchema.xml) — это схема сопоставления, которая сопоставляет <элемент Customer> с таблицей Sales.Customer:

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"  
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">  
  <xsd:element name="Customer" sql:relation="Sales.Customer" >  
   <xsd:complexType>  
        <xsd:attribute name="CustID"    
                       sql:field="CustomerID"   
                       type="xsd:string" />  
        <xsd:attribute name="RegionID"    
                       sql:field="TerritoryID"    
                       type="xsd:string" />  
    </xsd:complexType>  
  </xsd:element>  
</xsd:schema>

Следующая диаграмма обновления вставляет запись в таблицу Sales.Customer и использует предыдущую схему сопоставления, чтобы правильно сопоставить эти данные с таблицей. Обратите внимание, что в диаграмме обновления используется то же имя элемента Customer>,< как определено в схеме. Это обязательно, так как диаграмма обновления указывает определенную схему.

Тестирование диаграммы обновления

  1. Скопируйте приведенный выше код схемы и вставьте его в текстовый файл. Сохраните файл как SampleUpdateSchema.xml.

  2. Скопируйте приведенный ниже шаблон диаграммы обновления и вставьте его в текстовый файл. Сохраните файл как SampleUpdategram.xml в том же каталоге, где вы сохранили SampleUpdateSchema.xml.

    <ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">  
  <updg:sync mapping-schema="SampleUpdateSchema.xml">  
    <updg:before>  
      <Customer CustID="1" RegionID="1"  />  
    </updg:before>  
    <updg:after>  
      <Customer CustID="1" RegionID="2" />  
    </updg:after>  
  </updg:sync>  
</ROOT>

    Путь к каталогу, указанный для схемы сопоставления (SampleUpdateSchema.xml), относится к каталогу, в котором сохраняется шаблон. Можно также задать абсолютный путь, например:

    mapping-schema="C:\SqlXmlTest\SampleUpdateSchema.xml"

  3. Создайте и запустите тестовый скрипт SQLXML 4.0 (Sqlxml4test.vbs), чтобы выполнить шаблон.

    Дополнительные сведения см. в разделе "Использование ADO для выполнения запросов SQLXML 4.0".

Это эквивалентная схема 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="Customer" sql:relation="Sales.Customer" >  
       <AttributeType name="CustID" />  
       <AttributeType name="RegionID" />  
  
       <attribute type="CustID" sql:field="CustomerID" />  
       <attribute type="RegionID" sql:field="TerritoryID" />  
     </ElementType>  
   </Schema>

В. Вставка записи с помощью связи "родительский-дочерний", указанной в схеме сопоставления

Элементы схемы могут быть связаны. Элемент <sql:relationship> указывает связь "родительский-дочерний" между элементами схемы. Эта информация используется для обновления соответствующих таблиц с первичным ключом и внешним ключом.

Следующая схема сопоставления (SampleSchema.xml) состоит из двух элементов: <Order> и <OD>:

<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="OrderOD"  
          parent="Sales.SalesOrderHeader"  
          parent-key="SalesOrderID"  
          child="Sales.SalesOrderDetail"  
          child-key="SalesOrderID" />  
  </xsd:appinfo>  
</xsd:annotation>  
  
  <xsd:element name="Order" sql:relation="Sales.SalesOrderHeader" >  
   <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:schema>

Следующая диаграмма обновления использует эту схему XSD для добавления новой записи сведений о заказе (<элемент OD> в блоке< после> блока) для заказа 43860. Атрибут mapping-schema используется для указания схемы сопоставления в диаграмме обновления.

<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">  
  <updg:sync mapping-schema="SampleUpdateSchema.xml" >  
    <updg:before>  
       <Order SalesOrderID="43860" />  
    </updg:before>  
    <updg:after>  
      <Order SalesOrderID="43860" >  
           <OD ProductID="753" UnitPrice="$10.00"  
               Quantity="5" Discount="0.0" />  
      </Order>  
    </updg:after>  
  </updg:sync>  
</ROOT>
Тестирование диаграммы обновления

  1. Скопируйте приведенный выше код схемы и вставьте его в текстовый файл. Сохраните файл как SampleUpdateSchema.xml.

  2. Скопируйте приведенный выше шаблон диаграммы обновления и вставьте его в текстовый файл. Сохраните файл как SampleUpdategram.xml в том же каталоге, где вы сохранили SampleUpdateSchema.xml.

    Путь к каталогу, указанный для схемы сопоставления (SampleUpdateSchema.xml), относится к каталогу, в котором сохраняется шаблон. Можно также задать абсолютный путь, например:

    mapping-schema="C:\SqlXmlTest\SampleUpdateSchema.xml"

  3. Создайте и запустите тестовый скрипт SQLXML 4.0 (Sqlxml4test.vbs), чтобы выполнить шаблон.

    Дополнительные сведения см. в разделе "Использование ADO для выполнения запросов SQLXML 4.0".

Это эквивалентная схема 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="OD" sql:relation="Sales.SalesOrderDetail" >  
    <AttributeType name="SalesOrderID" />  
    <AttributeType name="ProductID" />  
    <AttributeType name="UnitPrice"  dt:type="fixed.14.4" />  
    <AttributeType name="OrderQty" />  
    <AttributeType name="UnitPriceDiscount" />  
  
    <attribute type="SalesOrderID" />  
    <attribute type="ProductID" />  
    <attribute type="UnitPrice" />  
    <attribute type="OrderQty" />  
    <attribute type="UnitPriceDiscount" />  
</ElementType>  
  
<ElementType name="Order" sql:relation="Sales.SalesOrderHeader" >  
    <AttributeType name="CustomerID" />  
    <AttributeType name="SalesOrderID" />  
    <AttributeType name="OrderDate" />  
  
    <attribute type="CustomerID" />  
    <attribute type="SalesOrderID" />  
    <attribute type="OrderDate" />  
    <element type="OD" >  
             <sql:relationship   
                   key-relation="Sales.SalesOrderHeader"  
                   key="SalesOrderID"  
                   foreign-key="SalesOrderID"  
                   foreign-relation="Sales.SalesOrderDetail" />  
    </element>  
</ElementType>  
</Schema>

С. Вставка записи с помощью связи "родительский-дочерний" и обратной заметки, указанной в схеме XSD

В этом примере показано, как логика обновления использует связь родительского-дочернего элемента, указанную в XSD, для обработки обновлений и использования inverse заметки. Дополнительные сведения об inverse заметке см. в разделе "Указание атрибута sql:inverse" в sql:relationship (SQLXML 4.0).

В этом примере предполагается, что следующие таблицы находятся в базе данных tempdb :

  • Cust (CustomerID, CompanyName), где CustomerID является первичным ключом

  • Ord (OrderID, CustomerID), где CustomerID находится внешний ключ, который ссылается на CustomerID первичный ключ в Cust таблице.

На диаграмме обновления используется следующая схема XSD для вставки записей в таблицы Cust и Ord:

<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="OrdCust" inverse="true"  
                  parent="Ord"  
                  parent-key="CustomerID"  
                  child-key="CustomerID"  
                  child="Cust"/>  
  </xsd:appinfo>  
</xsd:annotation>  
  
<xsd:element name="Order" sql:relation="Ord">  
  <xsd:complexType>  
    <xsd:sequence>  
      <xsd:element ref="Customer" sql:relationship="OrdCust"/>  
    </xsd:sequence>  
    <xsd:attribute name="OrderID"   type="xsd:int"/>  
    <xsd:attribute name="CustomerID" type="xsd:string"/>  
  </xsd:complexType>  
</xsd:element>  
  
<xsd:element name="Customer" sql:relation="Cust">  
  <xsd:complexType>  
     <xsd:attribute name="CustomerID"  type="xsd:string"/>  
    <xsd:attribute name="CompanyName" type="xsd:string"/>  
  </xsd:complexType>  
</xsd:element>  
  
</xsd:schema>

Схема XSD в этом примере содержит <элементы Customer> и <Order> , а также указывает связь между двумя элементами. Он определяет <Order> как родительский элемент и <Customer> как дочерний элемент.

Логика обработки диаграмм обновления использует сведения о связи "родительский-дочерний" для определения порядка вставки записей в таблицы. В этом примере логика диаграммы обновления сначала пытается вставить запись в таблицу Ord (так как Order> является родительским), а затем пытается вставить запись в таблицу Cust (так< как <клиент> является дочерним). Однако из-за сведений первичного ключа или внешнего ключа, содержащихся в схеме таблицы базы данных, эта операция вставки приводит к нарушению внешнего ключа в базе данных и сбою вставки.

Чтобы указать логике обновления, чтобы изменить связь родительско-дочернего элемента во время операции обновления, inverse заметка указывается в элементе <связи> . В результате записи сначала добавляются в таблицу Cust, а затем в таблицу Ord и операция завершается успешно.

Следующая диаграмма обновления вставляет заказ (OrderID=2) в таблицу Ord и клиент (CustomerID='AAAAA') в таблицу Cust с помощью указанной схемы XSD:

<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">  
  <updg:sync mapping-schema="SampleUpdateSchema.xml" >  
    <updg:before/>  
    <updg:after>  
      <Order OrderID="2" CustomerID="AAAAA" >  
        <Customer CustomerID="AAAAA" CompanyName="AAAAA Company" />  
      </Order>  
    </updg:after>  
  </updg:sync>  
</ROOT>
Тестирование диаграммы обновления

  1. Создайте эти таблицы в базе данных tempdb :

    USE tempdb  
CREATE TABLE Cust(CustomerID varchar(5) primary key,   
                  CompanyName varchar(20))  
GO  
CREATE TABLE Ord (OrderID int primary key,   
                  CustomerID varchar(5) references Cust(CustomerID))  
GO

  2. Скопируйте приведенный выше код схемы и вставьте его в текстовый файл. Сохраните файл как SampleUpdateSchema.xml.

  3. Скопируйте приведенный выше шаблон диаграммы обновления и вставьте его в текстовый файл. Сохраните файл как SampleUpdategram.xml в том же каталоге, где вы сохранили SampleUpdateSchema.xml.

    Путь к каталогу, указанный для схемы сопоставления (SampleUpdateSchema.xml), относится к каталогу, в котором сохраняется шаблон. Можно также задать абсолютный путь, например:

    mapping-schema="C:\SqlXmlTest\SampleUpdateSchema.xml"

  4. Создайте и запустите тестовый скрипт SQLXML 4.0 (Sqlxml4test.vbs), чтобы выполнить шаблон.

    Дополнительные сведения см. в разделе "Использование ADO для выполнения запросов SQLXML 4.0".

См. также

Вопросы безопасности системы обновления (SQLXML 4.0)

  • Last updated on