DBMS_XMLPARSER システムパッケージは、CLOB または VARCHAR2 からXMLテキストを解析し、DBMS_XMLDOM がアクセス可能なDOMツリーを構築するために使用されます。
機能の適用範囲
この内容はOceanBaseデータベースEnterprise版にのみ適用されます。OceanBaseデータベースCommunity版はMySQLモードのみを提供します。
説明
V4.4.2系では、このシステムパッケージはOceanBaseデータベースV4.4.2 BP2から導入されました。
DBMS_XMLPARSER権限の説明
DBMS_XMLPARSER システムパッケージの EXECUTE 権限は PUBLIC に付与されています。現在のユーザーは、このパッケージ内のサブプログラムを使用する権限を持っています。
DBMS_XMLPARSERの使用方法
DBMS_XMLPARSER は、CLOB または VARCHAR2 内のXMLを読み取り、解析してDOMツリーを構築します。解析が成功した場合は、GETDOCUMENT を使用して DOMDOCUMENT ハンドルを取得し、その後 DBMS_XMLDOM のサブプログラムを使用してノードを走査し、要素とノード値を読み取ります。解析に失敗した場合は、アプリケーションエラーがスローされます。
一般的な処理の流れは次のとおりです。
NEWPARSERを呼び出してパーサー(Parserハンドル)を作成します。PARSECLOBを呼び出してCLOB内のXMLテキストを解析するか、PARSEBUFFERを呼び出してVARCHAR2内の短いXMLテキストを解析します。GETDOCUMENTを呼び出して、DBMS_XMLDOM.DOMDOCUMENTハンドルを取得します。- DBMS_XMLDOM 関連のサブプログラムを使用して、解析結果にアクセスします。
説明
現在のバージョンでは、PARSECLOB を使用して CLOB 内のXMLを解析し、PARSEBUFFER(V4.4.2 BP3以降でサポート)を使用して VARCHAR2 の短いXMLテキストを解析し、DOMインターフェースからアクセスできる解析ツリーを構築します。ファイルパスやURLからの解析、DTD検証、エラーログなどの機能は、現在のサポート範囲外です。
XMLType の作成と変換については、XMLTypeの概要を参照してください。
DBMS_XMLPARSERサブプログラムの概要
次の表は、OceanBaseデータベースの現在のバージョンでサポートされている DBMS_XMLPARSER サブプログラムとその簡単な説明です。
サブプログラム |
説明 |
|---|---|
| PARSER | パーサーハンドル |
| NEWPARSER | パーサーの作成 |
| PARSECLOB | CLOB 内のXMLを解析 |
| PARSEBUFFER | VARCHAR2 内のXMLを解析 |
| GETDOCUMENT | DBMS_XMLDOM.DOMDOCUMENT ハンドルの取得 |
| FREEPARSER | パーサーの解放 |