Interpretazione delle annotazioni - sql:mapped

  • Articolo

Si applica a: SQL Server database SQL di Azure

Il caricamento bulk XML elabora l'annotazione sql:mapped nello schema XSD come previsto, se lo schema di mapping specifica sql:mapped="false" per qualsiasi elemento o attributo, il caricamento bulk XML non tenta di 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 o 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 overflow (OverflowColumn) in cui 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 questo esempio come 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 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 indicato 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>