sql:hide를 사용하여 요소 및 특성 숨기기

적용 대상: SQL ServerAzure SQL Database

XSD 스키마에 대해 XPath 쿼리를 실행하면 결과 XML 문서에는 스키마에 지정된 요소와 특성이 있습니다. sql:hide 주석을 사용하여 스키마에서 일부 요소와 특성을 숨기 게 지정할 수 있습니다. 이는 쿼리의 선택 조건에 스키마의 특정 요소 또는 특성이 필요하지만 생성된 XML 문서에서 반환하지 않으려는 경우에 유용합니다.

sql:hide 주석은 부울 값(0=false, 1=true)을 사용합니다. 허용되는 값은 0, 1, true 및 false입니다.

예제

다음 예제를 사용하여 작업 샘플을 만들려면 특정 요구 사항을 충족해야 합니다. 자세한 내용은 SQLXML 실행 요구 사항 예제를 참조 하세요.

A. 특성에 sql:hide 지정

이 예제의 <XSD 스키마는 ContactID, FirstName 및 LastName 특성이 있는 Person.Contact> 요소로 구성됩니다.

<Person.Contact> 요소는 복합 형식이므로 동일한 이름의 테이블(기본 매핑)에 매핑됩니다. Person.Contact> 요소의 <모든 특성은 단순 형식이며 AdventureWorks 데이터베이스의 Person.Contacttable에서 이름이 같은 열에 매핑됩니다. 스키마에서 sql:hide 주석은 ContactID 특성에 지정됩니다. 이 스키마 에 대해 XPath 쿼리를 지정하면 ContactID 가 XML 문서에 반환되지 않습니다.

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"   
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">  
  <xsd:element name="Person.Contact" >  
     <xsd:complexType>  
       <xsd:attribute name="ContactID"  sql:hide="true" />   
       <xsd:attribute name="FirstName"   type="xsd:string" />   
       <xsd:attribute name="LastName"    type="xsd:string" />   
     </xsd:complexType>  
  </xsd:element>  
</xsd:schema>  

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

1. 위 스키마 코드를 복사한 후 텍스트 파일에 붙여넣습니다. 파일을 Hide.xml로 저장합니다.

2. 다음 템플릿을 복사하여 텍스트 파일에 붙여넣습니다. 파일을 Hide.xml을 저장한 디렉터리와 같은 디렉터리에 HideT.xml로 저장합니다.

   <ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">  
       <sql:xpath-query mapping-schema="Hide.xml">  
           /Person.Contact[@ContactID="1"]  
       </sql:xpath-query>  
   </ROOT>  
   

   매핑 스키마(Hide.xml)에 지정된 디렉터리 경로는 템플릿이 저장된 디렉터리를 기준으로 합니다. 절대 경로도 지정할 수 있습니다. 예를 들면 다음과 같습니다.

   mapping-schema="C:\MyDir\Hide.xml"  
   

3. SQLXML 4.0 테스트 스크립트(Sqlxml4test.vbs)를 만들고 사용하여 템플릿을 실행합니다.

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

결과 집합은 다음과 같습니다.

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">  
   <Person.Contact FirstName="Gustavo" LastName="Achong" />   
</ROOT>  

요소에 sql:hide를 지정하면 요소와 해당 특성 또는 자식 요소가 생성된 XML 문서에 나타나지 않습니다. 다음은 OD> 요소에 sql:hide가 지정된 <또 다른 XSD 스키마입니다.

<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">  
  
  <xsd:annotation>  
    <xsd:documentation>  
      Sales.Customer-Sales.SalesOrderHeader-Sales.SalesOrderDetail Schema  
      Copyright 2004 Microsoft. All rights reserved.  
    </xsd:documentation>  
    <xsd:appinfo>  
      <sql:relationship name="CustomerOrder"  
         parent="Sales.Customer"  
                  parent-key="CustomerID"  
                  child-key="CustomerID"  
                  child="Sales.SalesOrderHeader" />  
       <sql:relationship name="OrderOrderDetails"  
                  parent="Sales.SalesOrderHeader"  
                  parent-key="SalesOrderID"  
                  child-key="SalesOrderID"  
                  child="Sales.SalesOrderDetail"/>  
    </xsd:appinfo>  
  </xsd:annotation>  
  
  <xsd:element name="Customers" sql:relation="Sales.Customer">  
    <xsd:complexType>  
      <xsd:sequence>  
        <xsd:element name="Order" sql:relation="Sales.SalesOrderHeader"   
                     maxOccurs="unbounded"   
                     sql:relationship="CustomerOrder">  
          <xsd:complexType>  
            <xsd:sequence>  
               <xsd:element name="OD" sql:relation="Sales.SalesOrderDetail"                                       maxOccurs="unbounded"                                       sql:relationship="OrderOrderDetails"                                       sql:hide="1">  
                  <xsd:complexType>  
                    <xsd:attribute name="SalesOrderID" type="xsd:string"/>  
                    <xsd:attribute name="ProductID" type="xsd:string"/>  
                  </xsd:complexType>  
               </xsd:element>  
            </xsd:sequence>  
          <xsd:attribute name="CustomerID" type="xsd:string"/>  
          <xsd:attribute name="OID" sql:field="SalesOrderID"   
                                    type="xsd:string"/>  
          <xsd:attribute name="OrderDate" type="xsd:date"/>   
        </xsd:complexType>  
      </xsd:element>  
    </xsd:sequence>  
    <xsd:attribute name="CID" sql:field="CustomerID"   
                                type="xsd:string"/>  
    </xsd:complexType>  
  </xsd:element>  
</xsd:schema>  

이 스키마에 대해 XPath 쿼리(예/Customers[@CID="1"]: )를 지정하면 이 부분 결과에 표시된 것처럼 생성된 XML 문서에는 OD> 요소와 해당 자식이 포함되지 <않습니다.

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">  
  <Customers CID="1">  
    <Order CustomerID="1" OID="43860" OrderDate="2001-08-01" />   
    <Order CustomerID="1" OID="44501" OrderDate="2001-11-01" />   
    <Order CustomerID="1" OID="45283" OrderDate="2002-02-01" />   
    <Order CustomerID="1" OID="46042" OrderDate="2002-05-01" />   
  </Customers>  
</ROOT>