XMLSERIALIZE スカラー関数

スキーマは SYSIBM です。 関数名を修飾名で指定することはできません。

CONTENT

任意の XML 値を指定でき、シリアライゼーションの結果はこの入力値に基づくことを指定します。

XML 式

データ・タイプ XML の値を戻す式を指定します。 XML シーケンス値に、属性ノードである項目を含めることはできません (SQLSTATE 2200W)。 これはシリアライゼーション・プロセスへの入力です。

AS データ・タイプ

結果タイプを指定します。 指定された結果のデータ・タイプの暗黙のまたは明示的な長さ属性は、シリアライズされた出力を収める十分な大きさがなければなりません (SQLSTATE 22001)。

VERSION '1.0'

シリアライズされた値の XML バージョンを指定します。 サポートされている唯一のバージョンは '1.0' であり、これはストリング定数として指定する必要があります (SQLSTATE 42815)。

EXCLUDING XMLDECLARATION または INCLUDING XMLDECLARATION

XML 宣言を結果に含めるかどうかを指定します。 デフォルトは EXCLUDING XMLDECLARATION です。

EXCLUDING XMLDECLARATION

XML 宣言を結果に含めないように指定します。

INCLUDING XMLDECLARATION

XML 宣言を結果に含めるように指定します。 XML 宣言は、ストリング '< ?xml version="1.0 "encoding ="UTF-8" ?>' です。

AS データ・タイプ

結果のデータ・タイプを指定します。 指定された結果のデータ・タイプの暗黙的または明示的な長さ属性には、変換された出力を収める十分な大きさがなければなりません (SQLSTATE 22001)。

xml-document 引数または xsl-stylesheet 引数のいずれかがヌルの場合、結果はヌルになります。

上記文書のいずれかを CHAR、VARCHAR、または CLOB 列に格納する際にコード・ページ変換が発生することがあります。 その場合、結果として文字が失われることがあります。

結果は、ユーザーが指定したデータ・タイプになります。 XML シーケンスは効率的に変換され、結果の XML ノードをシリアライズする前に XMLDOCUMENT を XML-expression に適用することで、単一の文書ノードを持つようになります。 XML-expression の結果が NULL になる可能性がある場合、結果も NULL になる可能性があります。 XML-expression の結果が NULL であれば、結果も NULL 値になります。