SQLXML 4.0의 DiffGrams 소개

적용 대상: SQL Server Azure SQL 데이터베이스

이 항목에서는 DiffGrams에 대해 간략하게 소개합니다.

DiffGram 형식

일반 DiffGram 형식은 다음과 같습니다.

<?xml version="1.0"?>  
<diffgr:diffgram   
         xmlns:msdata="urn:schemas-microsoft-com:xml-msdata"  
         xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1"  
         xmlns:xsd="http://www.w3.org/2001/XMLSchema">  
   <DataInstance>  
      ...  
   </DataInstance>  
   [<diffgr:before>  
        ...  
   </diffgr:before>]  
  
   [<diffgr:errors>  
        ...  
   </diffgr:errors>]  
</diffgr:diffgram>  

DiffGram 형식은 다음과 같은 블록으로 구성됩니다.

<DataInstance>
이 요소의 이름 DataInstance는 이 설명서에서 설명용으로 사용됩니다. 예를 들어 DiffGram이 .NET Framework 데이터 세트에서 생성된 경우 데이터 세트의 Name 속성 값이 이 요소의 이름으로 사용됩니다. 이 블록에는 수정되지 않은 데이터를 포함하여 변경 후의 모든 관련 데이터가 포함됩니다. DiffGram 처리 논리는 diffgr:hasChanges 특성이 지정되지 않은 이 블록의 요소를 무시합니다.

<diffgr:before>
이 선택적 블록에는 업데이트하거나 삭제해야 하는 원래 레코드 인스턴스(요소)가 포함됩니다. DiffGram에 의해 수정(업데이트 또는 삭제)되는 모든 데이터베이스 테이블은 이전> 블록에서< 최상위 요소로 표시되어야 합니다.

<diffgr:errors>
이 선택적 블록은 DiffGram 처리 논리에서 무시됩니다.

DiffGram 주석

이러한 주석은 DiffGram 네임스페이스 "urn:schemas-microsoft-com:xml-diffgram-01"에 정의되어 있습니다.

id
이 특성은 이전> 및 DataInstance 블록의< 요소를 페어링하는 <데 사용됩니다.>

hasChanges
삽입 또는 업데이트 작업의 경우 DiffGram은 삽입 되거나 수정된 값으로 이 특성을 지정해야 합니다. 이 특성이 없으면 DataInstance>의< 해당 요소는 처리 논리에서 무시되고 업데이트가 수행되지 않습니다. 작업 샘플은 DiffGram 예제(SQLXML 4.0)를 참조하세요.

parentID
이 특성은 DiffGram에서 요소 간의 부모-자식 관계를 지정하는 데 사용됩니다. 이 특성은 이전> 블록에<만 나타납니다. SQLXML에서 업데이트를 적용할 때 사용됩니다. 부모-자식 관계는 DiffGram에서 요소가 처리되는 순서를 결정하는 데 사용됩니다.

DiffGram 처리 논리 이해

DiffGram 처리 논리는 특정 규칙에 따라 작업이 삽입, 업데이트 또는 삭제 작업인지를 결정합니다. 다음 표에서는 이러한 규칙에 대해 설명합니다.

작업(Operation) Description
삽입 DiffGram은 요소가 DataInstance> 블록에< 나타나지만 블록 앞에> 해당<하지 않고 요소에 diffgr:hasChanges 특성이 지정되면(diffgr:hasChanges=inserted) 삽입 작업을 나타냅니다. 이 경우 DiffGram은 DataInstance> 블록에< 지정된 레코드 instance 데이터베이스에 삽입합니다.

diffgr:hasChanges 특성을 지정하지 않으면 요소가 처리 논리에 의해 무시되고 삽입이 수행되지 않습니다. 작업 샘플은 DiffGram 예제(SQLXML 4.0)를 참조하세요.
업데이트 DiffGram은 DataInstance> 블록에 해당 요소가 있는 이전 블록에 요소가 있는 경우(즉, 두 요소< 모두 동일한 값을 가진 diffgr:id 특성 포함) 업데이트 작업을 나타내고 diffgr:hasChanges 특성은 DataInstance> 블록의 요소에서<수정된 값으로 지정됩니다.><

Diffgr:hasChanges 특성이 DataInstance> 블록의 요소에 지정되지 않은 경우 처리 논리에서< 오류가 반환됩니다. 작업 샘플은 DiffGram 예제(SQLXML 4.0)를 참조하세요.

diffgr:parentID이전> 블록에< 지정된 경우 parentID로 지정된 요소의 부모-자식 관계를 사용하여 레코드가 업데이트되는 순서를 결정합니다.
삭제 DiffGram은 요소가 이전> 블록에< 나타나지만 해당 <DataInstance> 블록에는 나타나지 않을 때 삭제 작업을 나타냅니다. 이 경우 DiffGram은 데이터베이스에서 이전> 블록에< 지정된 레코드 instance 삭제합니다. 작업 샘플은 DiffGram 예제(SQLXML 4.0)를 참조하세요.

diffgr:parentID이전> 블록에< 지정된 경우 parentID로 지정된 요소의 부모-자식 관계가 레코드가 삭제되는 순서를 결정하는 데 사용됩니다.

참고

DiffGrams에 매개 변수를 전달할 수는 없습니다.