sql:relationship e regola di ordinamento delle chiavi (SQLXML 4.0)

Poiché il caricamento bulk XML consente di generare record quando i nodi entrano nell'ambito e di inviare tali record a Microsoft SQL Server quando i nodi abbandonano l'ambito, i dati per il record devono essere presenti nell'ambito del nodo. 

Si consideri lo schema XSD seguente, in cui viene specificata la relazione uno-a-molti tra gli elementi <Customer> e <Order> (un cliente può effettuare molti ordini) tramite l'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>

Quando il nodo elemento <Customer> entra nell'ambito, il caricamento bulk XML genera un record del cliente. Questo record viene mantenuto fino a quando il caricamento bulk XML non legge </Customer>. Nell'elaborare il nodo elemento <Order>, il caricamento bulk XML utilizza <sql:relationship> per ottenere il valore della colonna di chiave esterna CustomerID della tabella CustOrder dall'elemento padre <Customer>, in quanto l'elemento <Order> non specifica l'attributo CustomerID. Di conseguenza, nel definire l'elemento <Customer>, è necessario specificare l'attributo CustomerID nello schema prima di specificare <sql:relationship>. In caso contrario, quando un elemento <Order> entra nell'ambito, il caricamento bulk XML consente di generare un record per la tabella CustOrder e quando il caricamento bulk XML raggiunge il tag di fine </Order>, consente di inviare il record a SQL Server senza il valore della colonna di chiave esterna CustomerID.

Salvare lo schema fornito in questo esempio come file SampleSchema.xml.

Per testare un esempio reale

1. Creare le tabelle seguenti:

   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. Salvare i dati di esempio seguenti come file 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. Per eseguire il caricamento bulk XML, salvare ed eseguire l'esempio di Microsoft Visual Basic, Scripting Edition (VBScript) seguente come file 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
   

   Come risultato, il caricamento bulk XML inserisce un valore NULL nella colonna di chiave esterna CustomerID della tabella CustOrder. Se in seguito a revisione si modificano i dati di esempio XML in modo che l'elemento figlio <CustomerID> venga visualizzato prima dell'elemento figlio <Order>, si ottiene il risultato previsto, ovvero il caricamento bulk XML inserisce nella colonna il valore di chiave esterna specificato.

Di seguito viene riportato lo schema 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>