XML Updategram을 사용하여 데이터 삽입(SQLXML 4.0)
Updategram은 레코드 인스턴스가 <after> 블록에 표시되고 해당 <before> 블록에는 표시되지 않는 경우 삽입 작업을 나타냅니다. 이 경우 Updategram은 <after> 블록의 레코드를 데이터베이스에 삽입합니다.
삽입 작업에 대한 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>
<before> 블록
삽입 작업에 대해 <before> 블록을 생략할 수 있습니다. 선택적 mapping-schema 특성을 지정하지 않으면 Updategram에 지정된 <ElementName>은 데이터베이스 테이블에 매핑되고 자식 요소 또는 특성은 테이블의 열에 매핑됩니다.
<after> 블록
<after> 블록에 하나 이상의 레코드를 지정할 수 있습니다.
<after> 블록에서 특정 열의 값을 제공하지 않으면 Updategram은 주석이 추가된 스키마에 지정된 기본값을 사용합니다(스키마가 지정된 경우). 스키마에서 열의 기본값을 지정하지 않으면 Updategram은 이 열에 명시적인 값을 지정하지 않고 대신 Microsoft SQL Server 기본값(지정된 경우)을 이 열에 할당합니다. SQL Server 기본값이 없고 열에서 NULL 값을 허용하는 경우 Updategram에서 열 값을 NULL로 설정합니다. 열에 기본값이 없고 NULL 값을 허용하지도 않는 경우 명령이 실패하고 Updategram에서 오류를 반환합니다. 선택적 updg:returnid 특성은 IDENTITY 유형 열이 있는 테이블에 레코드가 추가될 때 시스템에서 생성하는 ID 값을 반환하는 데 사용됩니다.
updg:id 특성
Updategram에서 레코드만 삽입하는 경우에는 updg:id 특성이 필요하지 않습니다. updg:id에 대한 자세한 내용은 XML Updategram을 사용하여 데이터 업데이트(SQLXML 4.0)를 참조하십시오.
updg:at-identity 특성
Updategram은 IDENTITY 유형 열이 있는 테이블에 레코드를 삽입할 때 선택적 updg:at-identity 특성을 사용하여 시스템에서 할당된 값을 캡처할 수 있습니다. Updategram은 이 값을 이후 작업에 사용할 수 있습니다. Updategram을 실행할 때 updg:returnid 특성을 지정하여 생성된 ID 값을 반환할 수 있습니다.
updg:guid 특성
updg:guid 특성은 GUID(Globally Unique Identifier)를 생성하는 선택적 특성입니다. 이 값은 값이 지정된 전체 <sync> 블록의 범위에 유지됩니다. <sync> 블록의 임의 위치에 이 값을 사용할 수 있습니다. 이 특성은 NEWGUID()SQL Server 함수를 호출하여 고유 식별자를 생성합니다.
예
다음 예를 사용하여 작업 예제를 만들려면 SQLXML 예 실행을 위한 요구 사항에 지정된 요구 사항이 충족되어야 합니다.
Updategram 예를 사용하기 전에 다음 사항을 확인하십시오.
대부분의 예에서는 기본 매핑을 사용합니다. 즉, Updategram에 매핑 스키마가 지정되지 않습니다. 매핑 스키마를 사용하는 Updategram에 대한 다른 예는 Updategram에 주석이 추가된 매핑 스키마 지정(SQLXML 4.0)을 참조하십시오.
대부분의 예에서는 AdventureWorks 예제 데이터베이스를 사용합니다. 모든 업데이트는 이 데이터베이스의 테이블에 적용됩니다. AdventureWorks 데이터베이스를 복원할 수 있습니다. AdventureWorks 데이터베이스 복원 방법은 AdventureWorks 예제 데이터베이스를 참조하십시오.
1. Updategram을 사용하여 단일 레코드 삽입
이 특성 중심 Updategram은 AdventureWorks 데이터베이스의 HumanResources.Employee 테이블에 레코드를 삽입합니다.
이 예에서 Updategram은 매핑 스키마를 지정하지 않으므로 요소 이름은 테이블 이름에 매핑되고 특성 또는 자식 요소는 해당 테이블의 열에 매핑되는 기본 매핑을 사용합니다.
HumanResources.Employee 테이블에 대한 AdventureWorks 스키마는 ManagerID 및 EmployeeID를 제외한 모든 열에 'not null' 제한을 적용합니다. 따라서 Updategram은 이러한 두 열을 제외한 모든 열에 대해 지정된 값을 포함해야 합니다. ManagerID는 생략되므로 Updategram을 실행할 때 해당 값은 NULL이 됩니다. EmployeeID는 IDENTITY 유형 열입니다. 따라서 해당 값이 지정되어 있지 않습니다.
<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
<updg:sync >
<updg:before>
</updg:before>
<updg:after>
<HumanResources.Employee
NationalIDNumber="111111111"
ContactID="1156"
LoginID="adventure-works\paulw0"
DepartmentID="7"
ShiftID="3"
Title="Production Technician - WC40"
EmergencyContactID="1445"
AddressID="157"
BirthDate="1970-12-15 00:00:00.000"
MaritalStatus="S"
Gender="M"
HireDate="1999-01-05 00:00:00.000"
SalariedFlag="0"
BaseRate="15.00"
PayFrequency="1"
VacationHours="80"
SickLeaveHours="80"
CurrentFlag="1"
rowguid="00001111-2222-3333-4444-555566667777"
ModifiedDate="1998-12-29 00:00:00.000"/>
</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.Employee>
<NationalIDNumber>111111111</NationalIDNumber>
<ContactID>1156</ContactID>
<LoginID>adventure-works\paulw0</LoginID>
<DepartmentID>7</DepartmentID>
<ShiftID>3</ShiftID>
<Title>Production Technician - WC40</Title>
<EmergencyContactID>1445</EmergencyContactID>
<AddressID>157</AddressID>
<BirthDate>1970-12-15 00:00:00.000</BirthDate>
<MaritalStatus>S</MaritalStatus>
<Gender>M</Gender>
<HireDate>1999-01-05 00:00:00.000</HireDate>
<SalariedFlag>0</SalariedFlag>
<BaseRate>15.00</BaseRate>
<PayFrequency>1</PayFrequency>
<VacationHours>80</VacationHours>
<SickLeaveHours>80</SickLeaveHours>
<CurrentFlag>1</CurrentFlag>
<rowguid>00001111-2222-3333-4444-555566667777</rowguid>
<ModifiedDate>1998-12-29 00:00:00.000</ModifiedDate>
</HumanResources.Employee>
</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.Employee
NationalIDNumber="111111111"
ContactID="1156"
DepartmentID="7"
ShiftID="3"
EmergencyContactID="1445"
AddressID="157"
SalariedFlag="0"
BaseRate="15.00"
PayFrequency="1"
VacationHours="80"
SickLeaveHours="80"
CurrentFlag="1">
<LoginID>adventure-works\paulw0</LoginID>
<Title>Production Technician - WC40</Title>
<BirthDate>1970-12-15 00:00:00.000</BirthDate>
<HireDate>1999-01-05 00:00:00.000</HireDate>
<MaritalStatus>S</MaritalStatus>
<Gender>M</Gender>
<rowguid>00001111-2222-3333-4444-555566667777</rowguid>
<ModifiedDate>1998-12-29 00:00:00.000</ModifiedDate>
</HumanResources.Employee>
</updg:after>
</updg:sync>
</ROOT>
2. Updategram을 사용하여 여러 레코드 삽입
이 Updategram은 HumanResources.Shift 테이블에 새 근무조 레코드 두 개를 추가합니다. 선택적 <before> 블록은 지정하지 않습니다.
<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 쿼리 실행을 참조하십시오.
이 예의 다른 버전은 한 블록 대신 두 개의 별도 <after> 블록을 사용하여 직원 두 명을 삽입하는 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>
3. 유효한 XML이 아닌 유효한 SQL Server 문자 작업
SQL Server에서 테이블 이름은 Northwind 데이터베이스의 Order Details 테이블과 같이 공백을 포함할 수 있습니다. 하지만 유효한 SQL Server 식별자이지만 유효한 XML 식별자가 아닌 XML 문자는 '__xHHHH__'를 인코딩 값으로 사용하여 인코딩할 수 있습니다. 여기서 HHHH는 해당 문자에 대한 최상위 비트 우선 순서의 4자리 16진수 UCS-2 코드를 나타냅니다.
[!참고]
이 예에서는 SQL Server 2000에서 처음 예제 데이터베이스로 제공된 Northwind 데이터베이스를 사용합니다. SQL Server의 이후 버전에서는 Northwind 데이터베이스가 제공되지 않습니다. 하지만 다운로드할 수 있는 SQL 스크립트를 사용하여 Northwind 데이터베이스를 설치할 수 있습니다. 자세한 내용은 Northwind 및 pubs 예제 데이터베이스 다운로드를 참조하십시오.
또한 요소 이름을 대괄호([ ])로 묶어야 합니다. [ 및 ] 문자는 XML에서 유효하지 않으므로 각각 _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>
Order Details 테이블의 UnitPrice 열은 money 형식입니다. 적절한 형식 변환(string 형식에서 money 형식으로 변환)을 적용하려면 값의 일부로 달러 기호 문자($)를 추가해야 합니다. Updategram에서 매핑 스키마를 지정하지 않는 경우 string 값의 첫 문자가 평가됩니다. 첫 문자가 달러 기호($)이면 해당 변환이 적용됩니다.
열이 dt:type="fixed.14.4" 또는 sql:datatype="money"로 적절하게 표시된 매핑 스키마에 대해 Updategram을 지정하면 달러 기호($)가 필요하지 않으며 매핑에 의해 변환이 처리됩니다. 적절한 형식 변환을 수행하려는 이 방법을 사용하는 것이 좋습니다.
스키마에 대해 예제 XPath 쿼리를 테스트하려면
위 Updategram을 복사한 후 텍스트 파일에 붙여넣습니다. 파일을 UpdategramSpacesInTableName.xml로 저장합니다.
SQLXML 4.0 테스트 스크립트(Sqlxml4test.vbs)를 만든 다음 이 스크립트를 사용하여 템플릿을 실행합니다.
자세한 내용은 ADO를 사용하여 SQLXML 4.0 쿼리 실행을 참조하십시오.
4. at-identity 특성을 사용하여 IDENTITY 유형 열에 삽입된 값 검색
다음 Updategram은 두 개의 레코드를 삽입합니다. 하나는 Sales.SalesOrderHeader 테이블에 삽입하고 다른 하나는 Sales.SalesOrderDetail 테이블에 삽입합니다.
먼저 Updategram은 Sales.SalesOrderHeader 테이블에 레코드를 추가합니다. 이 테이블에서 SalesOrderID 열은 IDENTITY 유형 열입니다. 따라서 이 레코드를 테이블에 추가할 때 Updategram은 at-identity 특성을 사용하여 할당된 SalesOrderID 값을 "x"(자리 표시자 값)로 캡처합니다. 그런 다음 Updategram은 이 at-identity 변수를 <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 쿼리 실행을 참조하십시오.
5. 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 쿼리 실행을 참조하십시오.
6. 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>
7. 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 쿼리 실행을 참조하십시오.
8. 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에서 도입되었습니다. Updategram을 사용하여 다음 프로비전과 함께 xml 데이터 형식 열에 저장된 데이터를 삽입 및 업데이트할 수 있습니다.
xml 열은 기존 행을 식별하는 데 사용할 수 없습니다. 따라서 Updategram의 updg:before 섹션에 포함할 수 없습니다.
xml 열에 삽입된 XML 조각의 범위에 있는 네임스페이스가 유지되고 해당 네임스페이스 선언이 삽입된 조각의 최상위 요소에 추가됩니다.
예를 들어 다음 Updategram(SampleUpdateGram.xml)에서 <Desc> 요소는 AdventureWorks 예제 데이터베이스의 Production>productModel 테이블에 있는 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"
>
<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; alumunim 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>Almuminum 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="https://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로 저장합니다.
[!참고]
Updategram은 기본 매핑을 지원하므로 xml 데이터 형식의 시작 부분과 끝 부분을 식별할 수 없습니다. 즉, xml 데이터 형식 열을 사용하여 테이블을 삽입하거나 업데이트할 때 매핑 스키마가 필요합니다. 스키마를 제공하지 않으면 SQLXML에서 열 중 하나가 테이블에 없음을 나타내는 오류를 반환합니다.
위 Updategram을 복사한 후 텍스트 파일에 붙여넣습니다. SampleSchema.xml을 저장하는 데 사용된 폴더와 같은 폴더에 SampleUpdategram.xml로 파일을 저장합니다.
SQLXML 4.0 테스트 스크립트(Sqlxml4test.vbs)를 만든 다음 이 스크립트를 사용하여 Updategram을 실행합니다.
자세한 내용은 ADO를 사용하여 SQLXML 4.0 쿼리 실행을 참조하십시오.