DBMS_XMLDOMシステムパッケージは、XMLTypeオブジェクトにアクセスし、ドキュメントオブジェクトモデル(DOM)を実装するために使用されます。DOMは、HTMLおよびXMLドキュメント向けのアプリケーションプログラミングインターフェース(API)です。DOMは、ドキュメントの論理構造と、ドキュメントへのアクセスおよび操作方法を定義します。
DOM仕様では、「ドキュメント」は広義に使用されています。XMLは、さまざまなシステムに保存される多様な情報を表現できます。これらの情報は従来はデータと見なされることが多いですが、XMLでは依然としてドキュメント形式で提示されます。
機能の適用範囲
この内容はOceanBaseデータベースEnterprise Editionにのみ適用されます。OceanBaseデータベースCommunity EditionはMySQLモードのみを提供します。
説明
V4.4.2バージョンでは、このシステムパッケージはOceanBaseデータベースV4.4.2 BP2バージョンから導入されました。
DBMS_XMLDOM権限の説明
DBMS_XMLDOMシステムパッケージのEXECUTE権限はPUBLICに付与されています。現在のユーザーは、このパッケージ内のサブプログラムを使用する権限を持っています。
DBMS_XMLDOMの使用方法
DBMS_XMLPARSERからDBMS_XMLDOM.DOMDOCUMENTハンドルを取得した後、このパッケージのサブプログラムを使用してDOMツリーを走査し、要素とノードの値を読み取ります。完全な解析と解放のプロセスについては、DBMS_XMLPARSERの使用方法を参照してください。
典型的な処理フローは以下のとおりです:
- DBMS_XMLPARSERの使用方法に従って解析を完了し、
DBMS_XMLDOM.DOMDOCUMENTハンドルを取得します。 GETELEMENTSBYTAGNAME、ITEM、GETLENGTHなどを使用してノードを走査します。GETNODEVALUEを使用してノードの値を読み取ります。FREEDOCUMENTを呼び出してドキュメントリソースを解放します。
OceanBaseデータベースの現在のバージョンでサポートされているDBMS_XMLDOMサブプログラムは、主に読み取り専用の走査とクエリです。詳細については、以下のDBMS_XMLDOMサブプログラムの概要を参照してください。
XMLTypeの作成と変換については、XMLTypeの概要を参照してください。
DBMS_XMLDOMサブプログラムの概要
次の表は、OceanBaseデータベースの現在のバージョンでサポートされているDBMS_XMLDOMサブプログラムとその簡潔な説明です。
サブプログラム |
説明 |
|---|---|
| DOMDOCUMENT | XMLドキュメントを識別するためのオブジェクト |
| DOMNODE | DOMノードを識別するためのオブジェクト |
| DOMNODELIST | ノードリストを識別するためのオブジェクト |
| FREEDOCUMENT | DOMドキュメントを解放するためのメソッド |
| GETCHILDNODES | 子ノードのリストを取得するメソッド |
| GETELEMENTSBYTAGNAME | タグ名によって要素を取得するメソッド (name='*' は任意の要素に一致します) |
| GETLENGTH | ノード数を取得するメソッド |
| GETNODEVALUE | ノードの値を取得するメソッド |
| ITEM | 索引によってノードを取得するメソッド |