XMLROOT

ノート:

XMLROOTファンクションは、非推奨です。これは、下位互換性を保つためにのみサポートされています。ただし、かわりにSQL/XMLファンクションXMLSERIALIZEを使用してバージョン番号を指定することをお薦めします。XMLSERIALIZEファンクションの詳細は、『Oracle XML DB開発者ガイド』を参照してください。

構文

図xmlroot.epsの説明

目的

XMLROOTでは、既存のXML値のXMLルート情報(プロローグ)のバージョンとスタンドアロンのプロパティを指定して、新しいXML値を作成できます。value_exprがすでにプロローグを持っている場合、エラーが戻されます。入力がNULLの場合、このファンクションはNULLを戻します。

戻り値は次の書式になります。

<?xml version = "version" [ STANDALONE = "{yes | no}" ]?>

最初のvalue_exprでは、XML値を指定します。この値に対してプロローグ情報を指定します。
VERSION句のvalue_exprは、有効なXMLバージョンを表す文字列である必要があります。VERSIONにNO VALUEを指定すると、バージョンはデフォルトで1.0になります。
オプションのSTANDALONE句を指定しない場合や、NO VALUEを指定した場合は、ファンクションの戻り値にスタンドアロンのプロパティは存在しません。

例

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

SELECT XMLROOT ( XMLType('<poid>143598</poid>'), VERSION '1.0', STANDALONE YES)
   AS "XMLROOT" FROM DUAL;

XMLROOT
--------------------------------------------------------------------------------
<?xml version="1.0" standalone="yes"?>
<poid>143598</poid>