Diretrizes para usar métodos de tipo de dados xml
Este tópico descreve as diretrizes para usar os métodos de tipo de dados xml.
A instrução PRINT
Os métodos de tipo de dados xml não podem ser usados na instrução PRINT como mostra o exemplo a seguir. Os métodos de tipo de dados xml são tratados como subconsultas, as quais não são permitidas na instrução PRINT. Como resultado, o exemplo seguinte retorna um erro:
DECLARE @x xml
SET @x = '<root>Hello</root>'
PRINT @x.value('/root[1]', 'varchar(20)') -- will not work because this is treated as a subquery (select top 1 col from table)
Uma das soluções é primeiramente atribuir o resultado do método valor() a uma variável de tipo xml e, em seguida, especificar a variável na consulta.
DECLARE @x xml
DECLARE @c varchar(max)
SET @x = '<root>Hello</root>'
SET @c = @x.value('/root[1]', 'varchar(11)')
PRINT @c
A Cláusula GROUP BY
Os métodos de tipo de dados xml são tratados internamente como subconsultas. Como a GROUP BY exige um valor escalar e não permite agregações e subconsultas, não é possível especificar os métodos de tipo de dados xml na cláusula GROUP BY. Uma solução é chamar uma função definida pelo usuário que usa métodos XML internamente.
Relatório de erros
Ao reportar erros, os métodos de tipo de dados xml geram um único erro no seguinte formato:
Msg errorNumber, Level levelNumber, State stateNumber:
XQuery [database.table.method]: description_of_error
Por exemplo:
Msg 2396, Level 16, State 1:
XQuery [xmldb_test.xmlcol.query()]: Attribute may not appear outside of an element
Verificações de singleton
As etapas de local, os parâmetros de função e os operadores que exigem singletons retornarão um erro se o compilador não puder determinar se um singleton está garantido no momento da execução. Este problema costuma acontecer com dados não digitados. Por exemplo, a pesquisa de um atributo requer um elemento pai de singleton. Um ordinal que selecione um único nó pai é suficiente. A avaliação de um nó () combinaçãode valor () para extrair valores de atributo pode não requerer a especificação ordinal. Isso é demonstrado no próximo exemplo.
Exemplo: Singleton conhecido
Neste exemplo, o método de nós () gera uma linha separada para cada elemento <book>. O método do valor() que é avaliado em um nó <book> extrai o valor de @genre e, sendo um atributo, é um singleton.
SELECT nref.value('@genre', 'varchar(max)') LastName
FROM T CROSS APPLY xCol.nodes('//book') AS R(nref)
O esquema de XML é usado para verificação de tipo de XML digitado. Se um nó é especificado como um singleton no esquema XML, o compilador usa essa informação e não ocorre nenhum erro. Caso contrário, um ordinal que selecione um único nó é obrigatório. Particularmente, o uso de eixo descendente ou independente (//), como em /livro//título, desobriga a inferência de cardinalidade de singleton do elemento <título>, ainda que o esquema XML o especifique dessa forma. Portanto, você deve reescrevê-lo como (/livro//título)[1].
É importante ficar atento à diferença entre //nome[1] e (//nome)[1] para a verificação de tipo. O primeiro retorna uma seqüência de nós de <nome> em que cada nó é o <nome> na extremidade mais à esquerda entre seus irmãos. O segundo retorna o primeiro nó de singleton de <nome> em ordem de documento na instância de XML.
Exemplo: Usando valor ()
A consulta a seguir em uma coluna XML não digitada resulta em um erro estático e de compilação. Isso ocorre porque o valor() espera um nó de singleton como o primeiro argumento e o compilador não pode determinar se apenas um nó de <sobrenome> ocorrerá no momento da execução:
SELECT xCol.value('//author/last-name', 'nvarchar(50)') LastName
FROM T
A seguir temos uma solução a ser considerada:
SELECT xCol.value('//author/last-name[1]', 'nvarchar(50)') LastName
FROM T
Porém, a solução não resolve o erro, porque é possível a ocorrência de múltiplos nós <author> em cada instância de XML. A nova gravação a seguir funciona:
SELECT xCol.value('(//author/last-name/text())[1]', 'nvarchar(50)') LastName
FROM T
Esta consulta retorna o valor do primeiro elemento <last-name> em cada instância de XML.