Expressões de sequência (XQuery)
O SQL Server oferece 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. <telephoneNumber>, <pager>e outros nós podem aparecer em qualquer lugar no documento. A consulta constrói uma sequência que contém todos os filhos de <telephoneNumber> do nó de contexto, seguido pelos filhos de <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.Person
WHERE BusinessEntityID=291;
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>
Página somente no caso de emergências.
</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 nós do elemento <a>:
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 os elementos <a> que têm o atributo attrA, especifique um filtro no predicado. A sequência resultante terá só um elemento <a>.
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 os 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.