Sequência e QNames (XQuery)

Aplica-se: SQL Server

Este tópico descreve os seguintes conceitos fundamentais do XQuery:

• Sequência

• QNames e namespaces predefinidos

Sequência

No XQuery, o resultado de uma expressão é uma sequência constituída de uma lista de nós e instâncias XML de tipos atômicos XSD. Uma entrada individual em uma sequência é chamada de item. Um item em uma sequência pode ser qualquer um dos seguintes:

• Um nó como um elemento, atributo, texto, instrução de processamento, comentário ou documento

• Um valor atômico como uma instância de um tipo simples de XSD

Por exemplo, a consulta a seguir constrói uma sequência de dois itens de nós do elemento:

SELECT Instructions.query('  
     <step1> Step 1 description goes here</step1>,  
     <step2> Step 2 description goes here </step2>  
') AS Result  
FROM Production.ProductModel  
WHERE ProductModelID=7;  
  

Este é o resultado:

<step1> Step 1 description goes here </step1>  
<step2> Step 2 description goes here </step2>   

Na consulta anterior, a vírgula (,) no fim da construção <step1> é o construtor de sequência e é necessária. Os espaços em branco nos resultados são introduzidos apenas para fins ilustrativos e são inclusos em todos os resultados dos exemplos nessa documentação.

A seguir são apresentadas informações adicionais de seu interesse sobre sequências:

• Se uma consulta resultar em uma sequência que contém outra sequência, a sequência contida é simplificada na sequência de contêiner. Por exemplo, a sequência ((1,2, (3,4,5)),6) é simplificada no modelo de dados como (1, 2, 3, 4, 5, 6).

  DECLARE @x xml;  
  SET @x = '';  
  SELECT @x.query('(1,2, (3,4,5)),6');  
  

• Uma sequência vazia é uma sequência que não contém nenhum item. Ela é representada como "()".

• Uma sequência com apenas um item pode ser tratada como um valor atômico, e vice-versa. Ou seja, (1) = 1.

Nessa implementação, a sequência deve ser homogênea. Ou seja, ou você tem uma sequência de valores atômicos ou uma sequência de nós. Por exemplo, as seguintes são sequências válidas:

DECLARE @x xml;  
SET @x = '';  
-- Expression returns a sequence of 1 text node (singleton).  
SELECT @x.query('1');  
-- Expression returns a sequence of 2 text nodes  
SELECT @x.query('"abc", "xyz"');  
-- Expression returns a sequence of one atomic value. data() returns  
-- typed value of the node.  
SELECT @x.query('data(1)');  
-- Expression returns a sequence of one element node.   
-- In the expression XML construction is used to construct an element.  
SELECT @x.query('<x> {1+2} </x>');  

A consulta a seguir retorna um erro, porque não há suporte para sequências heterogêneas.

SELECT @x.query('<x>11</x>, 22');  

QName

Todo identificador em um XQuery é um QName. Um QName é constituído de um prefixo de namespace e de um nome local. Nessa implementação, os nomes de variáveis no XQuery são QNames e eles não podem ter prefixos.

Considere o exemplo a seguir no qual uma consulta é especificada em relação a uma variável xml não tipada:

DECLARE @x xml;  
SET @x = '<Root><a>111</a></Root>';  
SELECT @x.query('/Root/a');  

Na expressão (/Root/a), Root e a são QNames.

No exemplo a seguir, uma consulta é especificada em relação a uma coluna xml tipada. A consulta itera em todos os <elementos da etapa> no primeiro local do centro de trabalho.

SELECT Instructions.query('  
   declare namespace AWMI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";  
for $Step in /AWMI:root/AWMI:Location[1]/AWMI:step  
      return  
           string($Step)   
') AS Result  
FROM Production.ProductModel  
WHERE ProductModelID=7;  

Na expressão da consulta, observe o seguinte:

• AWMI root, AWMI:Location, AWMI:stepe $Step são todos QNames. AWMI é um prefixo, e root, Location e Step são todos nomes de locais.

• A variável $step é um QName e não tem um prefixo.

Os namespaces a seguir são predefinidos para uso com suporte a XQuery no SQL Server.

Cada banco de dados que você cria tem a coleção de esquemas sys XML. Ele reserva esses esquemas para que eles possam ser acessados de qualquer coleção de esquemas XML criadas pelo usuário.

Confira também

Fundamentos de XQuery