Annotációs értelmezés – sql:limit-field és sql:limit-value

A következőkre vonatkozik:SQL ServerAzure SQL Database

Az XML Bulk Load a sql:limit-field és sql:limit-value annotációkat dolgozza fel a definíciójuk szerint. További információért lásd: Értékek szűrése sql:limit-field és sql:limit-value (SQLXML 4.0) használatával.

Például, tegyük fel, hogy egy adatbázis tartalmazza a következő táblákat:

• Ügyfél (CustomerID, Cégnév)

• Címek (CustomerID, StreetAddress, AddressType)

Egy ügyfélnek sok címe lehet, és mindegyikhez tartozik egy címtípus (például szállítási cím vagy számlázási cím).

Most tekintsük ezt az XML nézetet ezekről a táblákról, ahogy a következő annotált XSD séma is meghatározza:

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

A séma és XML adatok megszerzése után az XML Bulk Load a BillTo attribútumhoz megadott értéket a CustAddress tábla StreetAddress oszlopába helyezi be, valamint a AddressType oszlop "billing" értékét is.

Hasonlóképpen, az XML Bulk Load a ShipTo attribútumhoz megadott értéket a StreetAddress oszlopba helyezi be, valamint a "shipping" értéket a AddressType oszlopban.

Egy működő minta teszteléséhez

1. A példában megadott sémát SampleSchema.xml.

2. Hozza létre a következő táblázatokat:

   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. A következő mintaadatokat elmentsük 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. Az XML Bulk Load végrehajtásához mentsd el és hajtsa végre ezt a Microsoft Visual Basic Scripting Edition (VBScript) példát Sample.vbs néven:

   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  
   

Ez a megfelelő XDR-séma:

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