註釋解譯 - sql：limit-field 和 sql：limit-value

發行項
07/05/2024

XML 大量載入會依其定義處理 sql：limit-field 和 sql：limit-value 批注。如需詳細資訊，請參閱使用 sql：limit-field 篩選值和 sql：limit-value （SQLXML 4.0）。

例如，假設資料庫包含下列資料表：

客戶（CustomerID， CompanyName）
位址（CustomerID、StreetAddress、AddressType）

客戶可以有許多位址，而且每個位址都有與其相關聯的位址類型（例如，送貨位址或帳單位址）。

現在，請考慮這些數據表的這個 XML 檢視，如下列批注 XSD 架構中所指定：

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

收到此架構和 XML 數據時，XML 大量載入會將 BillTo 屬性指定的值插入 CustAddress 數據表的 StreetAddress 數據行，以及 AddressType 數據行的 “billing” 值。

同樣地，XML 大量載入會將 ShipTo 屬性指定的值插入 StreetAddress 資料行，以及 AddressType 資料行中的“shipping” 值。

測試工作範例

將此範例中提供的架構儲存為 SampleSchema.xml。

建立這些資料表：

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

將下列範例數據儲存為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)" />

若要執行 XML 大量載入，請將此Microsoft Visual Basic Scripting Edition （VBScript）範例儲存並執行為 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

這是對等的 XDR 架構：

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

共用方式為

註釋解譯 - sql：limit-field 和 sql：limit-value

測試工作範例

意見反應

其他資源