Expressões primárias (XQuery)

Aplica-se a:SQL Server

As expressões primárias do XQuery incluem literais, referências variáveis, expressões de item de contexto, construtores e chamadas de função.

Literais

Os literais do XQuery podem ser literais numéricos ou da cadeia de caracteres. Um literal da cadeia de caracteres pode incluir referências de entidade predefinidas; uma referência de entidade é uma sequência de caracteres. A sequência inicia com um E comercial que representa um único caractere, que, de outra forma, poderia ter significância sintática. A seguir, são apresentadas as referências de entidade predefinidas para XQuery.

Um literal da cadeia de caracteres também pode conter uma referência de caractere, uma referência de estilo XML para um caractere Unicode, que é identificado por seu ponto de código decimal ou hexadecimal. Por exemplo, o símbolo Euro pode ser representado pela referência de caractere, "€".

Exemplos

Os exemplos a seguir ilustram o uso de literais e também referências de entidade e caractere.

Esse código retorna um erro, pois os caracteres <' e '> têm significado especial.

DECLARE @var XML  
SET @var = ''  
SELECT @var.query(' <SalaryRange>Salary > 50000 and < 100000</SalaryRange>')  
GO  

Se, em vez disso, você usar uma referência de entidade, a consulta funcionará.

DECLARE @var XML  
SET @var = ''  
SELECT @var.query(' <SalaryRange>Salary &gt; 50000 and &lt; 100000</SalaryRange>')  
GO  

O exemplo a seguir ilustra o uso de uma referência de caractere para representar o símbolo de Euro.

DECLARE @var XML  
SET @var = ''  
SELECT @var.query(' <a>€12.50</a>')  

Este é o resultado.

<a>€12.50</a>

No exemplo a seguir, a consulta é delimitada por apóstrofos. Portanto, o apóstrofo no valor da cadeia de caracteres é representado por dois apóstrofos adjacentes.

DECLARE @var XML  
SET @var = ''  
SELECT @var.query('<a>I don''t know</a>')  
Go  

Este é o resultado.

<a>I don't know</a>

As funções boolianas internas, true() e false(), podem ser usadas para representar valores boolianos, conforme mostrado no exemplo a seguir.

DECLARE @var XML  
SET @var = ''  
SELECT @var.query('<a>{true()}</a>')  
GO  

O construtor de elemento direto especifica uma expressão em colchetes. Isso é substituído por seu valor no XML resultante.

Este é o resultado.

<a>true</a>

Referências variáveis

Uma referência variável no XQuery é um QName precedido por um sinal de $. Essa implementação oferece suporte somente a referências variáveis sem-prefixo. Por exemplo, a consulta a seguir define a variável $i na expressão FLWOR.

DECLARE @var XML  
SET @var = '<root>1</root>'  
SELECT @var.query('  
 for $i in /root return data($i)')  
GO  

A consulta a seguir não funcionará, pois um prefixo de namespace é adicionado ao nome da variável.

DECLARE @var XML  
SET @var = '<root>1</root>'  
SELECT @var.query('  
DECLARE namespace x="https://X";  
for $x:i in /root return data($x:i)')  
GO  

Você pode usar a função de extensão sql:variable() para se referir a variáveis SQL, conforme mostrado na consulta a seguir.

DECLARE @price money  
SET @price=2500  
DECLARE @x xml  
SET @x = ''  
SELECT @x.query('<value>{sql:variable("@price") }</value>')  

Este é o resultado.

<value>2500</value>

Limitações de implementação

Estas são as limitações de implementação:

• Não é oferecido suporte a variáveis com prefixos de namespace.

• Não é oferecido suporte à importação de módulo.

• Não é oferecido suporte a declarações de variáveis externas. Uma solução para isso é usar a função sql:variable().

Expressões de item de contexto

O item de contexto é o item sendo processado atualmente no contexto de uma expressão de caminho. Ele é inicializado em uma instância de tipo de dados XML não NULL com o nó de documento. Ele também pode ser alterado pelo método nodes(), no contexto de expressões XPath ou os predicados [].

O item de contexto é retornado por uma expressão que contém um ponto (.). Por exemplo, a consulta a seguir avalia cada elemento <a> quanto à presença do atributo .attr Se o atributo estiver presente, o elemento será retornado. Observe que a condição no predicado especifica que o nó de contexto é especificado por um único ponto.

DECLARE @var XML  
SET @var = '<ROOT>  
<a>1</a>  
<a attr="1">2</a>  
</ROOT>'  
SELECT @var.query('/ROOT[1]/a[./@attr]')  

Este é o resultado.

<a attr="1">2</a>

Chamadas de função

Você pode chamar funções XQuery internas e as funções SQL Server sql:variable() e sql:column(). Para obter uma lista de funções implementadas, consulte Funções XQuery em relação ao tipo de dados xml.

Limitações de implementação

Estas são as limitações de implementação:

• Não é oferecido suporte à declaração de função no prólogo do XQuery.

• Não é oferecido suporte à importação de função.

Consulte Também

Construção XML (XQuery)