sql:limit-field 및 sql:limit-value를 사용하여 값 필터링(SQLXML 4.0)

아티클
07/05/2024

적용 대상: SQL Server Azure SQL Database

데이터베이스 쿼리를 통해 반환되는 행을 어떤 제한 값을 기준으로 제한할 수 있습니다. sql:limit-field 및 sql:limit-value 주석은 제한 값이 포함된 데이터베이스 열을 식별하고 반환된 데이터를 필터링하는 데 사용할 특정 제한 값을 지정하는 데 사용됩니다.

sql:limit-field 주석은 제한 값이 포함된 열을 식별하는 데 사용되며 매핑된 각 요소 또는 특성에서 허용됩니다.

sql:limit-value 주석은 sql:limit-field 주석에 지정된 열의 제한된 값을 지정하는 데 사용됩니다. sql:limit-value 주석은 선택 사항입니다. sql:limit-value를 지정하지 않으면 NULL 값이 가정됩니다.

참고 항목

매핑된 SQL 열이 실제 형식인 sql:limit-field를 사용하는 경우 SQLXML 4.0은 XML 스키마에 nvarchar 지정된 값으로 지정된 대로 sql:limit-value에서 변환을 수행합니다. 이 경우 공학용 표기법을 사용하여 10진수 제한 값을 지정해야 합니다. 자세한 내용은 아래 2번 예를 참조하십시오.

예제

이러한 예를 사용하여 작업 예제를 만들려면 다음과 같은 제품이 설치되어 있어야 합니다.

Microsoft SQL Server Native Client
MDAC 2.6 이상

이러한 예제에서 템플릿은 매핑 XSD 스키마에 대해 XPath 쿼리를 지정하는 데 사용됩니다.

A. 특정 주소 유형으로 반환되는 고객 주소 제한

이 예에서 데이터베이스에는 다음과 같은 두 개의 테이블이 있습니다.

Customer(CustomerID, CompanyName)
주소(CustomerID, AddressType, StreetAddress)

고객은 배송 주소 및/또는 청구 주소를 가질 수 있습니다. AddressType 열 값은 배송 및 청구입니다.

ShipTo 스키마 특성이 주소 관계의 StreetAddress 열에 매핑되는 매핑 스키마입니다. 이 특성에 대해 반환되는 값은 sql:limit-field 및 sql:limit-value 주석을 지정하여 전달 주소로만 제한됩니다. 마찬가지로 BillTo 스키마 특성은 고객의 청구 주소만 반환합니다.

스키마는 다음과 같습니다.

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"  
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">  
<xsd:annotation>  
  <xsd:appinfo>  
    <sql:relationship name="CustAddr"  
        parent="Customer"  
        parent-key="CustomerID"  
        child="Addresses"  
        child-key="CustomerID" />  
  </xsd:appinfo>  
</xsd:annotation>  
  
  <xsd:element name="Customer" sql:relation="Customer" >  
   <xsd:complexType>  
        <xsd:sequence>  
        <xsd:element name="BillTo"   
                       type="xsd:string"   
                       sql:relation="Addresses"   
                       sql:field="StreetAddress"  
                       sql:limit-field="AddressType"  
                       sql:limit-value="billing"  
                       sql:relationship="CustAddr" >  
        </xsd:element>  
        <xsd:element name="ShipTo"   
                       type="xsd:string"   
                       sql:relation="Addresses"   
                       sql:field="StreetAddress"  
                       sql:limit-field="AddressType"  
                       sql:limit-value="shipping"  
                       sql:relationship="CustAddr" >  
        </xsd:element>  
        </xsd:sequence>  
        <xsd:attribute name="CustomerID"   type="xsd:int" />   
        <xsd:attribute name="CompanyName"  type="xsd:string" />  
    </xsd:complexType>  
  </xsd:element>  
</xsd:schema>

스키마에 대해 샘플 XPath 쿼리를 테스트하려면

tempdb 데이터베이스에 다음 두 개의 테이블을 만듭니다.

USE tempdb  
CREATE TABLE Customer (CustomerID int primary key,   
                       CompanyName varchar(30))  
CREATE TABLE Addresses(CustomerID int,   
                       StreetAddress varchar(50),  
                       AddressType varchar(10))

샘플 데이터를 추가합니다.

INSERT INTO Customer values (1, 'Company A')  
INSERT INTO Customer values (2, 'Company B')  

INSERT INTO Addresses values  
           (1, 'Obere Str. 57 Berlin', 'billing')  
INSERT INTO Addresses values  
           (1, 'Avda. de la Constituci?n 2222 M?xico D.F.', 'shipping')  
INSERT INTO Addresses values  
           (2, '120 Hanover Sq., London', 'billing')  
INSERT INTO Addresses values  
           (2, 'Forsterstr. 57, Mannheim', 'shipping')

위 스키마 코드를 복사한 후 텍스트 파일에 붙여넣습니다. 파일을 LimitFieldValue.xml 저장합니다.
다음 템플릿(LimitFieldValueT.xml)을 만들고 이전 단계에서 스키마(LimitFieldValue.xml)를 저장한 것과 같은 디렉터리에 저장합니다.
```
<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">  
    <sql:xpath-query mapping-schema="LimitFieldValue.xml">  
        /Customer  
    </sql:xpath-query>  
</ROOT>  
```
매핑 스키마(LimitFieldValue.xml)에 대해 지정된 디렉터리 경로는 템플릿이 저장된 디렉터리에 상대적입니다. 절대 경로도 지정할 수 있습니다. 예를 들면 다음과 같습니다.
```
mapping-schema="C:\MyDir\LimitFieldValue.xml"  
```
SQLXML 4.0 테스트 스크립트(Sqlxml4test.vbs)를 만들고 사용하여 템플릿을 실행합니다.

자세한 내용은 ADO를 사용하여 SQLXML 쿼리를 실행합니다.

다음은 결과입니다.

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">   
  <Customer CustomerID="1" CompanyName="Company A">   
     <BillTo>Obere Str. 57 Berlin</BillTo>   
     <ShipTo>Avda. de la Constituci?n 2222 M?xico D.F.</ShipTo>   
  </Customer>   
  <Customer CustomerID="2" CompanyName="Company B">   
     <BillTo>120 Hanover Sq., London</BillTo>   
     <ShipTo>Forsterstr. 57, Mannheim</ShipTo>   
   </Customer>   
</ROOT>

B. Real 데이터 형식의 할인 값을 기준으로 결과 제한

이 예에서 데이터베이스에는 다음과 같은 두 개의 테이블이 있습니다.

Orders(OrderID)
OrderDetails(OrderID, ProductID, UnitPrice, Quantity, Price, Discount)

주문 세부 정보의 OrderID 특성이 주문 관계의 OrderID 열에 매핑되는 매핑 스키마입니다. 이 특성에 대해 반환되는 값은 sql:limit-field 및 sql:limit-value 주석을 사용하여 Discount 특성에 지정된 대로 값이 2.00000000e-001(0.2)인 값으로만 제한됩니다.

스키마는 다음과 같습니다.

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"  
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">  
  <xsd:annotation>  
   <xsd:appinfo>  
    <sql:relationship name="OrderOrderDetails"  
        parent="Orders"  
        parent-key="OrderID"  
        child="OrderDetails"  
        child-key="OrderID" />  
   </xsd:appinfo>  
  </xsd:annotation>  
  <xsd:element name="root" sql:is-constant="1">  
   <xsd:complexType>  
     <xsd:sequence>  
       <xsd:element name="Order" sql:relation="Orders" >  
          <xsd:complexType>  
             <xsd:sequence>  
                <xsd:element name="orderDetail"   
                       sql:relation="OrderDetails"   
                       sql:limit-field="Discount"                       sql:limit-value="2.0000000e-001"  
                       sql:relationship="OrderOrderDetails">  
                   <xsd:complexType>  
                     <xsd:attribute name="OrderID"   />   
                     <xsd:attribute name="ProductID" />   
                     <xsd:attribute name="Discount"  />   
                     <xsd:attribute name="Quantity"  />   
                     <xsd:attribute name="UnitPrice" />   
                   </xsd:complexType>  
                </xsd:element>  
            </xsd:sequence>  
           <xsd:attribute name="OrderID"/>   
          </xsd:complexType>  
       </xsd:element>  
     </xsd:sequence>  
   </xsd:complexType>  
  </xsd:element>  
</xsd:schema>

스키마에 대해 샘플 XPath 쿼리를 테스트하려면

tempdb 데이터베이스에 다음 두 개의 테이블을 만듭니다.

USE tempdb  
CREATE TABLE Orders ([OrderID] int NOT NULL ) ON [PRIMARY]  
ALTER TABLE Orders WITH NOCHECK ADD   
CONSTRAINT [PK_Orders] PRIMARY KEY  CLUSTERED (  
   [OrderID]  
 )  ON [PRIMARY]   
CREATE TABLE [OrderDetails] (  
   [OrderID] int NOT NULL ,  
   [ProductID] int NOT NULL ,  
   [UnitPrice] money NULL ,  
   [Quantity] smallint NOT NULL ,  
   [Discount] real NOT NULL   
) ON [PRIMARY]

샘플 데이터를 추가합니다.

INSERT INTO Orders ([OrderID]) values (10248)  
INSERT INTO Orders ([OrderID]) values (10250)  
INSERT INTO Orders ([OrderID]) values (10251)  
INSERT INTO Orders ([OrderID]) values (10257)  
INSERT INTO Orders ([OrderID]) values (10258)  
INSERT INTO [OrderDetails] ([OrderID],[ProductID],[UnitPrice],[Quantity],[Discount]) values (10248,11,14,12,0)  
INSERT INTO [OrderDetails] ([OrderID],[ProductID],[UnitPrice],[Quantity],[Discount]) values (10250,51,42.4,35,0.15)  
INSERT INTO [OrderDetails] ([OrderID],[ProductID],[UnitPrice],[Quantity],[Discount]) values (10251,22,16.8,6,0.05)  
INSERT INTO [OrderDetails] ([OrderID],[ProductID],[UnitPrice],[Quantity],[Discount]) values (10257,77,10.4,15,0)  
INSERT INTO [OrderDetails] ([OrderID],[ProductID],[UnitPrice],[Quantity],[Discount]) values (10258,2,15.2,50,0.2)

디렉터리에 스키마(LimitFieldValue.xml)를 저장합니다.

다음 테스트 스크립트(TestQuery.vbs)를 만들고, MyServer를 SQL Server 컴퓨터의 이름으로 수정하고, 이전 단계에서 스키마를 저장하는 데 사용한 것과 동일한 디렉터리에 저장합니다.

Set conn = CreateObject("ADODB.Connection")  
conn.Open "Provider=SQLOLEDB;Data Source=MyServer;Database=tempdb;Integrated Security=SSPI"  
conn.Properties("SQLXML Version") = "sqlxml.4.0"   
Set cmd = CreateObject("ADODB.Command")  
Set stm = CreateObject("ADODB.Stream")  
Set cmd.ActiveConnection = conn  
stm.open  
result ="none"  
strXPathQuery="/root"  
DBGUID_XPATH = "{EC2A4293-E898-11D2-B1B7-00C04F680C56}"  
cmd.Dialect = DBGUID_XPATH  
cmd.CommandText = strXPathQuery  
cmd.Properties("Mapping schema") = "LimitFieldReal.xml"  
cmd.Properties("Output Stream").Value = stm  
cmd.Properties("Output Encoding") = "utf-8"  
WScript.Echo "executing for xml query"  
On Error Resume Next  
cmd.Execute , ,1024  
if err then  
Wscript.Echo err.description  
Wscript.Echo err.Number  
Wscript.Echo err.source  
On Error GoTo 0  
else  
stm.Position = 0  
result  = stm.ReadText  
end if  
WScript.Echo result  
Wscript.Echo "done"

Windows 탐색기에서 TestQuery.vbs 파일을 클릭하여 실행합니다.

다음은 결과입니다.

<root>  
  <Order OrderID="10248"/>  
  <Order OrderID="10250"/>  
  <Order OrderID="10251"/>  
  <Order OrderID="10257"/>  
  <Order OrderID="10258">  
    <orderDetail OrderID="10258"   
                 ProductID="2"   
                 Discount="0.2"   
                 Quantity="50"/>  
  </Order>  
</root>

참고 항목

float 및 real(Transact-SQL)
nchar 및 nvarchar(Transact-SQL)
SQL Server Native Client 설치
쿼리에서 주석이 추가된 XSD 스키마 사용(SQLXML 4.0)

다음을 통해 공유

sql:limit-field 및 sql:limit-value를 사용하여 값 필터링(SQLXML 4.0)

예제

A. 특정 주소 유형으로 반환되는 고객 주소 제한

스키마에 대해 샘플 XPath 쿼리를 테스트하려면

B. Real 데이터 형식의 할인 값을 기준으로 결과 제한

스키마에 대해 샘플 XPath 쿼리를 테스트하려면

참고 항목

피드백

피드백

추가 리소스