Partager via

Interprétation des annotations - sql:limit-field et sql:limit-value

  • Article

S’applique à : SQL Server Azure SQL Database

Le chargement en masse XML traite les annotations sql:limit-field et sql:limit-value selon leur définition. Pour plus d’informations, consultez Filtrage des valeurs à l’aide de sql :limit-field et sql :limit-value (SQLXML 4.0).

Prenons l'exemple d'une base de données contenant les tables suivantes :

  • Customer (CustomerID, CompanyName)

  • Addresses (CustomerID, StreetAddress, AddressType)

Un client peut avoir plusieurs adresses, et chaque adresse est associée à un type d'adresse (par exemple, une adresse d'expédition ou une adresse de facturation).

Examinons à présent cette vue XML de ces tables comme spécifié dans le schéma XSD annoté suivant :

<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="CustAddr"  
        parent="Customer"  
        parent-key="CustomerID"  
        child="Address"  
        child-key="CustomerID" />  
  </xsd:appinfo>  
</xsd:annotation>  
  
  <xsd:element name="Customer" sql:relation="Customer" >  
   <xsd:complexType>  
        <xsd:attribute name="CustomerID"   type="xsd:int" />   
        <xsd:attribute name="CompanyName"  type="xsd:string" />  
        <xsd:attribute name="BillTo"   
                       type="xsd:string"   
                       sql:relation="Address"   
                       sql:field="StreetAddress"  
                       sql:limit-field="AddressType"  
                       sql:limit-value="billing"  
                       sql:relationship="CustAddr" >  
        </xsd:attribute>  
        <xsd:attribute name="ShipTo"   
                       type="xsd:string"   
                       sql:relation="Address"   
                       sql:field="StreetAddress"  
                       sql:limit-field="AddressType"  
                       sql:limit-value="shipping"  
                       sql:relationship="CustAddr" >  
        </xsd:attribute>  
    </xsd:complexType>  
  </xsd:element>  
</xsd:schema>

À la réception de ce schéma et des données XML, le chargement en masse XML insère la valeur spécifiée pour l'attribut BillTo dans la colonne StreetAddress de la table CustAddress avec la valeur « billing » pour la colonne AddressType.

De la même façon, le chargement en masse XML insère la valeur spécifiée pour l'attribut ShipTo dans la colonne StreetAddress avec la valeur « shipping » dans la colonne AddressType.

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 Customer(  
                 CustomerID     int         PRIMARY KEY,  
                 CompanyName    varchar(20) NOT NULL)  
GO  
CREATE TABLE Address(  
                  CustomerID     int        FOREIGN KEY REFERENCES   
                                             Customer(CustomerID),   
                  StreetAddress  varchar(50),  
                  AddressType    varchar(10))  
GO

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

    <Customer CustomerID="1111" CompanyName="Sean Chai" City="NY"   
             BillTo="111 Maple (Billing) "   
             ShipTo="111 Maple (Shipping)" />  
<Customer CustomerID="1112" CompanyName="Dont Know" City="LA"   
             BillTo="222 Spruce (Billing)"   
             ShipTo="222 Spruce (Shipping)" />

  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.XMLFragment = True  
objBL.CheckConstraints=True  
objBL.Execute "c:\SampleSchema.xml", "c:\SampleXMLData.xml"  
set objBL=Nothing

Voici le schéma XDR équivalent :

<?xml version="1.0" ?>  
<Schema xmlns="urn:schemas-microsoft-com:xml-data"  
        xmlns:dt="urn:schemas-microsoft-com:datatypes"  
        xmlns:sql="urn:schemas-microsoft-com:xml-sql">  
  
<ElementType name="Customer" sql:relation="Customer" >  
    <AttributeType name="CustomerID" />  
    <AttributeType name="CompanyName" />  
    <AttributeType name="BillTo" />  
    <AttributeType name="ShipTo" />  
  
    <attribute type="CustomerID" />  
    <attribute type="CompanyName" />  
    <attribute type="BillTo"   
                sql:limit-field="AddressType"  
                sql:limit-value="billing"  
                sql:field="StreetAddress"  
                sql:relation="Address" >  
                <sql:relationship   
                        key="CustomerID"  
                        key-relation="Customer"  
                        foreign-relation="Address"  
                        foreign-key="CustomerID" />  
    </attribute>  
    <attribute type="ShipTo"   
                sql:limit-field="AddressType"  
                sql:limit-value="shipping"  
                sql:field="StreetAddress"  
                sql:relation="Address" >  
                <sql:relationship   
                     key="CustomerID"  
                     key-relation="Customer"  
                     foreign-relation="Address"  
                     foreign-key="CustomerID" />  
    </attribute>  
</ElementType>  
</Schema>