Compartilhar via

Interpretação de anotação – sql:mapped

  • Artigo

Aplica-se a: Banco de Dados SQL do Azure do SQL Server

O XML Bulk Load processa a anotação sql:mapped no esquema XSD conforme o esperado, ou seja, se o esquema de mapeamento especificar sql:mapped="false" para qualquer elemento ou atributo, o XML Bulk Load não tentará armazenar os dados associados na coluna correspondente.

O carregamento em massa de XML ignora elementos e atributos que não estão mapeados (seja porque eles não estão descritos no esquema ou porque estão anotados no esquema XSD com sql:mapped="false"). Todos os dados não mapeados vão para a coluna de estouro, se essa coluna for especificada usando sql:overflow-field.

Por exemplo, considere 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>

Como o atributo HomePhone especifica sql:mapped="false", o Carregamento em Massa XML não mapeia esse atributo para a coluna correspondente. O esquema XSD identifica uma coluna de estouro (OverflowColumn) na qual o XML Bulk Load armazena esses dados não consumidos.

Para testar um exemplo de funcionamento

  1. Crie a seguinte tabela no banco de dados 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. Salve o esquema fornecido neste exemplo como SampleSchema.xml.

  3. Salve os dados XML de exemplo a seguir 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 executar o XML Bulk Load, salve e execute este exemplo do 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 é o 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>