sql:mapped (SQLXML 4.0)

Il caricamento bulk XML elabora l'annotazione sql:mapped nello schema XSD nel modo previsto, ovvero se lo schema di mapping specifica sql:mapped="false" per un elemento o un attributo, il caricamento bulk XML non prova ad archiviare i dati associati nella colonna corrispondente.

Il caricamento bulk XML ignora gli elementi e gli attributi non mappati (perché non sono descritti nello schema oppure perché vengono annotati nello schema XSD con sql:mapped="false"). Tutti i dati non mappati vengono inseriti nella colonna di overflow, se tale colonna viene specificata tramite sql:overflow-field.

Si consideri, ad esempio, lo schema XSD seguente:

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">
<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:attribute name="CustomerID"  type="xsd:integer" />
       <xsd:attribute name="CompanyName" type="xsd:string" />
       <xsd:attribute name="City"        type="xsd:string" />
       <xsd:attribute name="HomePhone"   type="xsd:string" 
                                       sql:mapped="false" />
    </xsd:complexType>
  </xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:schema>

Poiché l'attributo HomePhone specifica sql:mapped="false", il caricamento bulk XML non esegue il mapping di questo attributo alla colonna corrispondente. Lo schema XSD identifica una colonna di overflow (OverflowColumn) nella quale il caricamento bulk XML archivia questi dati non utilizzati.

Per testare un esempio reale

1. Creare la tabella seguente nel database tempdb:

   USE tempdb
   CREATE TABLE Cust
             (CustomerID     int         PRIMARY KEY,
              CompanyName    varchar(20) NOT NULL,
              City           varchar(20) DEFAULT 'Seattle',
              OverflowColumn nvarchar(200))
   GO
   

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

3. Salvare i dati XML di esempio seguenti come file SampleXMLData.xml:

   <ROOT>
     <Customers CustomerID="1111" CompanyName="Sean Chai" 
                City="NY" HomePhone="111-1111" />
     <Customers CustomerID="1112" CompanyName="Dont Know" 
                City="LA" HomePhone="222-2222" />
   </ROOT>
   

4. Per eseguire il caricamento bulk XML, salvare ed eseguire questo esempio di Microsoft Visual Basic, Scripting Edition (VBScript) come file 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
   

Di seguito viene riportato lo schema XDR equivalente:

<?xml version="1.0" ?>
<Schema xmlns="urn:schemas-microsoft-com:xml-data" 
        xmlns:sql="urn:schemas-microsoft-com:xml-sql" > 
   <ElementType name="ROOT" sql:is-constant="1">
      <element type="Customers" />
   </ElementType>
   <ElementType name="Customers" sql:relation="Cust"
                             sql:overflow-field="OverflowColumn" >
      <AttributeType name="CustomerID" />
      <AttributeType name="CompanyName"  />
      <AttributeType name="City"  />
      <AttributeType name="HomePhone" />
      <attribute type="CustomerID"  />
      <attribute type="CompanyName"  />
      <attribute type="City" />
      <attribute type="HomePhone" sql:map-field="0" />
   </ElementType>
</Schema>