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

아티클
03/06/2017

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 문서의 루트> 요소 앞과 뒤의 <모든 정보를 무시합니다. 예를 들어 모든 XML 선언, 내부 DTD 정의, 외부 DTD 참조, 주석 등은 무시됩니다.

두 테이블(예: Customer 테이블과 CustOrder 테이블) 간의 기본 키/외래 키 관계를 정의하는 매핑 스키마가 있는 경우, 스키마에서 기본 키가 들어 있는 테이블 설명이 먼저 나오고 외래 키 열이 들어 있는 테이블이 그 다음에 나와야 합니다. 그 이유는 스키마에서 테이블이 식별되는 순서가 데이터베이스에 로드하는 데 사용되는 순서이기 때문입니다. 예를 들어 다음 XDR 스키마는 Order> 요소가 Customer 요소 앞에 설명되어 있기 때문에< XML 대량 로드에서 사용할 때 오류가 발생합니다.<> 여기서 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 데이터에서 HireDate 특성은 두 번째 <Customers> 요소에서 누락되었습니다. 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 노드가 XML 형식(즉, type="xsd:ID" XSD의 경우)으로 정의되고 SGUseID 속성이 SchemaGen의 경우 True로 설정된 경우 그러면 ID 형식화된 노드에서 기본 키가 만들어질 뿐만 아니라 스키마 관계 매핑에서 기본 키/외래 키 관계가 만들어집니다.
SchemaGen은 XSD 스키마 패싯 및 확장을 사용하여 관계형 SQL Server 스키마를 생성하지 않습니다.
대량 로드에서 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)

추가 리소스