Casos gerais de uso de XQuery

Este tópico fornece exemplos gerais de uso de XQuery.

Exemplos

A. Descrições de consulta de catálogo para localizar produtos e pesos

A consulta a seguir retorna as IDs e os pesos de modelo do produto , se existentes, da descrição do catálogo de produtos. A consulta constrói XML que tenha a seguinte forma:

<Product ProductModelID="…">
  <Weight>…</Weight>
</Product>

Esta é a consulta:

SELECT CatalogDescription.query('
declare namespace p1="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
  <Product  ProductModelID="{ (/p1:ProductDescription/@ProductModelID)[1] }">
     { 
       /p1:ProductDescription/p1:Specifications/Weight 
     } 
  </Product>
') as Result
FROM Production.ProductModel
WHERE CatalogDescription is not null

Observe o seguinte na consulta anterior:

• A palavra-chave namespace no prólogo do XQuery define um prefixo de namespace usado no corpo da consulta.

• O corpo da consulta constrói o XML exigido.

• Na cláusula WHERE, o método exist() é usado para localizar somente linhas que contenham descrições de catálogo de produto. Ou seja, o XML que contém o elemento <ProductDescription>.

Este é o resultado:

<Product ProductModelID="19"/>
<Product ProductModelID="23"/> 
<Product ProductModelID="25"/> 
<Product ProductModelID="28"><Weight>Varies with size.</Weight></Product>
<Product ProductModelID="34"/>
<Product ProductModelID="35"/>

A consulta a seguir recupera a mesma informação, mas apenas para aqueles modelos de produto cuja descrição de catálogo inclui o peso, o elemento <Weight>, nas especificações, o elemento <Specifications>. Este exemplo usa WITH XMLNAMESPACES para declarar o prefixo pd e sua associação de namespace. Neste modo, a associação não é descrita no método query() e no método exist().

WITH XMLNAMESPACES ('https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription' AS pd)
SELECT CatalogDescription.query('
          <Product  ProductModelID="{ (/pd:ProductDescription/@ProductModelID)[1] }">
                 { 
                      /pd:ProductDescription/pd:Specifications/Weight 
                 } 
          </Product>
') as x
FROM Production.ProductModel
WHERE CatalogDescription.exist('/pd:ProductDescription/pd:Specifications//Weight ') = 1

Na consulta anterior, o método exist() do tipo de dados xml na cláusula WHERE faz a verificação para ver se há um elemento <Weight> no elemento <Specifications>.

B. Localizar IDs de modelo de produto para modelos de produto cujas descrições de catálogo incluem ângulo frontal e pequenas fotos

A descrição de catálogo de produto XML inclui as fotos do produto, o elemento <Picture>. Cada foto tem várias propriedades. Essas incluem o ângulo da foto, o elemento <Angle> e o tamanho, o elemento <Size>.

Para modelos de produtos cujas descrições de catálogo incluem ângulo frontal e pequenas fotos, a consulta constrói um XML com o seguinte formato:

< Product ProductModelID="…">
  <Picture>
    <Angle>front</Angle>
    <Size>small</Size>
  </Picture>
</Product>
WITH XMLNAMESPACES ('https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription' AS pd)
SELECT CatalogDescription.query('
   <pd:Product  ProductModelID="{ (/pd:ProductDescription/@ProductModelID)[1] }">
      <Picture>
         {  /pd:ProductDescription/pd:Picture/pd:Angle } 
         {  /pd:ProductDescription/pd:Picture/pd:Size } 
      </Picture>
   </pd:Product>
') as Result
FROM  Production.ProductModel
WHERE CatalogDescription.exist('/pd:ProductDescription/pd:Picture') = 1
AND   CatalogDescription.value('(/pd:ProductDescription/pd:Picture/pd:Angle)[1]', 'varchar(20)')  = 'front'
AND   CatalogDescription.value('(/pd:ProductDescription/pd:Picture/pd:Size)[1]', 'varchar(20)')  = 'small'

Observe o seguinte na consulta anterior:

• Na cláusula WHERE, o método exist() é usado para recuperar somente as linhas que tenham descrições de catálogo de produto com o elemento <Picture>.

• A cláusula WHERE usa o método value() duas vezes para comparar os valores dos elementos <Size> e <Angle>.

Este é um resultado parcial:

<p1:Product 
  xmlns:p1="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription" 
  ProductModelID="19">
  <Picture>
    <p1:Angle>front</p1:Angle>
    <p1:Size>small</p1:Size>
  </Picture>
</p1:Product>
...

C. Cria uma lista simples de pares de nome do modelo do produto e de características, cada par incluído no elemento <Características>

Na descrição de catálogo de modelo de produto, o XML inclui várias características de produto. Todas essas características estão inclusas no elemento <Features>. A consulta usa Construção de XML (XQuery) para construir o XML exigido. A expressão nas chaves é substituída pelo resultado.

SELECT CatalogDescription.query('
declare namespace p1="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
  for $pd in /p1:ProductDescription,
   $f in $pd/p1:Features/*
  return
   <Feature>
     <ProductModelName> { data($pd/@ProductModelName) } </ProductModelName>
     { $f }
  </Feature>        
') as x
FROM Production.ProductModel
WHERE ProductModelID=19

Observe o seguinte na consulta anterior:

• $pd/p1:Features/* retorna só os nós filhos do elemento de <Features>, mas $pd/p1:Features/node() retorna todos os nós. Isso inclui os nós de elemento, nós de texto, as instruções de processamento e os comentários.

• Os dois loops FOR geram um produto Cartesiano do qual o nome de produto e a característica individual são retornados.

• O ProductName é um atributo. A construção XML nesta consulta retorna-o como um elemento.

Este é um resultado parcial:

<Feature>
 <ProductModelName>Mountain 100</ProductModelName>
 <ProductModelID>19</ProductModelID>
 <p1:Warranty 
   xmlns:p1="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain">
    <p1:WarrantyPeriod>3 year</p1:WarrantyPeriod>
    <p1:Description>parts and labor</p1:Description>
 </p1:Warranty>
</Feature>
<Feature>
 <ProductModelName>Mountain 100</ProductModelName>
 <ProductModelID>19</ProductModelID>
 <p2:Maintenance xmlns:p2="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain">
    <p2:NoOfYears>10</p2:NoOfYears>
    <p2:Description>maintenance contact available through your dealer 
           or any Adventure Works retail store.</p2:Description>
    </p2:Maintenance>
</Feature>
...
...    

D. Na descrição de catálogo de um modelo de produto, lista o nome do modelo do produto, a ID do modelo e as características agrupadas dentro do elemento <Produto>

Usando a informação armazenada na descrição de catálogo de um modelo de produto, a consulta a seguir lista o nome do modelo do produto, a ID do modelo e as características agrupadas dentro do elemento <Produto>.

SELECT ProductModelID, CatalogDescription.query('
     declare namespace pd="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
     <Product>
         <ProductModelName> 
           { data(/pd:ProductDescription/@ProductModelName) } 
         </ProductModelName>
         <ProductModelID> 
           { data(/pd:ProductDescription/@ProductModelID) } 
         </ProductModelID>
         { /pd:ProductDescription/pd:Features/* }
     </Product>        
') as x
FROM Production.ProductModel
WHERE ProductModelID=19

Este é um resultado parcial:

<Product>
  <ProductModelName>Mountain 100</ProductModelName>
  <ProductModelID>19</ProductModelID>
  <p1:Warranty>... </p1:Warranty>
  <p2:Maintenance>...  </p2:Maintenance>
  <p3:wheel xmlns:p3="https://www.adventure-works.com/schemas/OtherFeatures">High performance wheels.</p3:wheel>
  <p4:saddle xmlns:p4="https://www.adventure-works.com/schemas/OtherFeatures">
    <p5:i xmlns:p5="http://www.w3.org/1999/xhtml">Anatomic design</p5:i> and made from durable leather for a full-day of riding in comfort.</p4:saddle>
  <p6:pedal xmlns:p6="https://www.adventure-works.com/schemas/OtherFeatures">
    <p7:b xmlns:p7="http://www.w3.org/1999/xhtml">Top-of-the-line</p7:b> clipless pedals with adjustable tension.</p6:pedal>
   ...

E. Recupera as descrições de característica do modelo do produto

A consulta a seguir constrói o XML que inclui um elemento <Product> que tem os atributos ProductModelID e ProductModelName, e as duas primeiras características do produto. Especificamente, as duas primeiras características de produto são os dois primeiros elementos filho do elemento <Features>. Se houver mais características, ela retornará um elemento vazio <There-is-more/>.

SELECT CatalogDescription.query('
declare namespace pd="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
     <Product> 
          { /pd:ProductDescription/@ProductModelID }
          { /pd:ProductDescription/@ProductModelName } 
          {
            for $f in /pd:ProductDescription/pd:Features/*[position()<=2]
            return
            $f 
          }
          {
            if (count(/pd:ProductDescription/pd:Features/*) > 2)
            then <there-is-more/>
            else ()
          } 
     </Product>        
') as Result
FROM Production.ProductModel
WHERE CatalogDescription is not NULL

Observe o seguinte na consulta anterior:

• A estrutura de loop FOR ... RETURN recupera as duas primeiras características de produto. A função position() é usada para localizar a posição dos elementos na sequência.

F. Localizar nomes de elemento da descrição de catálogo de produto que termina com "ões"

A consulta a seguir pesquisa as descrições de catálogo e retorna todos os elementos no elemento <ProductDescription> cujo nome termina em “ões”.

SELECT ProductModelID, CatalogDescription.query('
     declare namespace p1="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
      for $pd in /p1:ProductDescription/*[substring(local-name(.),string-length(local-name(.))-2,3)="ons"]
      return 
          <Root>
             { $pd }
          </Root>
') as Result
FROM Production.ProductModel
WHERE CatalogDescription is not NULL

Este é um resultado parcial:

ProductModelID   Result
-----------------------------------------
         19        <Root>       
                     <p1:Specifications xmlns:p1="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription">        
                          ...       
                     </p1:Specifications>       
                   </Root>        

G. Localizar descrições sumárias que contêm a palavra "Aerodinâmico"

A consulta a seguir recupera modelos de produto cujas descrições de catálogo contêm a palavra "Aerodinâmico" na descrição sumária:

WITH XMLNAMESPACES ('https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription' AS pd)
SELECT ProductModelID, CatalogDescription.query('
          <Prod >
             { /pd:ProductDescription/@ProductModelID }
             { /pd:ProductDescription/pd:Summary }
          </Prod>
 ') as Result
FROM Production.ProductModel
WHERE CatalogDescription.value('
     contains( string( (/pd:ProductDescription/pd:Summary)[1] ),"Aerodynamic")','bit') = 1

Observe que a consulta SELECT especifica os métodos query() e value() do tipo de dados xml. Portanto, em vez de repetir a declaração namespaces duas vezes em dois prólogos de consulta diferentes, o prefixo pd será usado na consulta e será definido apenas uma vez usando WITH XMLNAMESPACES.

Observe o seguinte na consulta anterior:

• A cláusula WHERE é usada para recuperar apenas as linhas em que a descrição de catálogo contém a palavra “Aerodinâmico” no elemento <Summary>.

• A função contains() será usada para verificar se a palavra está incluída no texto.

• O método value() do tipo de dados xml compara o valor retornado por contains() com 1.

Este é o resultado:

ProductModelID Result      
-------------- ------------------------------------------
28     <Prod ProductModelID="28">
        <pd:Summary xmlns:pd="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription">
       <p1:p xmlns:p1="http://www.w3.org/1999/xhtml">
         A TRUE multi-sport bike that offers streamlined riding and a
         revolutionary design. Aerodynamic design lets you ride with the 
         pros, and the gearing will conquer hilly roads.</p1:p>
       </pd:Summary>
      </Prod>  

H. Localizar modelos de produto cujas descrições de catálogo não incluem fotos do modelo do produto

A consulta a seguir recupera ProductModelIDs para modelos de produto cujas descrições de catálogo não incluem um elemento <Picture>.

SELECT  ProductModelID
FROM    Production.ProductModel
WHERE   CatalogDescription is not NULL
AND     CatalogDescription.exist('declare namespace p1="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
     /p1:ProductDescription/p1:Picture
') = 0

Observe o seguinte na consulta anterior:

• Se o método exist() na cláusula WHERE retorna False (0), a ID do modelo do produto é retornada. Caso contrário, não é retornado.

• Como todas as descrições de produto incluem um elemento <Picture>, o conjunto de resultados nesse caso está vazio.

Consulte também

Referência

XQueries que envolvem hierarquia

XQueries que envolvem ordem

XQueries que manipulam dados relacionais

Manipulando namespaces em XQuery

Conceitos

Pesquisa de cadeia de caracteres em XQuery

Adicionando namespaces usando WITH XMLNAMESPACES

Implementando XML no SQL Server

Implementando XML no SQL Server

Outros recursos

Referência da linguagem XQuery (Mecanismo de Banco de Dados)

Representação de tipo de dados xml no banco de dados do AdventureWorks2008R2

Referência da linguagem XQuery (Mecanismo de Banco de Dados)