Sequência e QNames (XQuery)

Aplica-se a: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 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 uma coluna xml tipada. A consulta itera em todos os <elementos de etapa> no primeiro local do workcenter.

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 do XQuery em SQL Server.

Prefixo	URI
xs	http://www.w3.org/2001/XMLSchema
xsi	http://www.w3.org/2001/XMLSchema-instance
xdt	http://www.w3.org/2004/07/xpath-datatypes
fn	http://www.w3.org/2004/07/xpath-functions
(nenhum prefixo)	urn:schemas-microsoft-com:xml-sql
sqltypes	https://schemas.microsoft.com/sqlserver/2004/sqltypes
Xml	http://www.w3.org/XML/1998/namespace
(nenhum prefixo)	https://schemas.microsoft.com/sqlserver/2004/SOAP

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

Observação

Essa implementação não dá suporte ao local prefixo, conforme descrito na especificação XQuery em http://www.w3.org/2004/07/xquery-local-functions.

Consulte Também

Fundamentos de XQuery