Expressões de sequência (XQuery)

  • Artigo

Aplica-se a:SQL Server

SQL Server dá suporte aos operadores XQuery usados para construir, filtrar e combinar uma sequência de itens. Um item pode ser um valor atômico ou um nó.

Construindo sequências

Você pode usar o operador vírgula para construir uma sequência que concatena itens em uma única sequência.

Uma sequência pode conter valores duplicados. As sequências aninhadas, uma sequência dentro de uma sequência, são recolhidas. Por exemplo, a sequência (1, 2, (3, 4, (5))) se torna (1, 2, 3, 4, 5). Estes são exemplos de construção de sequências.

Exemplo A

A consulta a seguir retorna uma sequência de cinco valores atômicos:

declare @x xml  
set @x=''  
select @x.query('(1,2,3,4,5)')  
go  
-- result 1 2 3 4 5

A consulta a seguir retorna uma sequência de dois nós:

-- sequence of 2 nodes  
declare @x xml  
set @x=''  
select @x.query('(<a/>, <b/>)')  
go  
-- result  
<a />  
<b />

A consulta a seguir retorna um erro, pois você está construindo uma sequência de valores atômicos e nós. Esta é uma sequência heterogênea e sem-suporte.

declare @x xml  
set @x=''  
select @x.query('(1, 2, <a/>, <b/>)')  
go

Exemplo B

A consulta a seguir constrói uma sequência de valores atômicos combinando quatro sequências de comprimento diferente em uma única sequência.

declare @x xml  
set @x=''  
select @x.query('(1,2),10,(),(4, 5, 6)')  
go  
-- result = 1 2 10 4 5 6

Você pode classificar a sequência usando FLOWR e ORDER BY:

declare @x xml  
set @x=''  
select @x.query('for $i in ((1,2),10,(),(4, 5, 6))  
                  order by $i  
                  return $i')  
go

Você pode contar os itens na sequência usando a função fn:count( ).

declare @x xml  
set @x=''  
select @x.query('count( (1,2,3,(),4) )')  
go  
-- result = 4

Exemplo C

A consulta a seguir é especificada na coluna AdditionalContactInfo do tipo xml na tabela Contact. Essa coluna armazena informações adicionais do contato, como um ou mais números de telefone, números de pager e endereços. O <telefoneNumber>, <pager> e outros nós podem aparecer em qualquer lugar do documento. A consulta constrói uma sequência que contém todos os <filhos telephoneNumber> do nó de contexto, seguidos pelos filhos do <pager> . Observe o uso do operador de sequência vírgula na expressão de retorno, ($a//act:telephoneNumber, $a//act:pager).

WITH XMLNAMESPACES ('https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes' AS act,  
 'https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactInfo' AS aci)  
  
SELECT AdditionalContactInfo.query('  
   for $a in /aci:AdditionalContactInfo   
   return ($a//act:telephoneNumber, $a//act:pager)  
') As Result  
FROM Person.Contact  
WHERE ContactID=3

Este é o resultado:

<act:telephoneNumber xmlns:act="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes">  
  <act:number>333-333-3333</act:number>  
</act:telephoneNumber>  
<act:telephoneNumber xmlns:act="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes">  
  <act:number>333-333-3334</act:number>  
</act:telephoneNumber>  
<act:pager xmlns:act="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes">  
  <act:number>999-555-1244</act:number>  
  <act:SpecialInstructions>  
Page only in case of emergencies.  
</act:SpecialInstructions>  
</act:pager>

Filtrando sequências

Você pode filtrar a sequência retornada por uma expressão adicionando um predicado à expressão. Para obter mais informações, consulte Expressões de caminho (XQuery). Por exemplo, a consulta a seguir retorna uma sequência de três <a> nós de elemento:

declare @x xml  
set @x = '<root>  
<a attrA="1">111</a>  
<a></a>  
<a></a>  
</root>'  
SELECT @x.query('/root/a')

Este é o resultado:

<a attrA="1">111</a>  
<a />  
<a />

Para recuperar apenas <a> os elementos que têm o atributo attrA, você pode especificar um filtro no predicado. A sequência resultante terá apenas um <a> elemento.

declare @x xml  
set @x = '<root>  
<a attrA="1">111</a>  
<a></a>  
<a></a>  
</root>'  
SELECT @x.query('/root/a[@attrA]')

Este é o resultado:

<a attrA="1">111</a>

Para obter mais informações sobre como especificar predicados em uma expressão de caminho, consulte Especificando predicados em uma etapa de expressão de caminho.

O exemplo a seguir constrói uma expressão de sequência de subárvores e depois aplica um filtro à sequência.

declare @x xml  
set @x = '  
<a>  
  <c>C under a</c>  
</a>  
<b>    
   <c>C under b</c>  
</b>  
<c>top level c</c>  
<d></d>  
'

A expressão em (/a, /b) constrói uma sequência com subárvores /a e /b e da sequência resultante a expressão filtra o elemento <c>.

SELECT @x.query('  
  (/a, /b)/c  
')

Este é o resultado:

<c>C under a</c>  
<c>C under b</c>

O exemplo a seguir aplica um filtro de predicado. A expressão localiza elementos <a> e>b< que contêm o elemento .<c>

declare @x xml  
set @x = '  
<a>  
  <c>C under a</c>  
</a>  
<b>    
   <c>C under b</c>  
</b>  
  
<c>top level c</c>  
<d></d>  
'  
SELECT @x.query('  
  (/a, /b)[c]  
')

Este é o resultado:

<a>  
  <c>C under a</c>  
</a>  
<b>  
  <c>C under b</c>  
</b>

Limitações de implementação

Estas são as limitações:

  • Não há suporte para a expressão de intervalo XQuery.

  • As sequências devem ser homogêneas. Especificamente, todos os itens em uma sequência devem ser nós ou valores atômicos. Isso é verificado estaticamente.

  • Não há suporte para a combinação de sequências de nó usando operadores de união, intersecção ou exceção.

Consulte Também

Expressões XQuery