XQuery の結果を表として戻す XMLTABLE 関数

XMLTABLE SQL/XML 関数は、XQuery 式の評価から表を戻します。

XQuery 式は、通常、値をシーケンスとして戻します。ただし、XMLTABLE を使用すると、XQuery 式を実行して値を表として戻すことができます。 戻される表には、XML データ・タイプを含む、あらゆる SQL データ・タイプの列が含まれます。

XMLTABLE で指定された 行 XQuery 式に変数を渡すことができます。 行 XQuery 式の結果は、戻される表の行を定義するために使用する XML 文書の一部分を定義します。XMLTABLE 関数の COLUMNS 節に 列 XQuery 式を指定して、結果の表の列値を生成します。COLUMNS 文節では、列名、データ・タイプ、および列値が生成される方法を指定して、列の特性を定義します。 あるいは、COLUMNS 文節を省略して、Db2® によって単一の名前がない XML 列が生成されるようにすることもできます。

XMLTABLE の最初の引数として XMLNAMESPACES 関数を指定し、XMLTABLE 関数におけるすべての XQuery 式の XML ネーム・スペースを指定することができます。 個々の XQuery 式におけるネーム・スペース宣言は、XMLNAMESPACES 引数をオーバーライドします。

XMLTABLE の PATH 文節で指定する列 XQuery 式を通して、結果表の列の内容を指定することができます。PATH 文節が指定されていない場合、Db2 は PATH 引数として結果表の列名を使用します。例えば、結果表列の名前が @partNum で、入力 XML 文書に partNum という属性がなければならない場合、 結果表の列値は partNum 属性の値になります。

結果表の列を定義する列 XQuery 式が空のシーケンスを戻すと、XMLTABLE は結果表の列に NULL 値を戻します。XMLTABLE では、NULL 値の代わりにデフォルト値を指定できます。 デフォルト値は、列定義で DEFAULT 文節を指定することにより指定できます。

XMLTABLE によって生成される行ごとにシーケンス番号を生成したい場合は、 FOR ORDINALITY 文節に列定義を組み込むことができます。FOR ORDINALITY 文節を指定すると、 XMLTABLE は 1 から順に値が付いた列を生成します。単一の文書が複数の行を生成する場合、シーケンス番号は 1 ずつ増えていきます。 例えば、XML 文書が 3 つの結果表の行を生成する場合、これらの行のシーケンス番号は 1、2、3 となります。

重要: XMLTABLE の PATH オプションに指定された列 XQuery 式が複数の項目の シーケンスを戻す場合、結果表の列のデータ・タイプは XML でなければなりません。