出力のフィルタリングのための 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 文書ではなく単一値が戻されます。