sql:limit-field et sql:limit-value (SQLXML 4.0)

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 de valeurs à l'aide des annotations 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 ces tables :

   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 masse XML, enregistrez cet exemple Microsoft Visual Basic Scripting Edition (VBScript) sous le nom Sample.vbs et exécutez-le :

   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>