sql:overflow-field(SQLXML 4.0)

아티클
03/06/2017

스키마에서 열을 오버플로 열로 식별하여 XML 문서에서 사용되지 않은 데이터를 모두 받을 수 있습니다. 이 열은 sql:overflow-field 주석을 사용하여 스키마에 지정합니다. 오버플로 열을 여러 개 지정할 수도 있습니다.

sql:overflow-field 주석이 정의되어 있는 XML 노드(요소 또는 특성)가 범위에 들어오면 오버플로 열이 활성화되어 사용되지 않은 데이터를 받습니다. 노드가 범위를 벗어나면 오버플로 열이 더 이상 활성화되지 않고 XML 대량 로드를 통해 이전 오버플로 필드(있는 경우)가 활성화됩니다.

XML 대량 로드에서는 오버플로 열에 데이터를 저장할 때 sql:overflow-field가 정의된 부모 요소의 여는 태그와 닫는 태그도 저장됩니다.

예를 들어 다음 스키마는 Customers> 및 CustOrder 요소를 설명합니다<.>< 이러한 각 요소는 오버플로 열을 식별합니다.

<?xml version="1.0" ?>  
<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="CustCustOrder"  
        parent="Cust"  
        parent-key="CustomerID"  
        child="CustOrder"  
        child-key="CustomerID" />  
  </xsd:appinfo>  
 </xsd:annotation>  
 <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:sequence>   
             <xsd:element name="CustomerID" type="xsd:integer"/>  
             <xsd:element name="CompanyName"  type="xsd:string"/>  
             <xsd:element name="City" type="xsd:string"/>  
             <xsd:element name="Order"  
                          sql:relation="CustOrder"  
                          sql:relationship="CustCustOrder"  
                          sql:overflow-field="OverflowColumn">  
               <xsd:complexType>  
                 <xsd:attribute name="OrderID"/>  
                 <xsd:attribute name="CustomerID"/>  
               </xsd:complexType>  
             </xsd:element>  
          </xsd:sequence>   
        </xsd:complexType>  
      </xsd:element>  
    </xsd:sequence>  
  </xsd:complexType>  
 </xsd:element>  
</xsd:schema>

스키마 <에서 Customer> 요소는 Cust 테이블에 매핑되고 <Order> 요소는 CustOrder 테이블에 매핑됩니다.

<Customer> 및 <Order> 요소는 모두 오버플로 열을 식별합니다. 따라서 XML 대량 로드는 Cust 테이블의 오버플로 열에 있는 Customer> 요소의< 모든 unconsumed 자식 요소 및 특성과 CustOrder 테이블의 오버플로 열에 있는 Order> 요소의< 모든 unconsumed 자식 요소 및 특성을 저장합니다.

작업 예제를 테스트하려면

이 예에서 제공하는 스키마를 SampleSchema.xml로 저장합니다.

다음 테이블을 만듭니다.

CREATE TABLE Cust (  
          CustomerID     int         PRIMARY KEY,  
          CompanyName    varchar(20) NOT NULL,  
          City           varchar(20) DEFAULT 'Seattle',  
          OverflowColumn nvarchar(200))  
GO  
CREATE TABLE CustOrder (  
          OrderID        int         PRIMARY KEY,  
          CustomerID     int         FOREIGN KEY REFERENCES  
                                          Cust(CustomerID),  
          OverflowColumn nvarchar(200))  
GO

다음 예제 XML 데이터를 SampleXMLData.xml로 저장합니다.

<ROOT>  
  <Customers>  
    <CustomerID>1111</CustomerID>  
    <CompanyName>Hanari Carnes</CompanyName>  
    <City><![CDATA[NY]]> </City>  
      <Junk>garbage in overflow</Junk>  
    <Order OrderID="1" />  
    <Order OrderID="2" />  
 </Customers>  
 <Customers>  
   <CustomerID>1112</CustomerID>  
   <CompanyName>Toms Spezialitten</CompanyName>  
   <City><![CDATA[LA]]> </City>  
   <xyz><address>111 Maple, Seattle</address></xyz>     
   <Order OrderID="3" />  
 </Customers>  
   <Customers>  
   <CustomerID>1113</CustomerID>  
   <CompanyName>Victuailles en stock</CompanyName>  
   <Order OrderID="4" />  
  </Customers>  
</ROOT>

XML 대량 로드를 실행하려면 다음 Microsoft VBScript(Visual Basic Scripting Edition) 예제를 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

다음을 통해 공유

sql:overflow-field(SQLXML 4.0)

작업 예제를 테스트하려면

추가 리소스