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