出力のフィルタリングのための XPath 式

XPath 式を使用して、GET_CONFIG、GET_MESSAGE、および GET_SYSTEM_INFO ストアード・プロシージャーから戻される XML 出力をフィルタリングできます。

出力をフィルタリングするには、ストアード・プロシージャーの xml_filter パラメーターに有効な XPath 照会ストリングを指定します。

指定する XPath 式には次の制約事項が適用されます。

  • XPath 式は単一値を参照する必要がある。
  • XPath 式は常にルート・ノードからの絶対でなければならない。 例えば、有効なパス式は /、nodename、.、および .. です。無効なパス式は // と @ です。
  • 使用可能な述部は [path='value'] および [n] のみである。
  • 有効な軸は following-sibling のみである。
  • XPath 式は、following-sibling::string、following-sibling:: data、following-sibling::date、following-sibling::real、または following-sibling::integer のいずれかで終わる必要がある。また、必要に応じて 述部 [1] が追加される。
  • 軸が XPath 式の終わりにある場合を除き、軸の後には ::dict、::string、::data、::date, ::real、または ::integer が続く必要がある。また、必要に応じて述部 [1] が付加される。
  • サポートされている XPath 演算子は = のみである。
  • XPath 式には、関数、名前空間、処理命令、およびコメントを含めることはできない。
ヒント: ストアード・プロシージャーがコンプリート・モードで実行されている場合は、フィルター処理を適用しないでください。フィルター処理を適用すると、SQLCODE (+20458) が発生します。

例: XML 出力文書から Data Server Product Version キーの値を選択する XPath 式を以下に示します。

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

Data Server Product Version の値が 9.1.5 の場合、このストアード・プロシージャーは xml_output パラメーターにストリング 9.1.5 を戻します。したがって、このストアード・プロシージャー呼び出しでは XML 文書ではなく単一値が戻されます。