레코드 생성 프로세스(SQLXML 4.0)
적용 대상:
SQL Server Azure SQL 데이터베이스
XML 대량 로드는 XML 입력 데이터를 처리하고 Microsoft SQL Server 적절한 테이블에 대한 레코드를 준비합니다. XML 대량 로드의 논리는 새 레코드를 생성할 시기, 레코드 필드에 복사할 자식 요소 또는 특성 값, 레코드가 완료되고 삽입을 위해 SQL Server 보낼 준비가 된 시기를 결정합니다.
XML 대량 로드는 전체 XML 입력 데이터를 메모리에 로드하지 않으며 데이터를 SQL Server 보내기 전에 전체 레코드 집합을 생성하지 않습니다. 이것은 XML 입력 데이터가 큰 문서일 수 있으며 전체 문서를 메모리로 로드하면 많은 비용이 들 수 있기 때문입니다. 대신 XML 대량 로드는 다음을 수행합니다.
매핑 스키마를 분석하고 필요한 실행 계획을 준비합니다.
실행 계획을 입력 스트림의 데이터에 적용합니다.
이 순차적 처리에서는 XML 입력 데이터를 특정 방식으로 제공해야 하므로 XML 대량 로드가 매핑 스키마를 분석하는 방법과 레코드 생성 프로세스가 발생하는 방식을 이해하고 있어야 합니다. 이러한 이해를 바탕으로 XML 대량 로드에 원하는 결과를 생성하는 매핑 스키마를 제공할 수 있습니다.
XML 대량 로드는 주석을 사용하여 명시적으로 지정되거나 기본 매핑을 통해 암시적으로 지정된 열 및 테이블 매핑을 비롯한 일반적인 매핑 스키마 주석과 조인 관계를 처리합니다.
참고
여기에서는 주석이 추가된 XSD 또는 XDR 매핑 스키마를 잘 알고 있다고 가정합니다. 스키마에 대한 자세한 내용은 주석이 추가된 XSD 스키마 소개(SQLXML 4.0) 또는 주석이 추가된 XDR 스키마(SQLXML 4.0에서는 사용되지 않음)를 참조하세요.
레코드 생성을 이해하려면 다음 개념을 이해해야 합니다.
노드 범위
레코드 생성 규칙
레코드 하위 집합 및 키 순서 지정 규칙
레코드 생성 규칙의 예외
노드 범위
XML 문서의 노드(요소 또는 특성)는 XML 대량 로드가 XML 입력 데이터 스트림에서 발견되면 scope 입력됩니다. 요소 노드의 경우 요소의 시작 태그로 요소의 범위가 시작됩니다. 특성 노드의 경우 특성 이름으로 특성의 범위가 시작됩니다.
범위에 사용할 데이터가 더 이상 없을 때 노드에서 범위가 끝납니다. 즉, 끝 태그(요소 노드의 경우)나 특성 값 끝(특성 노드의 경우)에서 범위가 끝납니다.
레코드 생성 규칙
노드(요소 또는 특성)에서 범위가 시작되면 해당 노드에서 레코드가 생성될 수 있습니다. 이러한 레코드는 연결된 노드가 범위에 속하는 동안 유지됩니다. 노드가 scope 나가면 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>
스키마는 CustomerID> 및 CompanyName 특성을 사용하여 Customer 요소를 지정<합니다. sql:relation 주석은 Customer 요소를 Customers> 테이블에 매핑<합니다.
다음 XML 문서 조각을 고려하십시오.
<Customer CustomerID="1" CompanyName="xyz" />
<Customer CustomerID="2" CompanyName="abc" />
...
XML 대량 로드에 이전 단락에서 설명한 스키마와 XML 데이터가 입력으로 제공되면 XML 대량 로드는 원본 데이터에서 다음과 같은 방식으로 노드(요소와 특성)를 처리합니다.
첫 번째 <Customer> 요소의 시작 태그는 해당 요소를 scope 가져옵니다. 이 노드는 Customers 테이블에 매핑되므로 XML 대량 로드는 Customers 테이블에 대한 레코드를 생성합니다.
스키마에서 Customer 요소의 모든 특성은 <Customers> 테이블의 열에 매핑됩니다. 이러한 특성의 범위가 시작되면 XML 대량 로드는 해당 값을 부모 범위에 의해 미리 생성된 고객 레코드에 복사합니다.
XML 대량 로드가 Customer> 요소의< 끝 태그에 도달하면 요소가 scope. 이렇게 하면 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> 요소 노드가 scope 입력하면 XML 대량 로드는 Cust 테이블에 대한 레코드를 생성합니다. 그런 다음 XML 대량 로드는 이러한 요소가 scope 입력할 때 CustomerID, <CompanyName 및 City 자식 요소에서 필요한 열 값(CustomerID, CompanyName> 및 <City>)을 복사합니다.><
Order 요소 노드가 <scope 입력되면 XML 대량 로드는 CustOrder 테이블에 대한 레코드를 생성합니다.> XML 대량 로드는 OrderID 특성의 값을 이 레코드에 복사합니다. CustomerID 열에 필요한 값은 Customer> 요소의<<CustomerID> 자식 요소에서 가져옵니다. XML 대량 로드는 Order> 요소에 CustomerID 특성이 지정되지 않은 한 sql:relationship에 지정된 정보를 사용하여 이 레코드에< 대한 CustomerID 외래 키 값을 가져옵니다.>< 일반적인 규칙은 자식 요소가 외래 키 특성에 대한 값을 명시적으로 지정하는 경우 XML 대량 로드는 해당 값을 사용하고 지정된 <sql:relationship>를 사용하여 부모 요소에서 값을 가져오지 않는 것입니다. 이 <Order> 요소 노드가 scope 나가면 XML 대량 로드는 레코드를 SQL Server 보낸 다음 모든 후속 <Order> 요소 노드를 동일한 방식으로 처리합니다.
마지막으로 Customer> 요소 노드가< scope 중단됩니다. 이때 XML 대량 로드는 고객 레코드를 SQL Server 보냅니다. XML 대량 로드는 XML 데이터 스트림의 모든 후속 고객에 대해 이 프로세스를 따릅니다.
여기서 매핑 스키마에 대한 두 가지 사항을 확인할 수 있습니다.
스키마가 "포함" 규칙을 충족하면(예: 고객과 연결된 모든 데이터 및 주문이 연결된 Customer> 및 Order 요소 노드의 scope 내에서 정의됨<) 대량 로드가 성공합니다.><
Customer> 요소를 설명할< 때 해당 자식 요소는 적절한 순서로 지정됩니다. 이 경우 <CustomerID> 자식 요소가 Order> 자식 요소 앞에< 지정됩니다. 즉, <입력 XML 데이터 파일에서 Order 요소가 scope 입력할 때 CustomerID> 요소 값을 외래 키 값으로 사용할 수 있습니다.<> 키 특성이 먼저 지정되므로 이것은 "키 순서 지정 규칙"입니다.
Order 자식 요소 뒤에 CustomerID> 자식 요소를 지정<하면 Order> 요소가 scope 입력할 때< 값을 사용할 수 없습니다.>< <그런 다음 /Order> 끝 태그를 읽으면 CustOrder 테이블에 대한 레코드가 완료된 것으로 간주되고 원하는 결과가 아닌 CustomerID 열에 대한 NULL 값이 있는 CustOrder 테이블에 삽입됩니다.
작업 예제를 만들려면
이 예에서 제공하는 스키마를 SampleSchema.xml로 저장합니다.
다음 테이블을 만듭니다.
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다음 예제 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>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 특성 노드가 scope 입력할 때 레코드 생성이 없습니다. 따라서 Orders 테이블에 주문 레코드를 추가하려면 스키마의 특정 위치에서 해당 주문을 설명해야 합니다. 이 스키마에서 Order> 요소를 지정하면< XML 대량 로드가 Orders 테이블에 주문 레코드를 추가합니다. <Order> 요소는 CustOrder 테이블의 레코드를 채우는 데 필요한 모든 특성을 설명합니다.
Customer> 요소의 CustomerID 및 OrderID 값이<Order> 요소의 값<과 일치하는지 확인해야 합니다. 참조 무결성을 유지하는 책임은 사용자에게 있습니다.
작업 예제를 테스트하려면
다음 테이블을 만듭니다.
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이 예에서 제공하는 매핑 스키마를 SampleSchema.xml로 저장합니다.
다음 예제 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>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
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기