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.
| Referência de entidade | Representa |
|---|---|
< |
< |
> |
> |
& |
& |
" |
" |
' |
' |
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, "€".
Observação
SQL Server usa o XML versão 1.0 como base para análise.
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 > 50000 and < 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.