XML Updategram을 사용하여 데이터 삽입(SQLXML 4.0)
적용 대상: 
SQL Server Azure SQL Database
updategram은 레코드 인스턴스가 후방> 블록에 나타나지만 블록 앞>의 <해당 <블록에는 나타나지 않을 때 삽입 작업을 나타냅니다. 이 경우 updategram은 후>방 블록의 레코드를 <데이터베이스에 삽입합니다.
삽입 작업에 대한 Updategram 형식은 다음과 같습니다.
<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
<updg:sync [mapping-schema="SampleSchema.xml"] >
[<updg:before>
</updg:before>]
<updg:after [updg:returnid="x y ...] >
<ElementName [updg:id="value"]
[updg:at-identity="x"]
[updg:guid="y"]
attribute="value"
attribute="value"
...
/>
[<ElementName .../>... ]
</updg:after>
</updg:sync>
</ROOT>
<차단 전>
삽입 작업에 대해 <이전> 블록을 생략할 수 있습니다. 선택적 매핑 스키마 특성을 지정 <하지 않으면 updategram에 지정된 ElementName> 이 데이터베이스 테이블에 매핑되고 자식 요소 또는 특성이 테이블의 열에 매핑됩니다.
<after> Block
After> 블록에서 하나 이상의 레코드를 <지정할 수 있습니다.
After> 블록이 <특정 열에 대한 값을 제공하지 않는 경우 updategram은 주석이 추가된 스키마에 지정된 기본값(스키마가 지정된 경우)을 사용합니다. 스키마가 열의 기본값을 지정하지 않으면 updategram은 이 열에 명시적 값을 지정하지 않고 대신 Microsoft SQL Server 기본값(지정된 경우)을 이 열에 할당합니다. SQL Server 기본값이 없고 열이 NULL 값을 허용하는 경우 updategram은 열 값을 NULL로 설정합니다. 열에 기본값이 없고 NULL 값을 수락하지 않으면 명령이 실패하고 updategram이 오류를 반환합니다. 선택적 updg:returnid 특성은 IDENTITY 형식 열이 있는 테이블에 레코드가 추가될 때 시스템에서 생성하는 ID 값을 반환하는 데 사용됩니다.
updg:id 특성
updategram이 레코드만 삽입하는 경우 updategram에는 updg:id 특성이 필요하지 않습니다. updg:id에 대한 자세한 내용은 XML Updategrams를 사용하여 데이터 업데이트(SQLXML 4.0)를 참조하세요.
updg:at-identity 특성
updategram이 IDENTITY 형식 열이 있는 테이블에 레코드를 삽입하는 경우 updategram은 선택적 updg:at-identity 특성을 사용하여 시스템 할당 값을 캡처할 수 있습니다. 그런 다음 updategram은 후속 작업에서 이 값을 사용할 수 있습니다. updategram을 실행하면 updg:returnid 특성을 지정하여 생성된 ID 값을 반환할 수 있습니다.
updg:guid 특성
updg:guid 특성은 전역적으로 고유한 식별자를 생성하는 선택적 특성입니다. 이 값은 지정된 전체 <동기화> 블록의 범위에 남아 있습니다. 동기화> 블록의 <어디에서나 이 값을 사용할 수 있습니다. 이 특성은 NEWGUID()SQL Server 함수를 호출하여 고유 식별자를 생성합니다.
예제
다음 예제를 사용하여 작업 샘플을 만들려면 SQLXML 실행 요구 사항 예제에 지정된 요구 사항을 충족해야 합니다.
updategram 예제를 사용하기 전에 다음 사항에 유의하세요.
대부분의 예제에서는 기본 매핑을 사용합니다(즉, updategram에 매핑 스키마가 지정되지 않음). 매핑 스키마 를 사용하는 updategram에 대한 자세한 예제는 Updategram에서 주석이 추가된 매핑 스키마 지정(SQLXML 4.0)을 참조하세요.
대부분의 예제에서는 샘플 데이터베이스를
AdventureWorks2022사용합니다. 모든 업데이트는 이 데이터베이스의 테이블에 적용됩니다.
A. updategram을 사용하여 레코드 삽입
이 특성 중심 Updategram은 AdventureWorks2022 데이터베이스의 HumanResources.Employee 테이블에 레코드를 삽입합니다.
이 예에서 Updategram은 매핑 스키마를 지정하지 않으므로 요소 이름은 테이블 이름에 매핑되고 특성 또는 자식 요소는 해당 테이블의 열에 매핑되는 기본 매핑을 사용합니다.
HumanResources.Department 테이블에 대한 AdventureWorks2022 스키마는 모든 열에 'not null' 제한을 적용합니다. 따라서 updategram은 모든 열에 대해 지정된 값을 포함해야 합니다. DepartmentID는 IDENTITY 형식 열입니다. 따라서 값은 지정되지 않습니다.
<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
<updg:sync >
<updg:before>
</updg:before>
<updg:after>
<HumanResources.Department
Name="New Product Research"
GroupName="Research and Development"
ModifiedDate="2010-08-31"/>
</updg:after>
</updg:sync>
</ROOT>
스키마에 대해 샘플 XPath 쿼리를 테스트하려면
위의 updategram을 복사하여 텍스트 파일에 붙여넣습니다. 파일을 MyUpdategram.xml 저장합니다.
SQLXML 4.0 테스트 스크립트(Sqlxml4test.vbs)를 만들고 사용하여 템플릿을 실행합니다.
자세한 내용은 ADO를 사용한 SQLXML 4.0 쿼리를 실행합니다.
요소 중심 매핑에서 updategram은 다음과 같습니다.
<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
<updg:sync >
<updg:before>
</updg:before>
<updg:after>
<HumanResources.Department>
<Name> New Product Research </Name>
<GroupName> Research and Development </GroupName>
<ModifiedDate>2010-08-31</ModifiedDate>
</HumanResources.Department>
</updg:after>
</updg:sync>
</ROOT>
혼합 모드(요소 중심 및 특성 중심) updategram에서 요소는 다음 updategram에 표시된 대로 특성과 하위 요소를 모두 가질 수 있습니다.
<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
<updg:sync >
<updg:before>
</updg:before>
<updg:after>
<HumanResources.Department
Name=" New Product Research "
<GroupName>Research and Development</GroupName>
<ModifiedDate>2010-08-31</ModifiedDate>
</HumanResources.Department>
</updg:after>
</updg:sync>
</ROOT>
B. updategram을 사용하여 여러 레코드 삽입
이 updategram은 HumanResources.Shift 테이블에 두 개의 새 교대 근무 레코드를 추가합니다. updategram은 블록 앞>의 선택 사항을 <지정하지 않습니다.
<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
<updg:sync>
<updg:after >
<HumanResources.Shift Name="Day-Evening"
StartTime="1900-01-01 11:00:00.000"
EndTime="1900-01-01 19:00:00.000"
ModifiedDate="2004-01-01 00:00:00.000" />
<HumanResources.Shift Name="Evening-Night"
StartTime="1900-01-01 19:00:00.000"
EndTime="1900-01-01 03:00:00.000"
ModifiedDate="2004-01-01 00:00:00.000" />
</updg:after>
</updg:sync>
</ROOT>
스키마에 대해 샘플 XPath 쿼리를 테스트하려면
위의 updategram을 복사하여 텍스트 파일에 붙여넣습니다. 파일을 Updategram-AddShifts.xml 저장합니다.
SQLXML 4.0 테스트 스크립트(Sqlxml4test.vbs)를 만들고 사용하여 템플릿을 실행합니다.
자세한 내용은 ADO를 사용한 SQLXML 4.0 쿼리를 실행합니다.
이 예제의 또 다른 버전은 두 개의 직원을 삽입하기 위해 한 블록 대신 두 개의 별도 블록 뒤에> 두 개의 개별<을 사용하는 updategram입니다. 이는 유효하며 다음과 같이 인코딩할 수 있습니다.
<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
<updg:sync>
<updg:after >
<HumanResources.Shift Name="Day-Evening"
StartTime="1900-01-01 11:00:00.000"
EndTime="1900-01-01 19:00:00.000"
ModifiedDate="2004-01-01 00:00:00.000" />
</updg:after>
<updg:before>
</updg:before>
<updg:after >
<HumanResources.Shift Name="Evening-Night"
StartTime="1900-01-01 19:00:00.000"
EndTime="1900-01-01 03:00:00.000"
ModifiedDate="2004-01-01 00:00:00.000" />
</updg:after>
</updg:sync>
</ROOT>
C. XML에서 유효하지 않은 유효한 SQL Server 문자 작업
SQL Server에서 테이블 이름에는 Northwind 데이터베이스의 Order Details 테이블과 같은 공백이 포함될 수 있습니다. 그러나 유효한 SQL Server 식별자이지만 유효한 XML 식별자는 인코딩 값으로 '__xHHHH__'을 사용하여 인코딩할 수 없습니다. 여기서 HHHH는 가장 중요한 비트 우선 순서의 문자에 대한 4자리 16진수 UCS-2 코드를 의미합니다.
참고 항목
이 예에서는 Northwind 데이터베이스를 사용합니다. 이 Microsoft 웹 사이트에서 다운로드할 수 있는 SQL 스크립트를 사용하여 Northwind 데이터베이스를 설치할 수 있습니다.
또한 요소 이름은 대괄호([ ]) 내에 묶어야 합니다. XML에서는 문자 [and]가 유효하지 않으므로 각각 _x005B_ 및 _x005D_ 인코딩해야 합니다. (매핑 스키마를 사용하는 경우 공백과 같이 유효하지 않은 문자를 포함하지 않는 요소 이름을 제공할 수 있습니다. 매핑 스키마는 필요한 매핑을 수행합니다. 따라서 이러한 문자에 대해 인코딩할 필요가 없습니다.)
이 updategram은 Northwind 데이터베이스의 Order Details 테이블에 레코드를 추가합니다.
<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
<updg:sync >
<updg:before>
</updg:before>
<updg:after>
<_x005B_Order_x0020_Details_x005D_ OrderID="1"
ProductID="11"
UnitPrice="$1.0"
Quantity="1"
Discount="0.0" />
</updg:after>
</updg:sync>
</ROOT>
주문 세부 정보 테이블의 UnitPrice 열은 금액 유형입니다. 문자열 형식에서 money 형식으로의 적절한 형식 변환을 적용하려면 값의 일부로 달러 기호 문자($)를 추가해야 합니다. updategram이 매핑 스키마를 지정하지 않으면 문자열 값의 첫 번째 문자가 평가됩니다. 첫 번째 문자가 달러 기호($)인 경우 적절한 변환이 적용됩니다.
열이 dt:type="fixed.14.4" 또는 sql:datatype="money"로 적절하게 표시되는 매핑 스키마에 대해 updategram을 지정하는 경우 달러 기호($)가 필요하지 않으며 변환이 매핑에 의해 처리됩니다. 적절한 형식 변환을 수행하려는 이 방법을 사용하는 것이 좋습니다.
스키마에 대해 샘플 XPath 쿼리를 테스트하려면
위의 updategram을 복사하여 텍스트 파일에 붙여넣습니다. 파일을 UpdategramSpacesInTableName.xml 저장합니다.
SQLXML 4.0 테스트 스크립트(Sqlxml4test.vbs)를 만들고 사용하여 템플릿을 실행합니다.
자세한 내용은 ADO를 사용한 SQLXML 4.0 쿼리를 실행합니다.
D. at-identity 특성을 사용하여 IDENTITY 유형 열에 삽입된 값 검색
다음 updategram은 Sales.SalesOrderHeader 테이블에 하나와 Sales.SalesOrderDetail 테이블의 레코드를 삽입합니다.
먼저 updategram은 Sales.SalesOrderHeader 테이블에 레코드를 추가합니다. 이 테이블에서 SalesOrderID 열은 IDENTITY 유형 열입니다. 따라서 이 레코드를 테이블에 추가하면 updategram은 id 기반 특성을 사용하여 할당된 SalesOrderID 값을 "x"(자리 표시자 값)로 캡처합니다. 그런 다음 updategam은 이 ID 변수를 Sales.SalesOrderDetail> 요소의 SalesOrderID 특성 <값으로 지정합니다.
<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
<updg:sync >
<updg:before>
</updg:before>
<updg:after>
<Sales.SalesOrderHeader updg:at-identity="x"
RevisionNumber="1"
OrderDate="2001-07-01 00:00:00.000"
DueDate="2001-07-13 00:00:00.000"
OnlineOrderFlag="0"
CustomerID="676"
ContactID="378"
BillToAddressID="985"
ShipToAddressID="985"
ShipMethodID="5"
SubTotal="24643.9362"
TaxAmt="1971.5149"
Freight="616.0984"
rowguid="00001111-2222-3333-4444-556677889900"
ModifiedDate="2001-07-08 00:00:00.000" />
<Sales.SalesOrderDetail SalesOrderID="x"
LineNumber="1"
OrderQty="1"
ProductID="776"
SpecialOfferID="1"
UnitPrice="2429.9928"
UnitPriceDiscount="0.00"
rowguid="aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
ModifiedDate="2001-07-01 00:00:00.000" />
</updg:after>
</updg:sync>
</ROOT>
updg:at-identity 특성에 의해 생성된 ID 값을 반환하려면 updg:returnid 특성을 사용할 수 있습니다. 다음은 이 ID 값을 반환하는 수정된 Updategram입니다. (이 updategram은 예제를 좀 더 복잡하게 만들기 위해 두 개의 주문 레코드와 두 개의 주문 세부 정보 레코드를 추가합니다.)
<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
<updg:sync>
<updg:before>
</updg:before>
<updg:after updg:returnid="x y" >
<HumanResources.Shift updg:at-identity="x" Name="Day-Evening"
StartTime="1900-01-01 11:00:00.000"
EndTime="1900-01-01 19:00:00.000"
ModifiedDate="2004-01-01 00:00:00.000" />
<HumanResources.Shift updg:at-identity="y" Name="Evening-Night"
StartTime="1900-01-01 19:00:00.000"
EndTime="1900-01-01 03:00:00.000"
ModifiedDate="2004-01-01 00:00:00.000" />
</updg:after>
</updg:sync>
</ROOT>
updategram이 실행되면 생성된 ID 값(테이블 ID에 사용되는 ShiftID 열의 생성된 값)을 포함하는 다음과 유사한 결과가 반환됩니다.
<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
<returnid>
<x>4</x>
<y>5</y>
</returnid>
</ROOT>
스키마에 대해 샘플 XPath 쿼리를 테스트하려면
위의 updategram을 복사하여 텍스트 파일에 붙여넣습니다. 파일을 Updategram-returnId.xml로 저장합니다.
SQLXML 4.0 테스트 스크립트(Sqlxml4test.vbs)를 만들고 사용하여 템플릿을 실행합니다.
자세한 내용은 ADO를 사용한 SQLXML 4.0 쿼리를 실행합니다.
E. updg:guid 특성을 사용하여 고유 값 생성
이 예제에서 updategram은 Cust 및 CustOrder 테이블에 레코드를 삽입합니다. 또한 updategram은 updg:guid 특성을 사용하여 CustomerID 특성에 대한 고유 값을 생성합니다.
<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
<updg:sync >
<updg:before>
</updg:before>
<updg:after updg:returnid="x" >
<Cust updg:guid="x" >
<CustID>x</CustID>
<LastName>Fuller</LastName>
</Cust>
<CustOrder>
<CustID>x</CustID>
<OrderID>1</OrderID>
</CustOrder>
</updg:after>
</updg:sync>
</ROOT>
updategram은 returnid 특성을 지정합니다. 결과적으로 생성된 GUID가 반환됩니다.
<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
<returnid>
<x>7111BD1A-7F0B-4CEE-B411-260DADFEFA2A</x>
</returnid>
</ROOT>
updategram을 테스트하려면
위의 updategram을 복사하여 텍스트 파일에 붙여넣습니다. 파일을 Updategram-GenerateGuid.xml 저장합니다.
다음 테이블을 만듭니다.
USE tempdb CREATE TABLE Cust (CustID uniqueidentifier, LastName varchar(20)) CREATE TABLE CustOrder (CustID uniqueidentifier, OrderID int)SQLXML 4.0 테스트 스크립트(Sqlxml4test.vbs)를 만들고 사용하여 템플릿을 실행합니다.
자세한 내용은 ADO를 사용한 SQLXML 4.0 쿼리를 실행합니다.
F. updategram에서 스키마 지정
이 예제의 updategram은 다음 표에 레코드를 삽입합니다.
CustOrder(OrderID, EmployeeID, OrderType)
이 Updategram에는 XSD 스키마가 지정됩니다. 즉, Updategram 요소 및 특성의 기본 매핑이 없습니다. 스키마는 요소와 특성을 데이터베이스 테이블 및 열에 매핑하는 데 필요한 기능을 제공합니다.
다음 스키마(CustOrderSchema.xml)는 OrderID 및 EmployeeID 특성으로 구성된 CustOrder> 요소에 대해 설명<합니다. 스키마를 더 흥미롭게 만들기 위해 기본값이 EmployeeID 특성에 할당됩니다. Updategram은 삽입 작업에 대해서만 및 Updategram에서 해당 특성을 지정하지 않는 경우에만 특성의 기본값을 사용합니다.
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:sql="urn:schemas-microsoft-com:mapping-schema">
<xsd:element name="CustOrder" >
<xsd:complexType>
<xsd:attribute name="OrderID" type="xsd:integer" />
<xsd:attribute name="EmployeeID" type="xsd:integer" />
<xsd:attribute name="OrderType " type="xsd:integer" default="1"/>
</xsd:complexType>
</xsd:element>
</xsd:schema>
이 updategram은 CustOrder 테이블에 레코드를 삽입합니다. updategram은 OrderID 및 EmployeeID 특성 값만 지정합니다. OrderType 특성 값은 지정하지 않습니다. 따라서 Updategram은 앞의 스키마에 지정된 EmployeeID 특성의 기본값을 사용합니다.
<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql"
xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
<updg:sync mapping-schema='CustOrderSchema.xml'>
<updg:after>
<CustOrder OrderID="98000" EmployeeID="1" />
</updg:after>
</updg:sync>
</ROOT>
매핑 스키마 를 지정하는 updategram에 대한 자세한 예제는 Updategram에서 주석이 추가된 매핑 스키마 지정(SQLXML 4.0)을 참조하세요.
updategram을 테스트하려면
tempdb 데이터베이스에서 다음 테이블을 만듭니다.
USE tempdb CREATE TABLE CustOrder( OrderID int, EmployeeID int, OrderType int)위의 스키마를 복사하여 텍스트 파일에 붙여넣습니다. 파일을 CustOrderSchema.xml 저장합니다.
위의 updategram을 복사하여 텍스트 파일에 붙여넣습니다. 이전 단계에서 사용한 것과 동일한 폴더에 파일을 CustOrderUpdategram.xml 저장합니다.
SQLXML 4.0 테스트 스크립트(Sqlxml4test.vbs)를 만들고 사용하여 updategram을 실행합니다.
자세한 내용은 ADO를 사용한 SQLXML 4.0 쿼리를 실행합니다.
해당하는 XDR 스키마입니다.
<Schema xmlns="urn:schemas-microsoft-com:xml-data"
xmlns:sql="urn:schemas-microsoft-com:xml-sql">
<ElementType name="CustOrder" >
<AttributeType name="OrderID" />
<AttributeType name="EmployeeID" />
<AttributeType name="OrderType" default="1" />
<attribute type="OrderID" />
<attribute type="EmployeeID" />
<attribute type="OrderType" />
</ElementType>
</Schema>
G. xsi:nil 특성을 사용하여 열에 null 값 삽입
테이블의 해당 열에 null 값을 삽입하려는 경우 updategram의 요소에 xsi:nil 특성을 지정할 수 있습니다. 해당 XSD 스키마에서 XSD nillable 특성도 지정해야 합니다.
예를 들어 다음 XSD 스키마를 고려합니다.
<?xml version="1.0"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:sql="urn:schemas-microsoft-com:mapping-schema">
<xsd:element name="Student" sql:relation="Students">
<xsd:complexType>
<xsd:all>
<xsd:element name="fname" sql:field="first_name"
type="xsd:string"
nillable="true"/>
</xsd:all>
<xsd:attribute name="SID"
sql:field="StudentID"
type="xsd:ID"/>
<xsd:attribute name="lname"
sql:field="last_name"
type="xsd:string"/>
<xsd:attribute name="minitial"
sql:field="middle_initial"
type="xsd:string"/>
<xsd:attribute name="years"
sql:field="no_of_years"
type="xsd:integer"/>
</xsd:complexType>
</xsd:element>
</xsd:schema>
XSD 스키마는 fname> 요소에 대해 nillable="true"를< 지정합니다. 다음 updategram은 이 스키마를 사용합니다.
<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql"
xmlns:updg="urn:schemas-microsoft-com:xml-updategram"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<updg:sync mapping-schema='StudentSchema.xml'>
<updg:before/>
<updg:after>
<Student SID="S00004" lname="Elmaci" minitial="" years="2">
<fname xsi:nil="true">
</fname>
</Student>
</updg:after>
</updg:sync>
</ROOT>
updategram은 after> 블록의< fname> 요소에 대해 xsi:nil을 <지정합니다. 따라서 이 Updategram을 실행하면 테이블의 first_name 열에 대해 NULL 값이 삽입됩니다.
updategram을 테스트하려면
tempdb 데이터베이스에서 다음 테이블을 만듭니다.
USE tempdb CREATE TABLE Students ( StudentID char(6)NOT NULL , first_name varchar(50), last_name varchar(50), middle_initial char(1), no_of_years int NULL) GO위의 스키마를 복사하여 텍스트 파일에 붙여넣습니다. 파일을 StudentSchema.xml로 저장합니다.
위의 updategram을 복사하여 텍스트 파일에 붙여넣습니다. 이전 단계에서 StudentSchema.xml을 저장한 폴더와 같은 폴더에 StudentUpdategram.xml로 파일을 저장합니다.
SQLXML 4.0 테스트 스크립트(Sqlxml4test.vbs)를 만들고 사용하여 updategram을 실행합니다.
자세한 내용은 ADO를 사용한 SQLXML 4.0 쿼리를 실행합니다.
H. updategram에서 네임스페이스 지정
updategram에서 updategram의 동일한 요소에 선언된 네임스페이스에 속하는 요소를 포함할 수 있습니다. 이 경우 해당 스키마도 동일한 네임스페이스를 선언해야 하며 요소는 해당 대상 네임스페이스에 속해야 합니다.
예를 들어 다음 updategram(UpdateGram-ElementHavingNamespace.xml) <에서 Order> 요소는 요소에 선언된 네임스페이스에 속합니다.
<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
<updg:sync mapping-schema='XSD-ElementHavingNameSpace.xml'>
<updg:after>
<x:Order xmlns:x="https://server/xyz/schemas/"
updg:at-identity="SalesOrderID"
RevisionNumber="1"
OrderDate="2001-07-01 00:00:00.000"
DueDate="2001-07-13 00:00:00.000"
OnlineOrderFlag="0"
CustomerID="676"
ContactID="378"
BillToAddressID="985"
ShipToAddressID="985"
ShipMethodID="5"
SubTotal="24643.9362"
TaxAmt="1971.5149"
Freight="616.0984"
rowguid="00009999-8888-7777-6666-554433221100"
ModifiedDate="2001-07-08 00:00:00.000" />
</updg:after>
</updg:sync>
</ROOT>
이 경우 스키마에서도 이 스키마와 같이 해당 네임스페이스를 선언해야 합니다.
다음 스키마(XSD-ElementHavingNamespace.xml)는 해당 요소와 특성을 선언하는 방법을 보여 줍니다.
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:dt="urn:schemas-microsoft-com:datatypes"
xmlns:sql="urn:schemas-microsoft-com:mapping-schema"
xmlns:x="https://server/xyz/schemas/"
targetNamespace="https://server/xyz/schemas/" >
<xsd:element name="Order" sql:relation="Sales.SalesOrderHeader" type="x:Order_type"/>
<xsd:complexType name="Order_type">
<xsd:attribute name="SalesOrderID" type="xsd:ID"/>
<xsd:attribute name="RevisionNumber" type="xsd:unsignedByte"/>
<xsd:attribute name="OrderDate" type="xsd:dateTime"/>
<xsd:attribute name="DueDate" type="xsd:dateTime"/>
<xsd:attribute name="ShipDate" type="xsd:dateTime"/>
<xsd:attribute name="Status" type="xsd:unsignedByte"/>
<xsd:attribute name="OnlineOrderFlag" type="xsd:boolean"/>
<xsd:attribute name="SalesOrderNumber" type="xsd:string"/>
<xsd:attribute name="PurchaseOrderNumber" type="xsd:string"/>
<xsd:attribute name="AccountNumber" type="xsd:string"/>
<xsd:attribute name="CustomerID" type="xsd:int"/>
<xsd:attribute name="ContactID" type="xsd:int"/>
<xsd:attribute name="SalesPersonID" type="xsd:int"/>
<xsd:attribute name="TerritoryID" type="xsd:int"/>
<xsd:attribute name="BillToAddressID" type="xsd:int"/>
<xsd:attribute name="ShipToAddressID" type="xsd:int"/>
<xsd:attribute name="ShipMethodID" type="xsd:int"/>
<xsd:attribute name="CreditCardID" type="xsd:int"/>
<xsd:attribute name="CreditCardApprovalCode" type="xsd:string"/>
<xsd:attribute name="CurrencyRateID" type="xsd:int"/>
<xsd:attribute name="SubTotal" type="xsd:decimal"/>
<xsd:attribute name="TaxAmt" type="xsd:decimal"/>
<xsd:attribute name="Freight" type="xsd:decimal"/>
<xsd:attribute name="TotalDue" type="xsd:decimal"/>
<xsd:attribute name="Comment" type="xsd:string"/>
<xsd:attribute name="rowguid" type="xsd:string"/>
<xsd:attribute name="ModifiedDate" type="xsd:dateTime"/>
</xsd:complexType>
</xsd:schema>
updategram을 테스트하려면
위의 스키마를 복사하여 텍스트 파일에 붙여넣습니다. 파일을 XSD-ElementHavingNamespace.xml로 저장합니다.
위의 updategram을 복사하여 텍스트 파일에 붙여넣습니다. XSD-ElementHavingnamespace.xml 저장하는 데 사용되는 것과 동일한 폴더에 파일을 Updategram-ElementHavingNamespace.xml 저장합니다.
SQLXML 4.0 테스트 스크립트(Sqlxml4test.vbs)를 만들고 사용하여 updategram을 실행합니다.
자세한 내용은 ADO를 사용한 SQLXML 4.0 쿼리를 실행합니다.
9\. XML 데이터 형식 열에 데이터 삽입
XML 데이터 형식은 SQL Server 2005(9.x)에서 도입되었습니다. updategram을 사용하여 다음 프로비저닝을 사용하여 xml 데이터 형식 열에 저장된 데이터를 삽입하고 업데이트할 수 있습니다.
xml 열은 기존 행을 식별하는 데 사용할 수 없습니다. 따라서 updategram의 updg:before 섹션에 포함할 수 없습니다.
XML 열에 삽입된 XML 조각의 범위에 있는 네임스페이스가 유지되고 해당 네임스페이스 선언이 삽입된 조각의 맨 위 요소에 추가됩니다.
예를 들어 다음 updategram(SampleUpdateGram.xml)<에서 Desc> 요소는 샘플 데이터베이스의 Production>productModel 테이블에 있는 AdventureWorks2022 ProductDescription 열을 업데이트합니다. 이 updategram의 결과는 ProductDescription 열의 XML 내용이 Desc> 요소의 <XML 내용으로 업데이트된다는 것입니다.
<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
<updg:sync mapping-schema="SampleSchema.xml" >
<updg:before>
<ProductModel ProductModelID="19">
<Name>Mountain-100</Name>
</ProductModel>
</updg:before>
<updg:after>
<ProductModel>
<Name>Mountain-100</Name>
<Desc><?xml-stylesheet href="ProductDescription.xsl" type="text/xsl"?>
<p1:ProductDescription xmlns:p1="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription"
xmlns:wm="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain"
xmlns:wf="https://www.adventure-works.com/schemas/OtherFeatures"
xmlns:html="http://www.w3.org/1999/xhtml"
xmlns="">
<p1:Summary>
<html:p>Insert Example</html:p>
</p1:Summary>
<p1:Manufacturer>
<p1:Name>AdventureWorks</p1:Name>
<p1:Copyright>2002</p1:Copyright>
<p1:ProductURL>HTTP://www.Adventure-works.com</p1:ProductURL>
</p1:Manufacturer>
<p1:Features>These are the product highlights.
<wm:Warranty>
<wm:WarrantyPeriod>3 years</wm:WarrantyPeriod>
<wm:Description>parts and labor</wm:Description>
</wm:Warranty>
<wm:Maintenance>
<wm:NoOfYears>10 years</wm:NoOfYears>
<wm:Description>maintenance contract available through your dealer or any AdventureWorks retail store.</wm:Description>
</wm:Maintenance>
<wf:wheel>High performance wheels.</wf:wheel>
<wf:saddle>
<html:i>Anatomic design</html:i> and made from durable leather for a full-day of riding in comfort.</wf:saddle>
<wf:pedal>
<html:b>Top-of-the-line</html:b> clipless pedals with adjustable tension.</wf:pedal>
<wf:BikeFrame>Each frame is hand-crafted in our Bothell facility to the optimum diameter and wall-thickness required of a premium mountain frame. The heat-treated welded aluminum frame has a larger diameter tube that absorbs the bumps.</wf:BikeFrame>
<wf:crankset> Triple crankset; aluminum crank arm; flawless shifting. </wf:crankset>
</p1:Features>
<p1:Picture>
<p1:Angle>front</p1:Angle>
<p1:Size>small</p1:Size>
<p1:ProductPhotoID>118</p1:ProductPhotoID>
</p1:Picture>
<p1:Specifications> These are the product specifications.
<Material>Aluminum Alloy</Material>
<Color>Available in most colors</Color>
<ProductLine>Mountain bike</ProductLine>
<Style>Unisex</Style>
<RiderExperience>Advanced to Professional riders</RiderExperience>
</p1:Specifications>
</p1:ProductDescription>
</Desc>
</ProductModel>
</updg:after>
</updg:sync>
</ROOT>
updategram은 주석이 추가된 다음 XSD 스키마(SampleSchema.xml)를 참조합니다.
<?xml version="1.0" encoding="utf-8" ?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:sql="urn:schemas-microsoft-com:mapping-schema"
xmlns="http://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription">
<xsd:element name="ProductModel" sql:relation="Production.ProductModel" >
<xsd:complexType>
<xsd:sequence>
<xsd:element name="Name" type="xsd:string"></xsd:element>
<xsd:element name="Desc" sql:field="CatalogDescription" sql:datatype="xml">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="ProductDescription">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="Summary" type="xsd:anyType">
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
<xsd:attribute name="ProductModelID" sql:field="ProductModelID"/>
</xsd:complexType>
</xsd:element>
</xsd:schema>
updategram을 테스트하려면
위의 스키마를 복사하여 텍스트 파일에 붙여넣습니다. 파일을 XSD-SampleSchema.xml 저장합니다.
참고 항목
updategrams는 기본 매핑을 지원하므로 xml 데이터 형식의 시작과 끝을 식별할 수 없습니다. 이는 xml 데이터 형식 열을 사용하여 테이블을 삽입하거나 업데이트할 때 매핑 스키마가 필요하다는 것을 의미합니다. 스키마가 제공되지 않으면 SQLXML은 테이블에서 열 중 하나가 누락되었음을 나타내는 오류를 반환합니다.
위의 updategram을 복사하여 텍스트 파일에 붙여넣습니다. SampleSchema.xml 저장하는 데 사용되는 것과 동일한 폴더에 파일을 SampleUpdategram.xml 저장합니다.
SQLXML 4.0 테스트 스크립트(Sqlxml4test.vbs)를 만들고 사용하여 updategram을 실행합니다.
자세한 내용은 ADO를 사용한 SQLXML 4.0 쿼리를 실행합니다.