sql:relationship e a Regra de Ordenação de Chaves (SQLXML 4.0)

Como o XML Bulk Load gera registros à medida que seus nós entram no escopo e envia esses registros para o Microsoft SQL Server à medida que seus nós saem do escopo, os dados do registro devem estar presentes no escopo do nó. 

Considere o seguinte esquema XSD, no qual uma relação um para muitos entre os elementos <Customer> e <Order> (um cliente pode fazer muitos pedidos) é especificada com o elemento <sql:relationship>:

<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="CustCustOrder"
          parent="Cust"
          parent-key="CustomerID"
          child="CustOrder"
          child-key="CustomerID" />
  </xsd:appinfo>
</xsd:annotation>

  <xsd:element name="Customers" sql:relation="Cust" >
   <xsd:complexType>
     <xsd:sequence>
       <xsd:element name="CustomerID"  type="xsd:integer" />
       <xsd:element name="CompanyName" type="xsd:string" />
       <xsd:element name="City"        type="xsd:string" />
       <xsd:element name="Order" 
                          sql:relation="CustOrder"
                          sql:relationship="CustCustOrder" >
         <xsd:complexType>
          <xsd:attribute name="OrderID" type="xsd:integer" />
         </xsd:complexType>
       </xsd:element>
     </xsd:sequence>
    </xsd:complexType>
  </xsd:element>
</xsd:schema>

Como o nó do elemento <Customer> é especificado no escopo, o XML Bulk Load gera um registro de cliente. Este registro permanece até o XML Bulk Load exibir </Customer.>. No processamento do nó do elemento <Order>, o XML Bulk Load usa <sql:relationship> para obter o valor da coluna da chave estrangeira CustomerID da tabela CustOrder do elemento pai <Customer>, pois o elemento <Order> não especifica o atributo CustomerID. Isto significa que na definição do elemento <Customer>, você deve especificar o atributo CustomerID no esquema antes de especificar <sql:relationship>. Caso contrário, quando um elemento <Order> for especificado no escopo, o XML Bulk Load gerará um registro para a tabela CustOrder e, quando o XML Bulk Load atingir a marca de fim </Order>, ele enviará o registro para o SQL Server sem o valor de coluna da chave estrangeira CustomerID.

Salve o esquema fornecido neste exemplo como SampleSchema.xml.

Para testar um exemplo de funcionamento

1. Crie estas tabelas:

   CREATE TABLE Cust (
                 CustomerID     int          PRIMARY KEY,
              CompanyName    varchar(20)  NOT NULL,
                 City           varchar(20)  DEFAULT 'Seattle')
   GO
   CREATE TABLE CustOrder (
                 OrderID        varchar(10) PRIMARY KEY,
              CustomerID     int         FOREIGN KEY REFERENCES                                          Cust(CustomerID))
   GO
   

2. Salve os dados de exemplo a seguir como SampleXMLData.xml:

   <ROOT>  
     <Customers>
       <CompanyName>Hanari Carnes</CompanyName>
       <City>NY</City>
       <Order OrderID="1" />
       <Order OrderID="2" />
       <CustomerID>1111</CustomerID>
     </Customers>
     <Customers>
       <CompanyName>Toms Spezialitten</CompanyName>
        <City>LA</City>  
       <Order OrderID="3" />
       <CustomerID>1112</CustomerID>
     </Customers>
     <Customers>
       <CompanyName>Victuailles en stock</CompanyName>
       <Order OrderID="4" />
       <CustomerID>1113</CustomerID>
     </Customers>
   </ROOT>
   

3. Para executar o XML Bulk Load, salve e execute o seguinte exemplo do Microsoft Visual Basic Scripting Edition (VBScript) como MySample.vbs:

   set objBL = CreateObject("SQLXMLBulkLoad.SQLXMLBulkload.4.0")
   objBL.ConnectionString = "provider=SQLOLEDB;data source=localhost;database=tempdb;integrated security=SSPI"
   objBL.ErrorLogFile = "c:\error.log"
   objBL.CheckConstraints = True
   objBL.Transaction=True
   objBL.Execute "c:\SampleSchema.xml", "c:\SampleXMLData.xml"
   set objBL=Nothing
   

   O resultado é que o XML Bulk Load insere um valor NULL na coluna de chave estrangeira CustomerID da tabela CustOrder. Se revisar os exemplos de dados XML, de forma que o elemento filho <CustomerID> seja exibido antes do elemento filho <Order>, você obterá o resultado esperado: o XML Bulk Load insere na coluna o valor especificado da chave estrangeira.

Este é o esquema XDR equivalente:

<?xml version="1.0" ?>
<Schema xmlns="urn:schemas-microsoft-com:xml-data" 
        xmlns:dt="urn:schemas-microsoft-com:xml:datatypes"  
        xmlns:sql="urn:schemas-microsoft-com:xml-sql" > 
   <ElementType name="CustomerID"  />
   <ElementType name="CompanyName" />
   <ElementType name="City"        />

   <ElementType name="root" sql:is-constant="1">
      <element type="Customers" />
   </ElementType>

   <ElementType name="Customers" sql:relation="Cust" >
      <element type="CustomerID" sql:field="CustomerID" />
      <element type="CompanyName" sql:field="CompanyName" />
      <element type="City" sql:field="City" />
      <element type="Order" >
                 <sql:relationship
                        key-relation    ="Cust"
                        key             ="CustomerID"
                        foreign-key     ="CustomerID"
                        foreign-relation="CustOrder" />
      </element>
   </ElementType>
    <ElementType name="Order" sql:relation="CustOrder" >
      <AttributeType name="OrderID" />
      <AttributeType name="CustomerID" />
      <attribute type="OrderID" />
      <attribute type="CustomerID" />
    </ElementType>
</Schema>