Expressões XPath para filtrar saída

É possível usar uma expressão XPath para filtrar a saída XML retornada pelos procedimentos armazenados GET_CONFIG, GET_MESSAGE e GET_SYSTEM_INFO.

Para filtrar a saída, especifique uma sequência de consultas XPath válida no parâmetro xml_filter do procedimento armazenado.

As restrições a seguir se aplicam à expressão XPath especificada:

  • A expressão XPath deve referenciar um valor único.
  • A expressão XPath deve ser sempre absoluta a partir do nó raiz. Por exemplo, as expressões de caminho a seguir são permitidas: /, nodename, . e ... As expressões a seguir não são permitidas: // e @
  • Os únicos predicados permitidos são [path='value'] e [n].
  • O único eixo permitido é following-sibling.
  • A expressão XPath deve terminar com um dos seguintes e, se necessário, ser anexada ao predicado [1]: following-sibling::string, following-sibling:: data, following-sibling::date, following-sibling::real ou following-sibling::integer.
  • A menos que o eixo esteja localizado no final da expressão XPath, ele deve ser seguido por um ::dict, ::string, ::data, ::date, ::real ou ::integer e, se necessário, ser anexado ao predicado [1].
  • O único operador XPath suportado é =.
  • A expressão XPath não pode conter uma função, um namespace, uma instrução de processamento ou um comentário.
Dica: Se o procedimento armazenado operar no modo completo, não aplique filtragem, caso contrário um SQLCODE (+20458) será mostrado.

Exemplo: a expressão XPath a seguir seleciona o valor para a chave Data Server Product Version a partir de um documento de saída XML:

 /plist/dict/key[.='Data Server Product Version']/following-sibling::string[1]

O procedimento armazenado retornará a sequência 9.1.5 no parâmetro xml_output se o valor do Data Server Product Version for 9.1.5. Portanto, a chamada de procedimento armazenado retorna um valor único em vez de um documento XML.