Tratamento de erros (XQuery)

Aplica-se: SQL Server

A especificação de W3C permite que erros de tipo ocorram estática ou dinamicamente, e define erros de tipo, dinâmicos e estáticos.

Compilação e tratamento de erros

Erros de compilação são retornados de expressões Xquery sintaticamente incorretas e instruções XML DML. A fase de compilação verifica a exatidão do tipo estático das expressões XQuery e instruções DML, e usa esquemas XML para inferências de tipo para XML digitado. Erros do tipo estático ocorrem se uma expressão puder falhar no tempo de execução em razão de uma violação de segurança de tipo. Os exemplos de erro estático são: adição de uma cadeia de caracteres a um número inteiro e consulta de um nó inexistente para dados digitados.

Como uma divergência do padrão de W3C, os erros em tempo de execução Xquery são convertidos em sequências vazias. Essas sequências podem se propagar como XML vazio ou NULL no resultado da consulta, dependendo do contexto da invocação.

Uma conversão explícita para o tipo correto permite aos usuários solucionar erros estáticos, embora erros de tempo de execução lançados sejam transformados em sequências vazias.

Erros estáticos

Os erros estáticos são retornados usando o mecanismo de erro Transact-SQL. No SQL Server, os erros do tipo XQuery são retornados estaticamente. Para obter mais informações, consulte XQuery e tipagem estática.

Erros dinâmicos

No XQuery, a maioria dos erros dinâmicos são mapeados para uma sequência vazia ("()"). Entretanto, estas são as duas exceções: condições de estouro nas funções de agregação do XQuery e validação de erros XML-DML. Observe que a maioria dos erros dinâmicos é mapeada para uma sequência vazia. Caso contrário, a execução da consulta que se beneficia dos índices XML pode causar erros inesperados. Portanto, para fornecer uma execução eficiente sem gerar erros inesperados, o Mecanismo de Banco de Dados do SQL Server mapeia erros dinâmicos para ().

Frequentemente, na situação em que o erro dinâmico aconteceria dentro de um predicado, não causar o erro não é alterar as semânticas, porque () é mapeado para False. No entanto, em alguns casos, retornando () em vez de um erro dinâmico pode causar resultados inesperados. Os exemplos a seguir ilustram isso.

Exemplo: usando a função avg () com uma cadeia de caracteres

No exemplo a seguir, a função avg é chamada para calcular a média dos três valores. Um desses valores é uma cadeia de caracteres. Em razão da instância XML nesse caso não ser digitada, todos os dados nela são de um tipo atômico não digitado. A função avg() primeiro converte esses valores em xs:double antes de calcular a média. No entanto, o valor , "Hello", não pode ser convertido em xs:double e cria um erro dinâmico. Nesse caso, em vez de retornar um erro dinâmico, a conversão de "Hello" para xs:double causa uma sequência vazia. A função avg() ignora esse valor, calcula a média dos outros dois valores e retorna 150.

DECLARE @x xml  
SET @x=N'<root xmlns:myNS="test">  
 <a>100</a>  
 <b>200</b>  
 <c>Hello</c>  
</root>'  
SELECT @x.query('avg(//*)')  

Exemplo: usando a função not

Quando você usa a função not em um predicado, por exemplo, /SomeNode[not(Expression)], e a expressão causa um erro dinâmico, uma sequência vazia será retornada em vez de um erro. Aplicar not() à sequência vazia retorna True, em vez de um erro.

Exemplo: convertendo uma cadeia de caracteres

No exemplo a seguir, a cadeia de caracteres literal "NaN" é convertida em xs:string, depois em xs:double. O resultado é um conjunto de linhas vazio. Embora a cadeia de caracteres "NaN" não possa ser convertida em xs:double com sucesso, isso não pode ser determinado até que a cadeia de caracteres seja convertida primeiro em xs:string.

DECLARE @x XML  
SET @x = ''  
SELECT @x.query(' xs:double(xs:string("NaN")) ')  
GO  

Neste exemplo, contudo, acontece um erro de tipo estático.

DECLARE @x XML  
SET @x = ''  
SELECT @x.query(' xs:double("NaN") ')  
GO  

Limitações de implementação

A função fn:error() não é suportada.

Confira também

Referência de linguagem Xquery (SQL Server)
Fundamentos de XQuery