XMLSERIALIZE

構文

図xmlserialize.gifの説明

用途

XMLSerializeは、value_exprの内容を含む文字列またはLOBを作成します。

• DOCUMENTを指定する場合、value_exprは有効なXML文書である必要があります。

• CONTENTを指定する場合、value_exprは単一ルートのXML文書である必要はありません。ただし、有効なXMLコンテンツである必要があります。

• datatypeの指定には、文字列型(VARCHAR2またはVARCHARは使用可能、NVARCHAR2は使用不可)、BLOBまたはCLOBを使用できます。デフォルトはCLOBです。

• datatypeがBLOBの場合は、ENCODING句を指定して、指定したエンコーディングをプロローグで使用できます。xml_encoding_specは、XMLエンコーディング宣言(encoding="...")です。

• XML宣言でstring_literalとして指定したバージョン(<?xml version="..." ...?>)を使用するには、VERSION句を指定します。

• 意味のないすべての空白を出力から取り除くには、NO INDENTを指定します。出力をN個の空白の相対インデントを使用して出力整形するには、INDENT SIZE = Nを指定します。Nは整数です。Nが0の場合、出力整形によって各要素の後に改行文字が挿入され、各要素は独自の行に配置されますが、その他の意味のないすべての空白は出力で省略されます。SIZEを指定せずにINDENTを指定すると、2個の空白インデントが使用されます。この句を指定しない場合、動作(出力整形されるかどうか)は予測不能です。

• HIDE DEFAULTSおよびSHOW DEFAULTSは、XML Schemaに基づくデータにのみ適用されます。SHOW DEFAULTSを指定した場合、XML Shemaでデフォルト値が定義されているオプションの要素や属性が入力データに存在しないと、それらの要素や属性はそのデフォルト値とともに出力に含められます。HIDE DEFAULTSを指定した場合、このような要素や属性は出力に含められません。HIDE DEFAULTSがデフォルトの動作です。

関連項目: このファンクションの詳細は、『Oracle XML DB開発者ガイド』を参照してください。

例

次の文は、DUAL表を使用して、XMLSerializeの構文を示します。

SELECT XMLSERIALIZE(CONTENT XMLTYPE('<Owner>Grandco</Owner>')) AS xmlserialize_doc
   FROM DUAL;

XMLSERIALIZE_DOC
----------------
<Owner>Grandco</Owner>