sql:mapped (SQLXML 4.0)

La carga masiva XML procesa la anotación sql:mapped en el esquema XSD tal y como está previsto, es decir: si el esquema de asignación especifica sql:mapped="false" para cualquier elemento o atributo, la carga masiva XML no intenta almacenar los datos asociados en la columna correspondiente.

La carga masiva XML omite los elementos y atributos que no están asignados (ya sea porque no se describen en el esquema o porque se anotan en el esquema XSD con sql:mapped="false"). Todos los datos no asignados van a la columna de desbordamiento si este tipo de columna está especificado utilizando sql:overflow-field.

Por ejemplo, fíjese en este esquema XSD:

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

Puesto que el atributo HomePhone especifica sql:mapped="false", la carga masiva XML no lo asigna a la columna correspondiente. El esquema XSD identifica una columna de desbordamiento (OverflowColumn) en la que la carga masiva XML almacena estos datos no consumidos.

Para probar un ejemplo funcional

1. Cree la siguiente tabla en la base de datos 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. Guarde el esquema que se proporciona en este ejemplo como SampleSchema.xml.

3. Guarde los siguientes datos XML de ejemplo como 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. Para ejecutar Carga masiva XML, guarde y ejecute este ejemplo de Microsoft Visual Basic Scripting Edition (VBScript) como 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
   

Este es el esquema 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>