Скрытие элементов и атрибутов при помощи sql:hide

Применимо к:база данных SQL ServerAzure SQL

При выполнении запроса XPath к схеме XSD результирующий XML-документ содержит элементы и атрибуты, указанные в схеме. Некоторые элементы и атрибуты можно указать в схеме с помощью заметки sql:hide . Это может оказаться полезным в тех случаях, когда критерий выбора запроса требует определенных элементов или атрибутов в схеме, но они не должны возвращаться в формируемом XML-документе.

Заметка sql:hide принимает логическое значение (0=false, 1=true). Допустимые значения: 0, 1, true и false.

Примеры

Чтобы создать рабочие образцы на основе следующих примеров, необходимо выполнить определенные требования. Дополнительные сведения см. в разделе Требования для выполнения примеров SQLXML.

A. Указание sql:hide для атрибута

Схема XSD в этом примере состоит из <элемента Person.Contact> с атрибутами ContactID, FirstName и LastName .

Элемент <Person.Contact> имеет сложный тип и, следовательно, сопоставляется с таблицей с тем же именем (сопоставление по умолчанию). Все атрибуты <элемента Person.Contact> имеют простой тип и сопоставляются со столбцами с одинаковыми именами в person.Contacttable в базе данных AdventureWorks. В схеме заметка 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. Скопируйте следующий шаблон и вставьте его в текстовый файл. Сохраните файл под именем HideT.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-документе. Ниже приведена еще одна схема XSD, в которой в элементе <OD> указан параметр sql:hide:

<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>