Interprétation des annotations - sql:overflow-field

S’applique à : SQL Server Azure SQL Database

Dans un schéma, vous pouvez identifier une colonne en tant que colonne de dépassement destinée à recevoir toutes les données non consommées du document XML. Cette colonne est spécifiée dans le schéma à l’aide de l’annotation sql :overflow-field . Un schéma peut contenir plusieurs colonnes de dépassement.

Chaque fois qu’un nœud XML (élément ou attribut) pour lequel une annotation sql :overflow-field définie entre dans l’étendue, la colonne de dépassement est activée et reçoit des données non agrégées. Lorsque le nœud sort de la portée, la colonne de dépassement n'est plus active et le chargement en masse XML active le champ de dépassement précédent (le cas échéant).

Lorsqu’il stocke des données dans la colonne de dépassement de capacité, le chargement en masse XML stocke également les balises d’ouverture et de fermeture de l’élément parent pour lequel sql :overflow-field est défini.

Par exemple, le schéma suivant décrit les éléments Customers> et< CustOrder>.< Chacun de ces éléments identifie une colonne de dépassement :

<?xml version="1.0" ?>  
<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="ROOT" sql:is-constant="1">  
  <xsd:complexType>  
    <xsd:sequence>   
      <xsd:element name="Customers"   
                   sql:relation="Cust"  
                   sql:overflow-field="OverflowColumn">  
        <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"  
                          sql:overflow-field="OverflowColumn">  
               <xsd:complexType>  
                 <xsd:attribute name="OrderID"/>  
                 <xsd:attribute name="CustomerID"/>  
               </xsd:complexType>  
             </xsd:element>  
          </xsd:sequence>   
        </xsd:complexType>  
      </xsd:element>  
    </xsd:sequence>  
  </xsd:complexType>  
 </xsd:element>  
</xsd:schema>  

Dans le schéma, l’élément <Customer> est mappé à la table Cust et l’élément< Order> est mappé à la table CustOrder.

<Les éléments Customer> et <Order> identifient une colonne de dépassement de capacité. Par conséquent, le chargement en masse XML enregistre tous les éléments et attributs enfants nonconsumés de l’élément <Customer> dans la colonne de dépassement de capacité de la table Cust, ainsi que tous les éléments enfants et attributs nonconsumés de l’élément< Order> dans la colonne de dépassement de la table CustOrder.

Pour tester un exemple fonctionnel

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

2. Créez les tables suivantes :

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

3. Enregistrez l'exemple de données XML ci-après sous le nom SampleXMLData.xml :

   <ROOT>  
     <Customers>  
       <CustomerID>1111</CustomerID>  
       <CompanyName>Hanari Carnes</CompanyName>  
       <City><![CDATA[NY]]> </City>  
         <Junk>garbage in overflow</Junk>  
       <Order OrderID="1" />  
       <Order OrderID="2" />  
    </Customers>  
    <Customers>  
      <CustomerID>1112</CustomerID>  
      <CompanyName>Toms Spezialitten</CompanyName>  
      <City><![CDATA[LA]]> </City>  
      <xyz><address>111 Maple, Seattle</address></xyz>     
      <Order OrderID="3" />  
    </Customers>  
      <Customers>  
      <CustomerID>1113</CustomerID>  
      <CompanyName>Victuailles en stock</CompanyName>  
      <Order OrderID="4" />  
     </Customers>  
   </ROOT>  
   

4. Pour exécuter le chargement en bloc XML, enregistrez et exécutez cet exemple Microsoft Visual Basic Scripting Edition (VBScript) en tant qu’Sample.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.Execute "c:\SampleSchema.xml", "c:\SampleXMLData.xml"  
   set objBL=Nothing