다음을 통해 공유


레코드 생성 프로세스(SQLXML 4.0)

XML 대량 로드는 XML 입력 데이터를 처리하고 Microsoft SQL Server의 적절한 테이블로 사용할 수 있도록 레코드를 준비합니다. XML 대량 로드의 로직은 새 레코드를 생성할 시기, 레코드 필드로 복사할 자식 요소나 특성 값, 레코드가 완성되어 SQL Server에 삽입할 수 있도록 보낼 준비가 끝나는 시기를 결정합니다.

XML 대량 로드는 전체 XML 입력 데이터를 메모리로 로드하지 않으며 SQL Server에 데이터를 보내기 전에 전체 레코드 집합을 생성하지 않습니다. 이것은 XML 입력 데이터가 큰 문서일 수 있으며 전체 문서를 메모리로 로드하면 많은 비용이 들 수 있기 때문입니다. 대신 XML 대량 로드는 다음을 수행합니다.

  1. 매핑 스키마를 분석하고 필요한 실행 계획을 준비합니다.

  2. 실행 계획을 입력 스트림의 데이터에 적용합니다.

이 순차적 처리에서는 XML 입력 데이터를 특정 방식으로 제공해야 하므로 XML 대량 로드가 매핑 스키마를 분석하는 방법과 레코드 생성 프로세스가 발생하는 방식을 이해하고 있어야 합니다. 이러한 이해를 바탕으로 XML 대량 로드에 원하는 결과를 생성하는 매핑 스키마를 제공할 수 있습니다.

XML 대량 로드는 주석을 사용하여 명시적으로 지정되거나 기본 매핑을 통해 암시적으로 지정된 열 및 테이블 매핑을 비롯한 일반적인 매핑 스키마 주석과 조인 관계를 처리합니다.

[!참고]

여기에서는 주석이 추가된 XSD 또는 XDR 매핑 스키마를 잘 알고 있다고 가정합니다. 스키마에 대한 자세한 내용은 주석이 추가된 XSD 스키마 소개(SQLXML 4.0) 또는 주석이 추가된 XDR 스키마(SQLXML 4.0에서는 더 이상 사용되지 않음)를 참조하십시오.

레코드 생성을 이해하려면 다음 개념을 이해해야 합니다.

  • 노드 범위

  • 레코드 생성 규칙

  • 레코드 하위 집합 및 키 순서 지정 규칙

  • 레코드 생성 규칙의 예외

노드 범위

XML 대량 로드가 XML 입력 데이터 스트림을 처리할 때 XML 문서의 노드(요소 또는 특성)는 범위를 시작하게 됩니다. 요소 노드의 경우 요소의 시작 태그로 요소의 범위가 시작됩니다. 특성 노드의 경우 특성 이름으로 특성의 범위가 시작됩니다.

범위에 사용할 데이터가 더 이상 없을 때 노드에서 범위가 끝납니다. 즉, 끝 태그(요소 노드의 경우)나 특성 값 끝(특성 노드의 경우)에서 범위가 끝납니다.

레코드 생성 규칙

노드(요소 또는 특성)에서 범위가 시작되면 해당 노드에서 레코드가 생성될 수 있습니다. 이러한 레코드는 연결된 노드가 범위에 속하는 동안 유지됩니다. 노드가 범위를 벗어나면 XML 대량 로드는 생성된 레코드가 완성된 것으로 간주하여 해당 레코드를(데이터와 함께) 삽입할 수 있도록 SQL Server로 보냅니다.

예를 들어, 다음 XSD 스키마 조각을 고려해 보십시오.

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">
  <xsd:element name="Customer" sql:relation="Customers" >
   <xsd:complexType>
     <xsd:attribute name="CustomerID" type="xsd:string" />
     <xsd:attribute name="CompanyName" type="xsd:string" />
    </xsd:complexType>
  </xsd:element>
</xsd:schema>

이 스키마는 CustomerIDCompanyName 특성을 사용하여 <Customer> 요소를 지정합니다. sql:relation 주석은 <Customer> 요소를 Customers 테이블에 매핑합니다.

다음 XML 문서 조각을 고려하십시오.

<Customer CustomerID="1" CompanyName="xyz" />
<Customer CustomerID="2" CompanyName="abc" />
...

XML 대량 로드에 이전 단락에서 설명한 스키마와 XML 데이터가 입력으로 제공되면 XML 대량 로드는 원본 데이터에서 다음과 같은 방식으로 노드(요소와 특성)를 처리합니다.

  • 첫 번째 <Customer> 요소의 시작 태그로 해당 요소의 범위가 시작됩니다. 이 노드는 Customers 테이블에 매핑되므로 XML 대량 로드는 Customers 테이블에 대한 레코드를 생성합니다.

  • 스키마에서 <Customer> 요소의 모든 특성은 Customers 테이블의 열에 매핑됩니다. 이러한 특성의 범위가 시작되면 XML 대량 로드는 해당 값을 부모 범위에 의해 미리 생성된 고객 레코드에 복사합니다.

  • XML 대량 로드가 <Customer> 요소의 끝 태그에 도달하면 해당 요소의 범위가 끝납니다. 그러면 XML 대량 로드는 레코드가 완료된 것으로 간주하고 SQL Server로 해당 레코드를 보냅니다.

XML 대량 로드는 각 후속 <Customer> 요소에 대해서도 이 프로세스를 따릅니다.

중요 정보중요

이 모델에서는 끝 태그에 도달할 때(또는 노드가 범위를 벗어날 때) 레코드가 삽입되므로 레코드와 관련된 모든 데이터를 노드 범위 내에 정의해야 합니다.

레코드 하위 집합 및 키 순서 지정 규칙

<sql:relationship>을 사용하는 매핑 스키마를 지정할 때 하위 집합이라는 용어는 관계의 외래 쪽에서 생성되는 레코드 집합을 나타냅니다. 다음 예에서는 CustOrder 레코드가 <sql:relationship>의 외래 쪽에 있습니다.

예를 들어 데이터베이스에 다음과 같은 테이블이 포함된다고 가정합니다.

  • Cust (CustomerID, CompanyName, City)

  • CustOrder (CustomerID, OrderID)

CustOrder 테이블의 CustomerID는 Cust 테이블의 CustomerID 기본 키를 참조하는 외래 키입니다.

이제 다음과 같은 주석이 추가된 XSD 스키마에 지정된 XML 뷰를 고려해 보십시오. 이 스키마에서는 <sql:relationship>을 사용하여 Cust 및 CustOrder 테이블 간의 관계를 지정합니다.

<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="Customers" sql:relation="Cust" >
   <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" >
         <xsd:complexType>
          <xsd:attribute name="OrderID" type="xsd:integer" />
         </xsd:complexType>
       </xsd:element>
     </xsd:sequence>
    </xsd:complexType>
  </xsd:element>
</xsd:schema>

예제 XML 데이터와 작업 예제를 만드는 단계는 아래에 지정되어 있습니다.

  • XML 데이터 파일의 <Customer> 요소 노드가 범위를 시작하면 XML 대량 로드가 Cust 테이블에 대한 레코드를 생성합니다. 그런 다음 XML 대량 로드는 <CustomerID>, <CompanyName><City> 자식 요소의 범위가 시작될 때 해당 자식 요소에서 필요한 열 값(CustomerID, CompanyName 및 City)을 복사합니다.

  • <Order> 요소 노드가 범위를 시작하면 XML 대량 로드는 CustOrder 테이블에 대한 레코드를 생성합니다. XML 대량 로드는 OrderID 특성 값을 이 레코드에 복사합니다. CustomerID 열에 필요한 값은 <Customer> 요소의 <CustomerID> 자식 요소에서 가져옵니다. <Order> 요소에 CustomerID 특성이 지정되어 있지 않는 한 XML 대량 로드는 <sql:relationship>에 지정된 정보를 사용하여 이 레코드에 대한 CustomerID 외래 키 값을 가져옵니다. 일반 규칙은 자식 요소가 외래 키 특성 값을 명시적으로 지정하는 경우 XML 대량 로드가 해당 값을 사용하고 지정된 <sql:relationship>을 사용하여 부모 요소에서 값을 가져오지 않는 것입니다. 이 <Order> 요소 노드가 범위를 벗어나면 XML 대량 로드는 레코드를 SQL Server로 보낸 다음 모든 후속 <Order> 요소 노드를 같은 방식으로 처리합니다.

  • 마지막으로 <Customer> 요소 노드가 범위를 벗어납니다. 이 시점에서 XML 대량 로드가 고객 레코드를 SQL Server로 보냅니다. XML 대량 로드는 XML 데이터 스트림의 모든 후속 고객에 대해 이 프로세스를 따릅니다.

여기서 매핑 스키마에 대한 두 가지 사항을 확인할 수 있습니다.

  • 스키마가 "포함" 규칙을 충족할 경우(예를 들어, 고객 및 주문과 관련된 모든 데이터가 연결된 <Customer><Order> 요소 노드의 범위 내에서 정의되어 있음) 대량 로드가 성공합니다.

  • <Customer> 요소를 설명할 때 해당 자식 요소가 적절한 순서로 지정되어 있습니다. 이 경우 <CustomerID> 자식 요소는 <Order> 자식 요소 이전에 지정됩니다. 이것은 입력 XML 데이터 파일에서 <Order> 요소의 범위가 시작되면 <CustomerID> 요소 값을 외래 키 값으로 사용할 수 있다는 의미입니다. 키 특성이 먼저 지정되므로 이것은 "키 순서 지정 규칙"입니다.

    <CustomerID> 자식 요소를 <Order> 자식 요소 다음에 지정하면 <Order> 요소의 범위가 시작될 때 CustomerID 자식 요소의 값을 사용할 수 없습니다. 계속해서 </Order> 끝 태그를 읽고 CustOrder 테이블에 대한 레코드가 완료된 것으로 간주되어 CustOrder 테이블에 CustomerID 열은 NULL 값인 상태로 삽입됩니다. 이것은 원하는 결과가 아닙니다.

작업 예제를 만들려면

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

  2. 다음 테이블을 만듭니다.

    CREATE TABLE Cust (
                  CustomerID     int         PRIMARY KEY,
                  CompanyName    varchar(20) NOT NULL,
                  City           varchar(20) DEFAULT 'Seattle')
    GO
    CREATE TABLE CustOrder (
                 OrderID        int         PRIMARY KEY,
                 CustomerID     int         FOREIGN KEY REFERENCES                                          Cust(CustomerID))
    GO
    
  3. 다음 예제 XML 입력 데이터를 SampleXMLData.xml로 저장합니다.

    <ROOT>
      <Customers>
        <CustomerID>1111</CustomerID>
        <CompanyName>Hanari Carnes</CompanyName>
        <City>NY</City> 
        <Order OrderID="1" />
        <Order OrderID="2" />
      </Customers>
    
      <Customers>
        <CustomerID>1112</CustomerID>
        <CompanyName>Toms Spezialitten</CompanyName>
        <City>LA</City>
        <Order OrderID="3" />
      </Customers>
      <Customers>
        <CustomerID>1113</CustomerID>
        <CompanyName>Victuailles en stock</CompanyName>
        <Order OrderID="4" />
    </Customers>
    </ROOT>
    
  4. XML 대량 로드를 실행하려면 다음 Microsoft VBScript(Visual Basic Scripting Edition) 예제(BulkLoad.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
    

레코드 생성 규칙의 예외

노드가 IDREF 또는 IDREFS 형식인 경우 XML 대량 로드는 범위가 시작될 때 노드에 대한 레코드를 생성하지 않습니다. 따라서 스키마의 특정 위치에 레코드의 완전한 설명이 존재해야 합니다. IDREFS 형식이 무시되는 것처럼 dt:type="nmtokens" 주석이 무시됩니다.

예를 들어 <Customer><Order> 요소를 설명하는 다음과 같은 XSD 스키마를 가정해 보겠습니다. <Customer> 요소에는 IDREFS 형식인 OrderList 특성이 포함됩니다. <sql:relationship> 태그는 고객과 주문 목록 간의 일 대 다 관계를 지정합니다.

스키마는 다음과 같습니다.

<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="Customers" sql:relation="Cust" >
   <xsd:complexType>
    <xsd:attribute name="CustomerID" type="xsd:integer" />
    <xsd:attribute name="CompanyName" type="xsd:string" />
    <xsd:attribute name="City" type="xsd:string" />
    <xsd:attribute name="OrderList" 
                       type="xsd:IDREFS" 
                       sql:relation="CustOrder" 
                       sql:field="OrderID"
                       sql:relationship="CustCustOrder" >
    </xsd:attribute>
  </xsd:complexType>
 </xsd:element>

  <xsd:element name="Order" sql:relation="CustOrder" >
   <xsd:complexType>
    <xsd:attribute name="OrderID" type="xsd:string" />
    <xsd:attribute name="CustomerID" type="xsd:integer" />
    <xsd:attribute name="OrderDate" type="xsd:date" />
  </xsd:complexType>
 </xsd:element>
</xsd:schema>

대량 로드가 IDREFS 형식의 노드를 무시하므로 OrderList 특성 노드의 범위가 시작될 때 레코드가 생성되지 않습니다. 따라서 Orders 테이블에 주문 레코드를 추가하려면 스키마의 특정 위치에서 해당 주문을 설명해야 합니다. 이 스키마에서는 <Order> 요소를 지정하여 XML 대량 로드가 주문 레코드를 Orders 테이블에 추가하게 합니다. <Order> 요소는 CustOrder 테이블에 레코드를 입력하는 데 필요한 모든 특성을 설명합니다.

<Customer> 요소의 CustomerIDOrderID 값이 <Order> 요소의 값과 일치하는지 확인해야 합니다. 참조 무결성을 유지하는 책임은 사용자에게 있습니다.

작업 예제를 테스트하려면

  1. 다음 테이블을 만듭니다.

    CREATE TABLE Cust (
                  CustomerID     int          PRIMARY KEY,
                  CompanyName    varchar(20)  NOT NULL,
                  City           varchar(20)  DEFAULT 'Seattle')
    GO
    CREATE TABLE CustOrder (
                  OrderID        varchar(10) PRIMARY KEY,
                  CustomerID     int         FOREIGN KEY REFERENCES                                          Cust(CustomerID),
                  OrderDate      datetime DEFAULT '2000-01-01')
    GO
    
  2. 이 예에서 제공하는 매핑 스키마를 SampleSchema.xml로 저장합니다.

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

    <ROOT>
      <Customers CustomerID="1111" CompanyName="Sean Chai" City="NY"
                 OrderList="Ord1 Ord2" />
      <Customers CustomerID="1112" CompanyName="Dont Know" City="LA"
                 OrderList="Ord3 Ord4" />
      <Order OrderID="Ord1" CustomerID="1111" OrderDate="1999-01-01" />
      <Order OrderID="Ord2" CustomerID="1111" OrderDate="1999-02-01" />
      <Order OrderID="Ord3" CustomerID="1112" OrderDate="1999-03-01" />
      <Order OrderID="Ord4" CustomerID="1112" OrderDate="1999-04-01" />
    </ROOT>
    
  4. XML 대량 로드를 실행하려면 이 VBScript 예(SampleVB.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