XML 대량 로드에 대한 지침 및 제한 사항(SQLXML 4.0)

아티클
05/07/2013

XML 대량 로드를 사용하려면 다음의 지침과 제한 사항을 알아 두어야 합니다.

인라인 스키마는 지원되지 않습니다.

원본 XML 문서에 인라인 스키마가 있는 경우 XML 대량 로드에서 해당 스키마를 무시합니다. XML 데이터 외부의 XML 대량 로드에 대한 매핑 스키마를 지정합니다. xmlns="x:schema" 특성을 사용하여 매핑 스키마를 노드에 지정할 수 없습니다.
XML 문서는 형식만 검사되고 유효성은 검사되지 않습니다.

XML 대량 로드는 XML 문서를 검사하여 형식이 올바른지, 즉 XML이 World Wide Web Consortium의 XML 1.0 권장 사항의 구문 요구 사항을 준수하는지 확인합니다. 문서 형식이 올바르지 않으면 XML 대량 로드에서 처리가 취소되고 오류가 반환됩니다. 그러나 문서가 조각인 경우(예: 문서에 단일 루트 요소가 없는 경우)에만 예외적으로 형식이 올바르지 않은 문서도 로드됩니다.

XML 대량 로드는 XML 데이터 파일 안에 정의되거나 참조되는 XML 데이터 또는 DTD 스키마와 관련하여 문서의 유효성을 검사하지 않습니다. 또한 XML 대량 로드에서는 제공된 매핑 스키마를 기준으로 XML 데이터 파일의 유효성을 검사하지 않습니다.
모든 XML 프롤로그 정보는 무시됩니다.

XML 대량 로드에서는 XML 문서의 <root> 요소 앞/뒤에 나오는 모든 정보를 무시합니다. 예를 들어 모든 XML 선언, 내부 DTD 정의, 외부 DTD 참조, 주석 등은 무시됩니다.

두 테이블(예: Customer 테이블과 CustOrder 테이블) 간의 기본 키/외래 키 관계를 정의하는 매핑 스키마가 있는 경우, 스키마에서 기본 키가 들어 있는 테이블 설명이 먼저 나오고 외래 키 열이 들어 있는 테이블이 그 다음에 나와야 합니다. 그 이유는 스키마에서 테이블이 식별되는 순서대로 데이터베이스에서 해당 테이블이 로드되기 때문입니다.예를 들어 XML 대량 로드에서 다음 XDR 스키마를 사용할 경우 <Order> 요소가 <Customer> 요소보다 먼저 나오기 때문에 오류가 발생합니다. 여기서 CustOrder의 CustomerID 열은 Cust 테이블의 CustomerID 기본 키 열을 참조하는 외래 키 열입니다.

<?xml version="1.0" ?>
<Schema xmlns="urn:schemas-microsoft-com:xml-data" 
        xmlns:dt="urn:schemas-microsoft-com:xml:datatypes"  
        xmlns:sql="urn:schemas-microsoft-com:xml-sql" >

    <ElementType name="Order" sql:relation="CustOrder" >
      <AttributeType name="OrderID" />
      <AttributeType name="CustomerID" />
      <attribute type="OrderID" />
      <attribute type="CustomerID" />
    </ElementType>

   <ElementType name="CustomerID" dt:type="int" />
   <ElementType name="CompanyName" dt:type="string" />
   <ElementType name="City" dt:type="string" />

   <ElementType name="root" sql:is-constant="1">
      <element type="Customers" />
   </ElementType>
   <ElementType name="Customers" sql:relation="Cust" 
                     sql:overflow-field="OverflowColumn"  >
      <element type="CustomerID" sql:field="CustomerID" />
      <element type="CompanyName" sql:field="CompanyName" />
      <element type="City" sql:field="City" />
      <element type="Order" > 
           <sql:relationship
               key-relation="Cust"
                key="CustomerID"
                foreign-key="CustomerID"
                foreign-relation="CustOrder" />
      </element>
   </ElementType>
</Schema>

스키마에서 sql:overflow-field 주석을 사용하여 오버플로 열을 지정하지 않으면 XML 대량 로드는 XML 문서에는 있지만 매핑 스키마에는 설명되지 않은 모든 데이터를 무시합니다.

XML 대량 로드는 알려진 태그가 XML 데이터 스트림에서 발견될 때마다 사용자가 지정한 매핑 스키마를 적용합니다. 그러나 XML 문서에는 포함되었지만 스키마에 설명되지 않은 데이터는 무시합니다. 예를 들어 <Customer> 요소를 설명하는 매핑 스키마가 있다고 가정해 보겠습니다. XML 데이터 파일에는 모든 <Customer> 요소를 묶는 <AllCustomers> 루트 태그(스키마에 설명되지 않음)가 있습니다.
```
<AllCustomers>
  <Customer>...</Customer>
  <Customer>...</Customer>
   ...
</AllCustomers>
```
이 경우 XML 대량 로드는 <AllCustomers> 요소를 무시하고 <Customer> 요소부터 매핑을 시작합니다. XML 대량 로드는 XML 문서에는 있지만 스키마에는 설명되어 있지 않은 모든 요소를 무시합니다.

<Order> 요소가 포함되어 있는 다른 XML 원본 데이터 파일이 있다고 가정해 보겠습니다. 이러한 요소는 매핑 스키마에 설명되어 있지 않습니다.
```
<AllCustomers>
  <Customer>...</Customer>
    <Order> ... </Order>
    <Order> ... </Order>
     ...
  <Customer>...</Customer>
    <Order> ... </Order>
    <Order> ... </Order>
     ...
  ...
</AllCustomers>
```
XML 대량 로드는 이러한 <Order> 요소를 무시합니다. 그러나 스키마에 sql:overflow-field 주석을 사용하여 열을 오버플로 열로 식별하면 XML 대량 로드는 이 열의 사용되지 않은 모든 데이터를 저장합니다.
CDATA 섹션과 엔터티 참조는 데이터베이스에 저장되기 전에 해당하는 문자열로 변환됩니다.

이 예제에서 CDATA 섹션은 <City> 요소의 값을 래핑합니다. XML 대량 로드는 <City> 요소를 데이터베이스에 삽입하기 전에 문자열 값("NY")을 추출합니다.
```
    <City><![CDATA[NY]]> </City>
```
XML 대량 로드는 엔터티 참조를 유지하지 않습니다.

매핑 스키마에서 특성의 기본값을 지정하고 XML 원본 데이터에 해당 특성이 없으면, XML 대량 로드는 기본값을 사용합니다.

다음 샘플 XDR 스키마에서는 HireDate 특성의 기본값을 할당합니다.

<?xml version="1.0" ?>
<Schema xmlns="urn:schemas-microsoft-com:xml-data" 
        xmlns:dt="urn:schemas-microsoft-com:xml:datatypes"  
        xmlns:sql="urn:schemas-microsoft-com:xml-sql" >
   <ElementType name="root" sql:is-constant="1">
      <element type="Customers" />
   </ElementType>

   <ElementType name="Customers" sql:relation="Cust3" >
      <AttributeType name="CustomerID" dt:type="int"  />
      <AttributeType name="HireDate"  default="2000-01-01" />
      <AttributeType name="Salary"   />

      <attribute type="CustomerID" sql:field="CustomerID" />
      <attribute type="HireDate"   sql:field="HireDate"  />
      <attribute type="Salary"     sql:field="Salary"    />
   </ElementType>
</Schema>

이 XML 데이터에는 두 번째 <Customers> 요소에 HireDate 특성이 없습니다. XML 대량 로드는 두 번째 <Customers> 요소를 데이터베이스에 삽입할 때 스키마에 지정된 기본값을 사용합니다.

<ROOT>
  <Customers CustomerID="1" HireDate="1999-01-01" Salary="10000" />
  <Customers CustomerID="2" Salary="10000" />
</ROOT>

sql:url-encode 주석은 지원되지 않습니다.

XML 데이터 입력에 URL을 지정하면 대량 로드는 해당 위치에서 데이터를 읽지 못합니다.

매핑 스키마에 식별된 테이블이 생성됩니다(데이터베이스가 존재해야 함). 테이블 중 하나 이상이 데이터베이스에 이미 있는 경우 SGDropTables 속성은 기존의 테이블을 삭제한 후 다시 생성할지 여부를 결정합니다.
SchemaGen 속성을 지정하면(예: SchemaGen = true) 매핑 스키마에 식별된 테이블이 생성됩니다. 그러나 SchemaGen 속성은 한 가지 경우를 제외하고는 이러한 테이블에 제약 조건(예: PRIMARY KEY/FOREIGN KEY 제약 조건)을 만들지 않습니다. 즉, 관계에서 기본 키를 구성하는 XML 노드의 ID가 XML 형식(XSD의 경우 type="xsd:ID")으로 정의되고 SchemaGen의 SGUseID 속성이 True로 설정된 경우, ID 형식 노드에서 기본 키가 생성될 뿐만 아니라 매핑 스키마 관계에서 기본 키/외래 키 관계가 생성됩니다.
SchemaGen은 관계형 SQL Server 스키마를 생성하는 데 XSD 스키마 패싯과 확장을 사용하지 않습니다.
대량 로드에서 SchemaGen 속성을 지정하면(예: SchemaGen = true) 지정된 테이블만 업데이트되고 공유 이름의 뷰는 업데이트되지 않습니다.
SchemaGen은 주석이 추가된 XSD로부터 관계형 스키마를 생성하기 위한 기본적인 기능만 제공합니다. 필요한 경우 생성된 테이블을 사용자가 직접 수정해야 합니다.
테이블 간에 두 개 이상의 관계가 존재하는 경우 SchemaGen은 두 테이블 사이의 모든 관련 키가 포함된 하나의 관계를 만들려고 시도합니다. 이 제한 사항은 Transact-SQL 오류의 원인이 될 수 있습니다.
XML 데이터를 데이터베이스에 대량 로드할 경우 데이터베이스 열에 매핑되는 특성 또는 자식 요소가 매핑 스키마에 적어도 하나 있어야 합니다.
XML 대량 로드를 사용하여 날짜 값을 삽입할 경우 값을 (-)CCYY-MM-DD((+-)TZ) 형식으로 지정해야 합니다. 이 형식은 날짜에 대한 표준 XSD 형식입니다.
일부 속성 플래그는 다른 속성 플래그와 함께 사용할 수 없습니다. 예를 들어 대량 로드는 Ignoreduplicatekeys=true와 Keepidentity=false를 동시에 지원하지 않습니다. Keepidentity=false이면 대량 로드에서는 서버를 통해 키 값이 생성되는 것으로 간주합니다. 테이블에는 키에 대한 IDENTITY 제약 조건이 있어야 합니다. 서버에서는 중복 키를 생성하지 않으므로 Ignoreduplicatekeys를 true로 설정할 필요가 없습니다. 행이 있는 테이블로 가져온 데이터로부터 기본 키 값을 업로드하고 기본 키가 충돌할 가능성이 있는 경우에만 Ignoreduplicatekeys를 true로 설정해야 합니다.

XML 대량 로드에 대한 지침 및 제한 사항(SQLXML 4.0)

추가 리소스