Interprétation des annotations - sql:relationship et Key Ordering Rule

S’applique à : SQL Server Azure SQL Database

Étant donné que le chargement en masse XML génère des enregistrements à mesure que leurs nœuds entrent dans l’étendue et les envoie à Microsoft SQL Server en tant qu’étendue de sortie des nœuds, les données de l’enregistrement doivent être présentes dans l’étendue du nœud.

Considérez le schéma XSD suivant, dans lequel la relation un-à-plusieurs entre les éléments Client> et <Commande> (un client peut passer de nombreuses commandes) est spécifiée à l’aide de l’élément <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>  

Lorsque le nœud de l’élément Customer> entre dans l’étendue<, le chargement en masse XML génère un enregistrement client. Cet enregistrement reste jusqu’à ce que le chargement en masse XML lise </Customer>. Lors du traitement du nœud d’élément Order>, le chargement en bloc XML utilise< sql :relationship> pour obtenir la valeur de la colonne de clé étrangère CustomerID de la table CustOrder à partir de l’élément< parent Customer>, car l’élément< Order> ne spécifie pas l’attribut CustomerID.< Cela signifie que dans la définition de l’élément <Customer>, vous devez spécifier l’attribut CustomerID dans le schéma avant de spécifier <sql :relationship.> Sinon, lorsqu’un <élément Order> entre dans l’étendue, le chargement en masse XML génère un enregistrement pour la table CustOrder et lorsque le chargement en masse XML atteint la <balise /Order> end, il envoie l’enregistrement à SQL Server sans la valeur de colonne de clé étrangère CustomerID.

Enregistrez le schéma fourni dans cet exemple sous le nom SampleSchema.xml.

Pour tester un exemple fonctionnel

1. Créez les tables suivantes :

   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. Enregistrez l'exemple de données ci-après sous le nom 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. Pour exécuter le chargement en bloc XML, enregistrez et exécutez l’exemple Microsoft Visual Basic Scripting Edition (VBScript) suivant en tant que 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  
   

   Il en résulte que la fonctionnalité de chargement en masse XML insère une valeur NULL dans la colonne de clé étrangère CustomerID de la table CustOrder. Si vous modifiez les exemples de données XML afin que l’élément enfant CustomerID> apparaisse avant l’élément <Enfant Order>, vous obtenez le résultat attendu : le chargement en masse XML insère la valeur de clé étrangère spécifiée dans la colonne.<

Voici le schéma XDR équivalent :

<?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>