# DBE_XML
DBE_XML支持的所有接口请参见[表1]：
 表1DBE_XML接口参数说明 
| 接口名称                                                                                                                      | 描述                                             |
|:---|:---|
| [DBE_XML.XML_FREE_PARSER]                   | 释放PARSER。                                      |
| [DBE_XML.XML_PARSER_GET_DOC]                   | 获取解析的document节点。                               |
| [DBE_XML.XML_GET_VALIDATION_MODE]            | 获取validate属性。                                  |
| [DBE_XML.XML_NEW_PARSER]                      | 新建PARSER实例。                                    |
| [DBE_XML.XML_PARSE_BUFFER]                   | 解析VARCHAR字符串。                                  |
| [DBE_XML.XML_PARSE_CLOB]                       | 解析CLOB字符串。                                     |
| [DBE_XML.XML_SET_VALIDATION_MODE]             | 设置validate属性。                                  |
| [DBE_XML.XML_DOM_APPEND_CHILD]                 | 将newchild node添加到parent(n)节点最后面,并返回新添加的Node节点。 |
| [DBE_XML.XML_DOM_CREATE_ELEMENT]            | 返回创建指定名称的DOMELEMENT对象。                         |
| [DBE_XML.XML_DOM_CREATE_ELEMENT_NS]        | 返回创建指定名称和命名空间的DOMELEMENT对象。                    |
| [DBE_XML.XML_DOM_CREATE_TEXT_NODE]           | 创建并返回DOMTEXT对象。                                |
| [DBE_XML.XML_DOM_FREE_DOCUMENT]               | 将指定的xmldom类型对象释放。                              |
| [DBE_XML.XML_DOM_FREE_ELEMENT]                | 将指定的xmldom类型对象释放。                              |
| [DBE_XML.XML_DOM_FREE_NODE]                   | 释放DOMNODE节点。                                   |
| [DBE_XML.XML_DOM_FREE_NODELIST]                 | 释放DOMNODELIST节点。                               |
| [DBE_XML.XML_DOM_GET_ATTRIBUTE]              | 获取指定的xmldom类型对象的属性。                            |
| [DBE_XML.XML_DOM_GET_ATTRIBUTES]             | 将DOMNode节点属性值作为map返回。                          |
| [DBE_XML.XML_DOM_GET_CHILD_NODES]           | 将节点下的若干子节点转换成节点列表。                             |
| [DBE_XML.XML_DOM_GET_CHILDREN_BY_TAGNAME]   | 获取指定的xmldom类型对象指定子节点组成的列表。                     |
| [DBE_XML.XML_DOM_GET_CHILDREN_BY_TAGNAME_NS] | 获取指定的xmldom类型对象指定命名空间指定子节点组成的列表。               |
| [DBE_XML.XML_DOM_GET_DOCUMENT_ELEMENT]        | 返回指定DOCUMENT的首个子节点。                            |
| [DBE_XML.XML_DOM_GET_FIRST_CHILD]           | 返回node节点的第一个子节点。                               |
| [DBE_XML.XML_DOM_GET_LAST_CHILD]            | 返回node节点的最后一个子节点。                              |
| [DBE_XML.XML_DOM_GET_LENGTH]                | 根据类型节点中内容返回节点数。                                |
| [DBE_XML.XML_DOM_GET_LOCALNAME]            | 返回给定对象的本地名称。                                   |
| [DBE_XML.XML_DOM_GET_NAMED_ITEM]             | 检索由名称指定的节点。                                    |
| [DBE_XML.XML_DOM_GET_NAMED_ITEM_NS]         | 检索由名称和命名空间指定的节点。                               |
| [DBE_XML.XML_DOM_GET_NEXT_SIBLING]           | 返回该节点的下一个节点。                                   |
| [DBE_XML.XML_DOM_GET_NODE_NAME]               | 返回节点的名称。                                       |
| [DBE_XML.XML_DOM_GET_NODE_TYPE]                | 返回节点的类型。                                       |
| [DBE_XML.XML_DOM_GET_NODE_VALUE]              | 返回NODE节点的值。                                    |
| [DBE_XML.XML_DOM_GET_PARENT_NODE]            | 返回给定NODE节点的父节点。                                |
| [DBE_XML.XML_DOM_GET_TAGNAME]                | 获取指定的xmldom类型对象的标签名。                           |
| [DBE_XML.XML_DOM_HAS_CHILD_NODES]          | 检查DOMNODE对象是否拥有任一子节点。                          |
| [DBE_XML.XML_DOM_IMPORT_NODE]                 | 该函数将节点复制到另一节点中，并将复制后的节点挂载到指定document中。         |
| [DBE_XML.XML_DOM_IS_NULL]                      | 判断给定对象是否为NULL。                                 |
| [DBE_XML.XML_DOM_ITEM]                       | 根据索引返回list或map中与索引对应的元素。                       |
| [DBE_XML.XML_DOM_MAKE_ELEMENT]                | 返回转换后的DOMELEMENT对象。                            |
| [DBE_XML.XML_DOM_MAKENODE]                     | 将给定对象强制转换为DOMNODE类型。                           |
| [DBE_XML.XML_DOM_NEW_DOM_DOCUMENT_EMPTY]      | 返回新的DOMDOCUMENT对象。                             |
| [DBE_XML.XML_DOM_NEW_DOM_DOCUMENT_CLOB]      | 返回从指定的CLOB类型创建的新DOMDOCUMENT实例对象。               |
| [DBE_XML.XML_DOM_NEW_DOCUMENT_XMLTYPE]        | 返回从指定的XMLType类型创建的新DOMDOCUMENT实例对象。            |
| [DBE_XML.XML_DOM_SET_ATTRIBUTE]               | 设置指定的xmldom类型对象的属性。                            |
| [DBE_XML.XML_DOM_SET_CHARSET]                 | 设置DOM设置DOMDOCUMENT的CHATSET字符集。                 |
| [DBE_XML.XML_DOM_SET_DOCTYPE]                 | 设置DOMDOCUMENT的外部DTD。                           |
| [DBE_XML.XML_DOM_SET_NODE_VALUE]             | 此函数用于向DOMNODE对象中设置节点的值。                        |
| [DBE_XML.XML_DOM_WRITE_TO_BUFFER_DOC]         | 将给定的DOMDOCUMENT类型对象写入缓冲区。                      |
| [DBE_XML.XML_DOM_WRITE_TO_BUFFER_NODE]       | 将给定的DOMNODE类型对象写入缓冲区。                          |
| [DBE_XML.XML_DOM_WRITE_TO_CLOB_DOC]          | 将给定的DOMDOCUMENT类型对象写入Clob。                     |
| [DBE_XML.XML_DOM_WRITE_TO_CLOB_NODE]        | 将给定的DOMNODE类型对象写入Clob。                         |
| [DBE_XML.XML_DOM_WRITE_TO_FILE_DOC]          | 使用数据库字符集将XML节点写入指定文件。                          |
| [DBE_XML.XML_DOM_WRITE_TO_FILE_NODE]         | 使用数据库字符集将XML节点写入指定文件。                          |
| [DBE_XML.XML_DOM_GET_SESSION_TREE_NUM]         | 显示当前session中所有类型的dom树的数量。                      |
| [DBE_XML.XML_DOM_GET_DOC_TREES_INFO]          | 显示document类型的dom树的内存占用、节点数量等统计信息。              |
| [DBE_XML.XML_DOM_GET_DETAIL_DOC_TREE_INFO]     | 显示特定的document变量的各类型节点数量。                       |
   
- DBE_XML.XML_FREE_PARSER
  释放给定的PARSER对象。
  DBE_XML.XML_FREE_PARSER的存储过程原型为：
  ```
  DBE_XML.XML_FREE_PARSER(
  id IN RAW(13))
  returns VOID;
  ```
  表2DBE_XML.XML_FREE_PARSER接口参数说明 
  | 参数 | 类型      | 入参/出参 | 是否可以为空 | 描述             |
  |:---|:---|:---|:---|:---|
  | id | RAW(13) | IN    | 是      | 指定的parser类型对象。 |
     
  

- DBE_XML.XML_PARSER_GET_DOC
  XML_PARSER_GET_DOC返回PARSER构建的DOM树文档的根节点。
  DBE_XML.XML_PARSER_GET_DOC的函数原型为：
  ```
  DBE_XML.XML_PARSER_GET_DOC(
  id IN RAW(13))
  returns RAW(13);
  ```
  表3DBE_XML.XML_PARSER_GET_DOC接口参数说明 
  | 参数 | 类型      | 入参/出参 | 是否可以为空 | 描述             |
  |:---|:---|:---|:---|:---|
  | id | RAW(13) | IN    | 是      | 指定的parser类型对象。 |
     
  ![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
  - DBE_XML.XML_PARSER_GET_DOC函数传空，返回NULL。
  
  - DBE_XML.XML_PARSER_GET_DOC函数传入的parser还没有解析文档，返回NULL。
    

- DBE_XML.XML_GET_VALIDATION_MODE
  获取给定Parser的解析验证模式。如果DTD验证开启返回TRUE，否则返回FALSE。
  DBE_XML.XML_GET_VALIDATION_MODE的函数原型为：
  ```
  DBE_XML.XML_GET_VALIDATION_MODE(
  id RAW(13))
  returns BOOL;
  ```
  表4DBE_XML.XML_GET_VALIDATION_MODE接口参数说明 
  | 参数 | 类型      | 入参/出参 | 是否可以为空 | 描述             |
  |:---|:---|:---|:---|:---|
  | id | RAW(13) | IN    | 是      | 指定的parser类型对象。 |
     
  

- DBE_XML.XML_NEW_PARSER
  新建Parser对象，返回一个新的解析器实例。
  DBE_XML.XML_NEW_PARSER的函数原型为：
  ```
  DBE_XML.XML_NEW_PARSER()
  RETURNS RAW(13);
  ```
  

- DBE_XML.XML_PARSE_BUFFER
  XML_PARSE_BUFFER解析存储在字符串中的XML文档。
  DBE_XML.XML_PARSE_BUFFER的存储过程原型为：
  ```
  DBE_XML.XML_PARSE_BUFFER(
  id RAW(13),
  xmlstr VARCHAR2)
  RETURNS VOID;
  ```
  表5DBE_XML.XML_PARSE_BUFFER接口参数说明 
  | 参数     | 类型       | 入参/出参 | 是否可以为空 | 描述             |
  |:---|:---|:---|:---|:---|
  | id     | RAW(13)  | IN    | 是      | 指定的parser类型对象。 |
  | xmlstr | VARCHAR2 | IN    | 否      | 存储XML文档的字符串。   |
     
  ![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
  - xml_parse_buffer函数能够解析的字符串最大长度为32767，超过最大长度解析报错。
  
  - 与ORA数据库差异：字符串encoding只支持UTF-8；version字段只支持1.0，1.0-1.9解析警告但正常执行，1.9以上报错。
  
  
  
  - 与ORA数据库DTD校验差异：
    - !ATTLIST to type (CHECK\|check\|Check) "Ch..."将报错，因默认值"Ch..."不属于括号中枚举值，而ORA数据库不报错。
    
    - \<!ENTITY baidu "www.baidu.com"\>...... \&Baidu;\&writer将报错，因区分字母大小写，Baidu无法与baidu对应，而ORA数据库不报错。
     
  
  - 与ORA数据库命名空间校验差异：解析未声明的命名空间标签正常执行，而ORA数据库会报错。
  
  - 与ORA数据库xml预定义实体解析差异：'\&quot;会被解析转义为字符'"，而ORA数据库中预定义实体统一都没有转义为字符。
    

- DBE_XML.XML_PARSE_CLOB
  XML_PARSE_CLOB解析存储在Clob中的XML文档。
  DBE_XML.XML_PARSE_CLOB的存储过程原型为：
  ```
  DBE_XML.XML_PARSE_CLOB(
  id IN RAW(13),
  doc IN CLOB)
  returns VOID；
  ```
  表6DBE_XML.XML_PARSE_CLOB接口参数说明 
  | 参数  | 类型      | 入参/出参 | 是否可以为空 | 描述             |
  |:---|:---|:---|:---|:---|
  | id  | RAW(13) | IN    | 是      | 指定的parser类型对象。 |
  | doc | CLOB    | IN    | 否      | 存储XML文档的字符串。   |
     
  ![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
  - xml_parse_clob不支持解析大于1GB的CLOB。
  
  - 与ORA数据库差异：字符串encoding只支持UTF-8；version字段只支持1.0，1.0-1.9解析警告但正常执行，1.9以上报错。
  
  - 与ORA数据库DTD校验差异：
    - !ATTLIST to type (CHECK\|check\|Check) "Ch..."将报错，因默认值"Ch..."不属于括号中枚举值，而ORA数据库不报错。
    
    - \<!ENTITY baidu "www.baidu.com"\>...... \&Baidu;\&writer将报错，因区分字母大小写，Baidu无法与baidu对应，而ORA数据库不报错。
     
  
  - 与ORA数据库命名空间校验差异：解析未声明的命名空间标签正常执行，而ORA数据库会报错。
  
  - 与ORA数据库XML预定义实体解析差异：'\&quot;会被解析转义为字符'"，而ORA数据库中预定义实体统一都没有为字符。
    

- DBE_XML.XML_SET_VALIDATION_MODE
  设置给定Parser的解析验证模式。
  DBE_XML.XML_SET_VALIDATION_MODE的存储过程原型为：
  ```
  DBE_XML.XML_SET_VALIDATION_MODE(
  id RAW(13), 
  validate BOOLEAN)
  returns VOID;
  ```
  表7DBE_XML.XML_SET_VALIDATION_MODE接口参数说明 
  | 参数       | 类型      | 入参/出参 | 是否可以为空 | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                         |
  |:---|:---|:---|:---|:---|
  | id       | RAW(13) | IN    | 是      | 指定的parser类型对象                                                                                                                                                                                                                                                                                                                                                                                                                              |
  | validate | BOOLEAN | IN    | 是      | 要设置的模式： - TRUE：开启DTD验证。  - FALSE：不开启验证。   |
     
  ![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
  - DBE_XML.XML_SET_VALIDATION_MODE函数validate传入为空，不改变parser的解析验证模式。
  
  - parser初始化默认为开启DTD验证模式。
    

- DBE_XML.XML_DOM_APPEND_CHILD
  将newchild node添加到parent(n)节点最后面,并返回新添加的Node节点。
  DBE_XML.XML_DOM_APPEND_CHILD的存储过程原型为：
  ```
  DBE_XML.XML_DOM_APPEND_CHILD(
      parentId IN RAW(13),
      childId IN RAW(13)
  )
  RETURNS RAW(13);
  ```
  表8DBE_XML.XML_DOM_APPEND_CHILD接口参数说明 
  | 参数       | 类型      | 入参/出参 | 是否可以为空 | 描述            |
  |:---|:---|:---|:---|:---|
  | parentId | RAW(13) | IN    | 否      | 指定的xmldom类型对象 |
  | childId  | RAW(13) | IN    | 否      | 指定的xmldom类型对象 |
     
  
- DBE_XML.XML_DOM_CREATE_ELEMENT
  返回创建指定名称的DOMELEMENT对象。
  DBE_XML.XML_DOM_CREATE_ELEMENT的函数原型为：
  ```
  DBE_XML.XML_DOM_CREATE_ELEMENT(
      id IN RAW(13),
      tagname IN VARCHAR2
  )
  RETURNS RAW(13);
  ```
  表9DBE_XML.XML_DOM_CREATE_ELEMENT接口参数说明 
  | 参数      | 类型       | 入参/出参 | 是否可以为空 | 描述              |
  |:---|:---|:---|:---|:---|
  | id      | RAW(13)  | IN    | 否      | 指定的xmldom类型对象   |
  | tagname | VARCHAR2 | IN    | 否      | 新建的DOMELEMENT名称 |
     
  
- DBE_XML.XML_DOM_CREATE_ELEMENT_NS
  返回创建指定名称和命名空间的DOMELEMENT对象。
  DBE_XML.XML_DOM_CREATE_ELEMENT_NS的函数原型为：
  ```
  DBE_XML.XML_DOM_CREATE_ELEMENT_NS(
      id IN RAW(13),
      tagname IN VARCHAR2,
      ns IN VARCHAR2
  )
  RETURNS RAW(13);
  ```
  表10DBE_XML.XML_DOM_CREATE_ELEMENT_NS接口参数说明 
  | 参数      | 类型       | 入参/出参 | 是否可以为空 | 描述              |
  |:---|:---|:---|:---|:---|
  | id      | RAW(13)  | IN    | 否      | 指定的xmldom类型对象   |
  | tagname | VARCHAR2 | IN    | 否      | 新建的DOMELEMENT名称 |
  | ns      | VARCHAR2 | IN    | 否      | 命名空间            |
     
  
- DBE_XML.XML_DOM_CREATE_TEXT_NODE
  创建并返回DOMTEXT对象。
  DBE_XML.XML_DOM_CREATE_TEXT_NODE的函数原型为：
  ```
  DBE_XML.XML_DOM_CREATE_TEXT_NODE(
      id IN RAW(13),
      data IN VARCHAR2
  )
  RETURNS RAW(13);
  ```
  表11DBE_XML.XML_DOM_CREATE_TEXT_NODE接口参数说明 
  | 参数   | 类型       | 入参/出参 | 是否可以为空 | 描述              |
  |:---|:---|:---|:---|:---|
  | id   | RAW(13)  | IN    | 否      | 指定的xmldom类型对象。  |
  | data | VARCHAR2 | IN    | 否      | 新建的DOMTEXT节点内容。 |
     
  
- DBE_XML.XML_DOM_FREE_DOCUMENT
  将指定的xmldom类型对象释放。
  DBE_XML.XML_DOM_FREE_DOCUMENT的存储过程原型为：
  ```
  DBE_XML.XML_DOM_FREE_DOCUMENT(
      id RAW(13)
  )
  RETURNS VOID;
  ```
  表12DBE_XML.XML_DOM_FREE_DOCUMENT接口参数说明 
  | 参数 | 类型      | 入参/出参 | 是否可以为空 | 描述             |
  |:---|:---|:---|:---|:---|
  | id | RAW(13) | IN    | 否      | 指定的xmldom类型对象。 |
     
  

- DBE_XML.XML_DOM_FREE_ELEMENT
  将指定的xmldom类型对象释放
  DBE_XML.XML_DOM_FREE_ELEMENT的存储过程原型为：
  ```
  DBE_XML.XML_DOM_FREE_ELEMENT (
      id RAW(13)
  )
  RETURNS VOID;
  ```
  表13DBE_XML.XML_DOM_FREE_ELEMENT接口参数说明 
  | 参数 | 类型      | 入参/出参 | 是否可以为空 | 描述            |
  |:---|:---|:---|:---|:---|
  | id | RAW(13) | IN    | 否      | 指定的xmldom类型对象 |
     
  
- DBE_XML.XML_DOM_FREE_NODE
  释放DOMNODE节点。
  DBE_XML.XML_DOM_FREE_NODE的函数原型为：
  ```
  DBE_XML.XML_DOM_FREE_NODE (
      id RAW(13)
  )
  RETURNS VOID;
  ```
  表14DBE_XML.XML_DOM_FREE_NODE接口参数说明 
  | 参数 | 类型      | 入参/出参 | 是否可以为空 | 描述            |
  |:---|:---|:---|:---|:---|
  | id | RAW(13) | IN    | 否      | 指定的xmldom类型对象 |
     
  
- DBE_XML.XML_DOM_FREE_NODELIST
  释放DOMNODELIST节点
  DBE_XML.XML_DOM_FREE_NODELIST的存储过程原型为：
  ```
  DBE_XML.XML_DOM_FREE_NODELIST(
      id IN RAW(13)
      
  )
  RETURNS VOID
  ```
  表15DBE_XML.XML_DOM_FREE_NODELIST接口参数说明 
  | 参数 | 类型      | 入参/出参 | 是否可以为空 | 描述            |
  |:---|:---|:---|:---|:---|
  | id | RAW(13) | IN    | 否      | 指定的xmldom类型对象 |
     
  
- DBE_XML.XML_DOM_GET_ATTRIBUTE
  获取指定的xmldom类型对象的属性
  DBE_XML.XML_DOM_GET_ATTRIBUTE的存储过程原型为：
  ```
  DBE_XML.XML_DOM_GET_ATTRIBUTE (
      docid   IN  RAW(13),
      name    IN  VARCHAR2
  )
  RETURNS VARCHAR2;
  ```
  表16DBE_XML.XML_DOM_GET_ATTRIBUTE接口参数说明 
  | 参数    | 类型       | 入参/出参 | 是否可以为空 | 描述            |
  |:---|:---|:---|:---|:---|
  | docid | RAW(13)  | IN    | 否      | 指定的xmldom类型对象 |
  | name  | VARCHAR2 | IN    | 否      | 字符串           |
     
  
- DBE_XML.XML_DOM_GET_ATTRIBUTES
  将DOMNode节点属性值作为map返回。
  DBE_XML.XML_DOM_GET_ATTRIBUTES的函数原型为：
  ```
  DBE_XML.XML_DOM_GET_ATTRIBUTES (
      id RAW(13)
  )
  RETURNS RAW(13);
  ```
  表17DBE_XML.XML_DOM_GET_ATTRIBUTES接口参数说明 
  | 参数 | 类型      | 入参/出参 | 是否可以为空 | 描述            |
  |:---|:---|:---|:---|:---|
  | id | RAW(13) | IN    | 否      | 指定的xmldom类型对象 |
     
  
- DBE_XML.XML_DOM_GET_CHILD_NODES
  将节点下的若干子节点转换成节点列表
  DBE_XML.XML_DOM_GET_CHILD_NODES的函数原型为：
  ```
  DBE_XML.XML_DOM_GET_CHILD_NODES(
      id IN RAW(13)
  )
  RETURNS RAW(13);
  ```
  表18DBE_XML.XML_DOM_GET_CHILD_NODES接口参数说明 
  | 参数 | 类型      | 入参/出参 | 是否可以为空 | 描述            |
  |:---|:---|:---|:---|:---|
  | id | RAW(13) | IN    | 否      | 指定的xmldom类型对象 |
     
  
- DBE_XML.XML_DOM_GET_CHILDREN_BY_TAGNAME
  获取指定的xmldom类型对象指定子节点组成的列表
  DBE_XML.XML_DOM_GET_CHILDREN_BY_TAGNAME的存储过程原型为：
  ```
  DBE_XML.XML_DOM_GET_CHILDREN_BY_TAGNAME (
      docid   IN  RAW(13),
      name    IN  VARCHAR2
  )
  RETURNS RAW(13);
  ```
  表19DBE_XML.XML_DOM_GET_CHILDREN_BY_TAGNAME 接口参数说明 
  | 参数    | 类型       | 入参/出参 | 是否可以为空 | 描述            |
  |:---|:---|:---|:---|:---|
  | docid | RAW(13)  | IN    | 否      | 指定的xmldom类型对象 |
  | name  | VARCHAR2 | IN    | 否      | 字符串           |
     
  
- DBE_XML.XML_DOM_GET_CHILDREN_BY_TAGNAME_NS
  获取指定的xmldom类型对象指定命名空间指定子节点组成的列表
  DBE_XML.XML_DOM_GET_CHILDREN_BY_TAGNAME_NS的存储过程原型为：
  ```
  DBE_XML.XML_DOM_GET_CHILDREN_BY_TAGNAME_NS (
      docid   IN  RAW(13),
      name    IN  VARCHAR2,
      ns      IN  VARCHAR2
  )
  RETURNS RAW(13);
  ```
  表20DBE_XML.XML_DOM_GET_CHILDREN_BY_TAGNAME_NS接口参数说明 
  | 参数    | 类型       | 入参/出参 | 是否可以为空 | 描述            |
  |:---|:---|:---|:---|:---|
  | docid | RAW(13)  | IN    | 否      | 指定的xmldom类型对象 |
  | name  | VARCHAR2 | IN    | 否      | 字符串           |
  | ns    | VARCHAR2 | IN    | 是      | 字符串           |
     
  
- DBE_XML.XML_DOM_GET_DOCUMENT_ELEMENT
  返回指定DOCUMENT的首个子节点。
  DBE_XML.XML_DOM_GET_DOCUMENT_ELEMENT的存储过程原型为：
  ```
  DBE_XML.XML_DOM_GET_DOCUMENT_ELEMENT(
      id  RAW(13)
  )
  RETURNS RAW(13);
  ```
  表21DBE_XML.XML_DOM_GET_DOCUMENT_ELEMENT接口参数说明 
  | 参数 | 类型      | 入参/出参 | 是否可以为空 | 描述            |
  |:---|:---|:---|:---|:---|
  | id | RAW(13) | IN    | 否      | 指定的xmldom类型对象 |
     
  
- DBE_XML.XML_DOM_GET_FIRST_CHILD
  返回node节点的第一个子节点。
  DBE_XML.XML_DOM_GET_FIRST_CHILD的函数原型为：
  ```
  DBE_XML.XML_DOM_GET_FIRST_CHILD(
      id IN RAW(13)
  )
  RETURNS RAW(13);
  ```
  表22DBE_XML.XML_DOM_GET_FIRST_CHILD接口参数说明 
  | 参数 | 类型      | 入参/出参 | 是否可以为空 | 描述            |
  |:---|:---|:---|:---|:---|
  | id | RAW(13) | IN    | 否      | 指定的xmldom类型对象 |
     
  
- DBE_XML.XML_DOM_GET_LAST_CHILD
  返回node节点的最后一个子节点。
  DBE_XML.XML_DOM_GET_LAST_CHILD的函数原型为：
  ```
  DBE_XML.XML_DOM_GET_LAST_CHILD(
      id IN RAW(13)
  )
  RETURNS RAW(13);
  ```
  表23DBE_XML.XML_DOM_GET_LAST_CHILD接口参数说明 
  | 参数 | 类型      | 入参/出参 | 是否可以为空 | 描述            |
  |:---|:---|:---|:---|:---|
  | id | RAW(13) | IN    | 否      | 指定的xmldom类型对象 |
     
  
- DBE_XML.XML_DOM_GET_LENGTH
  根据类型节点中内容返回节点数。
  DBE_XML.XML_DOM_GET_LENGTH的存储过程原型为：
  ```
  DBE_XML.XML_DOM_GET_LENGTH(
      id RAW(13)
  )
  RETURNS VOID;
  ```
  表24DBE_XML.XML_DOM_GET_LENGTH接口参数说明 
  | 参数 | 类型      | 入参/出参 | 是否可以为空 | 描述            |
  |:---|:---|:---|:---|:---|
  | id | RAW(13) | IN    | 是      | 指定的xmldom类型对象 |
     
  
- DBE_XML.XML_DOM_GET_LOCALNAME
  返回给定对象的本地名称
  DBE_XML.XML_DOM_GET_LOCALNAME的存储过程原型为：
  ```
  DBE_XML.XML_DOM_GET_LOCALNAME (
      id  RAW(13)
  )
  RETURNS VARCHAR2;
  ```
  表25DBE_XML.XML_DOM_GET_LOCALNAME接口参数说明 
  | 参数 | 类型      | 入参/出参 | 是否可以为空 | 描述            |
  |:---|:---|:---|:---|:---|
  | id | RAW(13) | IN    | 是      | 指定的xmldom类型对象 |
     
  
- DBE_XML.XML_DOM_GET_NAMED_ITEM
  检索由名称指定的节点
  DBE_XML.XML_DOM_GET_NAMED_ITEM的函数原型为：
  ```
  DBE_XML.XML_DOM_GET_NAMED_ITEM(
      id IN RAW(13),
      nodeName IN VARCHAR2
  )
  RETURNS RAW(13);
  ```
  表26DBE_XML.XML_DOM_GET_NAMED_ITEM接口参数说明 
  | 参数       | 类型       | 入参/出参 | 是否可以为空 | 描述            |
  |:---|:---|:---|:---|:---|
  | id       | RAW(13)  | IN    | 否      | 指定的xmldom类型对象 |
  | nodeName | VARCHAR2 | IN    | 否      | 要检索的元素的名称     |
     
  
- DBE_XML.XML_DOM_GET_NAMED_ITEM_NS
  检索由名称和命名空间指定的节点
  DBE_XML.XML_DOM_GET_NAMED_ITEM_NS的函数原型为：
  ```
  DBE_XML.XML_DOM_GET_NAMED_ITEM_NS(
      id  RAW(13),
      nodeName IN VARCHAR2,
      ns IN VARCHAR2
  )
  RETURNS RAW(13);
  ```
  表27DBE_XML.XML_DOM_GET_NAMED_ITEM_NS接口参数说明 
  | 参数       | 类型       | 入参/出参 | 是否可以为空 | 描述            |
  |:---|:---|:---|:---|:---|
  | id       | RAW(13)  | IN    | 否      | 指定的xmldom类型对象 |
  | nodeName | VARCHAR2 | IN    | 否      | 要检索的元素的名称     |
  | ns       | VARCHAR2 | IN    | 是      | 命名空间          |
     
  
- DBE_XML.XML_DOM_GET_NEXT_SIBLING
  返回该节点的下一个节点。
  DBE_XML.XML_DOM_GET_NEXT_SIBLING的函数原型为：
  ```
  DBE_XML.XML_DOM_GET_NEXT_SIBLING(
      id IN RAW(13)
  )
  RETURNS RAW(13);
  ```
  表28DBE_XML.XML_DOM_GET_NEXT_SIBLING接口参数说明 
  | 参数 | 类型      | 入参/出参 | 是否可以为空 | 描述            |
  |:---|:---|:---|:---|:---|
  | id | RAW(13) | IN    | 否      | 指定的xmldom类型对象 |
     
  
- DBE_XML.XML_DOM_GET_NODE_NAME
  返回节点的名称。
  DBE_XML.XML_DOM_GET_NODE_NAME的函数原型为：
  ```
  DBE_XML.XML_DOM_GET_NODE_NAME(
      id IN RAW(13)
  )
  RETURNS VARCHAR2;
  ```
  表29DBE_XML.XML_DOM_GET_NODE_NAME接口参数说明 
  | 参数 | 类型      | 入参/出参 | 是否可以为空 | 描述            |
  |:---|:---|:---|:---|:---|
  | id | RAW(13) | IN    | 否      | 指定的xmldom类型对象 |
     
  
- DBE_XML.XML_DOM_GET_NODE_TYPE
  返回节点的类型。
  DBE_XML.XML_DOM_GET_NODE_TYPE的函数原型为：
  ```
  DBE_XML.XML_DOM_GET_NODE_TYPE(
      id IN RAW(13)
  )
  RETURNS INTEGER;
  ```
  表30DBE_XML.XML_DOM_GET_NODE_TYPE接口参数说明 
  | 参数 | 类型      | 入参/出参 | 是否可以为空 | 描述            |
  |:---|:---|:---|:---|:---|
  | id | RAW(13) | IN    | 否      | 指定的xmldom类型对象 |
     
  
- DBE_XML.XML_DOM_GET_NODE_VALUE
  返回NODE节点的值。
  DBE_XML.XML_DOM_GET_NODE_VALUE的存储过程原型为：
  ```
  DBE_XML.XML_DOM_GET_NODE_VALUE(
  id IN RAW(13))
  RETURNS VARCHAR2;
  ```
  表31DBE_XML.XML_DOM_GET_NODE_VALUE接口参数说明 
  | 参数 | 类型      | 入参/出参 | 是否可以为空 | 描述            |
  |:---|:---|:---|:---|:---|
  | id | RAW(13) | IN    | 是      | 指定的xmldom类型对象 |
     
  
- DBE_XML.XML_DOM_GET_PARENT_NODE
  返回给定NODE节点的父节点。
  DBE_XML.XML_DOM_GET_PARENT_NODE的存储过程原型为：
  ```
  DBE_XML.XML_DOM_GET_PARENT_NODE(
  id IN RAW(13))
  RETURNS RAW(13);
  ```
  表32DBE_XML.XML_DOM_GET_PARENT_NODE接口参数说明 
  | 参数 | 类型      | 入参/出参 | 是否可以为空 | 描述            |
  |:---|:---|:---|:---|:---|
  | id | RAW(13) | IN    | 是      | 指定的xmldom类型对象 |
     
  
- DBE_XML.XML_DOM_GET_TAGNAME
  获取指定的xmldom类型对象的标签名
  DBE_XML.XML_DOM_GET_TAGNAME的存储过程原型为：
  ```
  DBE_XML.XML_DOM_GET_TAGNAME (
      docid RAW(13)
  )
  RETURNS VARCHAR2;
  ```
  表33DBE_XML.XML_DOM_GET_TAGNAME接口参数说明 
  | 参数    | 类型      | 入参/出参 | 是否可以为空 | 描述            |
  |:---|:---|:---|:---|:---|
  | docid | RAW(13) | IN    | 是      | 指定的xmldom类型对象 |
     
  
- DBE_XML.XML_DOM_HAS_CHILD_NODES
  检查DOMNODE对象是否拥有任一子节点。
  DBE_XML.XML_DOM_HAS_CHILD_NODES的存储过程原型为：
  ```
  DBE_XML.XML_DOM_HAS_CHILD_NODES(
  id IN RAW(13))
  RETURNS BOOLEAN
  ```
  表34DBE_XML.XML_DOM_HAS_CHILD_NODES接口参数说明 
  | 参数 | 类型      | 入参/出参 | 是否可以为空 | 描述            |
  |:---|:---|:---|:---|:---|
  | id | RAW(13) | IN    | 是      | 指定的xmldom类型对象 |
     
  
- DBE_XML.XML_DOM_IMPORT_NODE
  该函数将节点复制到另一节点中，并将复制后的节点挂载到指定document中。若被复制节点的类型不属于xmldom的constants所规定的12种类型，则直接抛出类型不支持异常。
  DBE_XML.XML_DOM_IMPORT_NODE的函数原型为：
  ```
  DBE_XML.XML_DOM_IMPORT_NODE(
      doc_id IN RAW(13),
      node_id IN RAW(13),
      deep IN BOOLEAN
  )
  RETURNS RAW(13);
  ```
  表35DBE_XML.XML_DOM_IMPORT_NODE接口参数说明 
  | 参数      | 类型      | 入参/出参 | 是否可以为空 | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
  |:---|:---|:---|:---|:---|
  | doc_id  | RAW(13) | IN    | 否      | 节点挂载的文档。                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
  | node_id | RAW(13) | IN    | 否      | 将要导入的节点。                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
  | deep    | BOOLEAN | IN    | 否      | 设置递归导入： - 如果为TRUE，则导入该节点及其所有子节点。  - 如果为FALSE，则指导入节点本身。   |
     
  
- DBE_XML.XML_DOM_IS_NULL
  判断给定对象是否为NULL，如果是则返回True，否则返回false。
  DBE_XML.XML_DOM_IS_NULL的函数原型为：
  ```
  DBE_XML.XML_DOM_IS_NULL (
      id  RAW(13)
  )
  RETURNS BOOLEAN;
  ```
  表36DBE_XML.XML_DOM_IS_NULL接口参数说明 
  | 参数 | 类型      | 入参/出参 | 是否可以为空 | 描述             |
  |:---|:---|:---|:---|:---|
  | id | RAW(13) | IN    | 是      | 指定的xmldom类型对象。 |
     
  
- DBE_XML.XML_DOM_ITEM
  根据索引返回list或map中与索引对应的元素。
  DBE_XML.XML_DOM_ITEM的函数原型为：
  ```
  DBE_XML.XML_DOM_ITEM (
      id IN RAW(13),
      index IN INTEGER
  )
  RETURNS RAW(13);
  ```
  表37DBE_XML.XML_DOM_ITEM接口参数说明 
  | 参数    | 类型      | 入参/出参 | 是否可以为空 | 描述             |
  |:---|:---|:---|:---|:---|
  | id    | RAW(13) | IN    | 否      | 指定的xmldom类型对象。 |
  | index | INTEGER | IN    | 否      | 要检索的元素的索引。     |
     
  
- DBE_XML.XML_DOM_MAKE_ELEMENT
  返回转换后的DOMELEMENT对象。
  DBE_XML.XML_DOM_MAKE_ELEMENT的存储过程原型为：
  ```
  DBE_XML.XML_DOM_MAKE_ELEMENT(
  id IN RAW(13))
  RETURNS RAW(13)
  ```
  表38DBE_XML.XML_DOM_MAKE_ELEMENT接口参数说明 
  | 参数 | 类型      | 入参/出参 | 是否可以为空 | 描述             |
  |:---|:---|:---|:---|:---|
  | id | RAW(13) | IN    | 否      | 指定的xmldom类型对象。 |
     
  
- DBE_XML.XML_DOM_MAKENODE
  将给定对象强制转换为DOMNODE类型。
  DBE_XML.XML_DOM_MAKENODE的存储过程原型为：
  ```
  DBE_XML.XML_DOM_MAKENODE(
     id    RAW(13)
  )
  RETURNS DOMNODE;
  ```
  表39DBE_XML.XML_DOM_MAKENODE接口参数说明 
  | 参数 | 类型      | 入参/出参 | 是否可以为空 | 描述             |
  |:---|:---|:---|:---|:---|
  | id | RAW(13) | IN    | 是      | 指定的xmldom类型对象。 |
     
  
- DBE_XML.XML_DOM_NEW_DOM_DOCUMENT_EMPTY
  返回新的DOMDOCUMENT对象。
  DBE_XML.XML_DOM_NEW_DOM_DOCUMENT_EMPTY的函数原型为：
  ```
  DBE_XML.XML_DOM_NEW_DOM_DOCUMENT_EMPTY()
  RETURNS RAW(13);
  ```
  
- DBE_XML.XML_DOM_NEW_DOM_DOCUMENT_CLOB
  返回从指定的CLOB类型创建的新DOMDOCUMENT实例对象。
  DBE_XML.XML_DOM_NEW_DOM_DOCUMENT_CLOB的函数原型为：
  ```
  DBE_XML.XML_DOM_NEW_DOM_DOCUMENT_CLOB(
      content IN  CLOB
  )
  RETURNS RAW(13);
  ```
  表40xml_dom_new_dom_document_clob接口参数说明 
  | 参数      | 类型   | 入参/出参 | 是否可以为空 | 描述         |
  |:---|:---|:---|:---|:---|
  | content | CLOB | IN    | 否      | 指定的CLOB类型。 |
     
  
- DBE_XML.XML_DOM_NEW_DOCUMENT_XMLTYPE
  返回从指定的XMLType类型创建的新DOMDOCUMENT实例对象。
  DBE_XML.XML_DOM_NEW_DOCUMENT_XMLTYPE的函数原型为：
  ```
  DBE_XML.XML_DOM_NEW_DOCUMENT_XMLTYPE(
      content IN  CLOB
  )
  RETURNS RAW(13);
  ```
  表41DBE_XML.XML_DOM_NEW_DOCUMENT_XMLTYPE接口参数说明 
  | 参数      | 类型   | 入参/出参 | 是否可以为空 | 描述         |
  |:---|:---|:---|:---|:---|
  | content | CLOB | IN    | 否      | 指定的CLOB类型。 |
     
  
- DBE_XML.XML_DOM_SET_ATTRIBUTE
  设置指定的xmldom类型对象的属性。
  DBE_XML.XML_DOM_SET_ATTRIBUTE的存储过程原型为：
  ```
  DBE_XML.XML_DOM_SET_ATTRIBUTE(
      docid   IN  RAW(13),
      name    IN  VARCHAR2,
      value   IN  VARCHAR2
  )
  RETURNS void;
  ```
  表42DBE_XML.XML_DOM_SET_ATTRIBUTE接口参数说明 
  | 参数    | 类型       | 入参/出参 | 是否可以为空 | 描述             |
  |:---|:---|:---|:---|:---|
  | id    | RAW(13)  | IN    | 否      | 指定的xmldom类型对象。 |
  | name  | VARCHAR2 | IN    | 否      | 字符串            |
  | value | VARCHAR2 | IN    | 否      | 字符串            |
     
  
- DBE_XML.XML_DOM_SET_CHARSET
  设置DOM设置DOMDOCUMENT的CHATSET字符集。
  DBE_XML.XML_DOM_SET_CHARSET的函数原型为：
  ```
  DBE_XML.XML_DOM_SET_CHARSET(
      id      IN RAW(13),
      charset IN VARCHAR2
  )
  RETURNS void;
  ```
  表43DBE_XML.XML_DOM_SET_CHARSET接口参数说明 
  | 参数      | 类型       | 入参/出参 | 是否可以为空 | 描述             |
  |:---|:---|:---|:---|:---|
  | id      | RAW(13)  | IN    | 否      | 指定的xmldom类型对象。 |
  | charset | VARCHAR2 | IN    | 否      | 字符集            |
     
  
- DBE_XML.XML_DOM_SET_DOCTYPE
  设置DOMDOCUMENT的外部DTD。
  DBE_XML.XML_DOM_SET_DOCTYPE的函数原型为：
  ```
  DBE_XML.XML_DOM_SET_DOCTYPE(
      id          IN  RAW(13),
      dtd_name    IN  VARCHAR2,
      system_id   IN  VARCHAR2,
      public_id   IN  VARCHAR2
  )
  RETURNS void;
  ```
  表44DBE_XML.XML_DOM_SET_DOCTYPE接口参数说明 
  | 参数        | 类型       | 入参/出参 | 是否可以为空 | 描述                      |
  |:---|:---|:---|:---|:---|
  | id        | RAW(13)  | IN    | 否      | 指定的xmldom类型对象。          |
  | dtd_name  | VARCHAR2 | IN    | 否      | 需要初始化doctype的名称。        |
  | system_id | VARCHAR2 | IN    | 否      | 需要初始化doctype的system ID。 |
  | public_id | VARCHAR2 | IN    | 否      | 需要初始化doctype的public ID。 |
     
  
- DBE_XML.XML_DOM_SET_NODE_VALUE
  此函数用于向DOMNODE对象中设置节点的值。
  DBE_XML.XML_DOM_SET_NODE_VALUE的存储过程原型为：
  ```
  DBE_XML.XML_DOM_SET_NODE_VALUE(
  id IN RAW(13),
  node_value IN VARCHAR2)
  RETURNS VOID
  ```
  表45DBE_XML.XML_DOM_SET_NODE_VALUE接口参数说明 
  | 参数         | 类型       | 入参/出参 | 是否可以为空 | 描述                 |
  |:---|:---|:---|:---|:---|
  | id         | RAW(13)  | IN    | 否      | 指定的xmldom类型对象。     |
  | node_value | VARCHAR2 | IN    | 否      | 向DOMNODE对象中设置的字符串。 |
     
  
- DBE_XML.XML_DOM_WRITE_TO_BUFFER_DOC
  将给定的DOMDOCUMENT类型对象写入缓冲区。
  DBE_XML.XML_DOM_WRITE_TO_BUFFER_DOC的存储过程原型为：
  ```
  DBE_XML.XML_DOM_WRITE_TO_BUFFER_DOC(
  id IN RAW(13))
  RETURNS VARCHAR2;
  ```
  表46DBE_XML.XML_DOM_WRITE_TO_BUFFER_DOC接口参数说明 
  | 参数 | 类型      | 入参/出参 | 是否可以为空 | 描述             |
  |:---|:---|:---|:---|:---|
  | id | RAW(13) | IN    | 是      | 指定的xmldom类型对象。 |
     
  
- DBE_XML.XML_DOM_WRITE_TO_BUFFER_NODE
  将给定的DOMNODE类型对象写入缓冲区。
  DBE_XML.XML_DOM_WRITE_TO_BUFFER_NODE的存储过程原型为：
  ```
  DBE_XML.XML_DOM_WRITE_TO_BUFFER_NODE(
  id IN RAW(13))
  RETURNS VARCHAR2;
  ```
  表47DBE_XML.XML_DOM_WRITE_TO_BUFFER_NODE接口参数说明 
  | 参数 | 类型      | 入参/出参 | 是否可以为空 | 描述             |
  |:---|:---|:---|:---|:---|
  | id | RAW(13) | IN    | 是      | 指定的xmldom类型对象。 |
     
  
- DBE_XML.XML_DOM_WRITE_TO_CLOB_DOC
  将给定的DOMDOCUMENT类型对象写入Clob。
  DBE_XML.XML_DOM_WRITE_TO_CLOB_DOC的存储过程原型为：
  ```
  DBE_XML.XML_DOM_WRITE_TO_CLOB_DOC(
      id IN RAW(13)
  )
  RETURNS VARCHAR2;
  ```
  表48DBE_XML.XML_DOM_WRITE_TO_CLOB_DOC接口参数说明 
  | 参数 | 类型      | 入参/出参 | 是否可以为空 | 描述             |
  |:---|:---|:---|:---|:---|
  | id | RAW(13) | IN    | 是      | 指定的xmldom类型对象。 |
     
  
- DBE_XML.XML_DOM_WRITE_TO_CLOB_NODE
  将给定的DOMNODE类型对象写入Clob。
  DBE_XML.XML_DOM_WRITE_TO_CLOB_NODE的存储过程原型为：
  ```
  DBE_XML.XML_DOM_WRITE_TO_CLOB_NODE(
      id          IN  RAW(13)
  )
  RETURNS CLOB;
  ```
  表49DBE_XML.XML_DOM_WRITE_TO_CLOB_NODE接口参数说明 
  | 参数 | 类型      | 入参/出参 | 是否可以为空 | 描述             |
  |:---|:---|:---|:---|:---|
  | id | RAW(13) | IN    | 是      | 指定的xmldom类型对象。 |
     
  

- DBE_XML.XML_DOM_WRITE_TO_FILE_DOC
  使用数据库字符集将XML节点写入指定文件。
  DBE_XML.XML_DOM_WRITE_TO_FILE_DOC的存储过程原型为：
  ```
  DBE_XML.XML_DOM_WRITE_TO_FILE_DOC(
  id IN  RAW(13),
  file_dir IN  VARCHAR2)
  RETURNS VOID
  DBE_XML.XML_DOM_WRITE_TO_FILE_DOC(
  id IN  RAW(13),
  file_dir IN  VARCHAR2,
  charset  IN  VARCHAR2)
  RETURNS VOID PACKAGE
  ```
  表50DBE_XML.XML_DOM_WRITE_TO_FILE_DOC接口参数说明 
  | 参数       | 类型       | 入参/出参 | 是否可以为空 | 描述             |
  |:---|:---|:---|:---|:---|
  | id       | RAW(13)  | IN    | 是      | 指定的xmldom类型对象。 |
  | file_dir | VARCHAR2 | IN    | 否      | 要写入的文件。        |
  | charset  | VARCHAR2 | IN    | 否      | 指定字符集。         |
     
  

- DBE_XML.XML_DOM_WRITE_TO_FILE_NODE
  使用数据库字符集将XML节点写入指定文件。
  DBE_XML.XML_DOM_WRITE_TO_FILE_NODE的存储过程原型为：
  ```
  DBE_XML.XML_DOM_WRITE_TO_FILE_NODE(
  id IN  RAW(13),
  filename IN  VARCHAR2)
  RETURNS VOID
  ```
  表51DBE_XML.XML_DOM_WRITE_TO_FILE_NODE接口参数说明 
  | 参数       | 类型       | 入参/出参 | 是否可以为空 | 描述             |
  |:---|:---|:---|:---|:---|
  | id       | RAW(13)  | IN    | 否      | 指定的xmldom类型对象。 |
  | filename | VARCHAR2 | IN    | 否      | 指定文件地址。        |
     
  
- DBE_XML.XML_DOM_GET_SESSION_TREE_NUM
  查询当前session中所有类型的dom树数量。
  DBE_XML.XML_DOM_GET_SESSION_TREE_NUM的函数原型为：
  ```
  DBE_XML.XML_DOM_GET_SESSION_TREE_NUM()
  RETURNS INTEGER
  ```
  
- DBE_XML.XML_DOM_GET_DOC_TREES_INFO
  查询当前session中Document类型的dom树信息，如内存占用等。
  DBE_XML.XML_DOM_GET_DOC_TREES_INFO的函数原型为：
  ```
  DBE_XML.XML_DOM_GET_DOC_TREES_INFO()
  RETURNS VARCHAR2
  ```
  
- DBE_XML.XML_DOM_GET_DETAIL_DOC_TREE_INFO
  查询传入的document内的各类型子节点的数量。
  DBE_XML.XML_DOM_GET_DETAIL_DOC_TREE_INFO的函数原型为：
  ```
  dbe_xml.xml_dom_get_detail_doc_tree_info(
  id IN  RAW(13))
  RETURNS VARCHAR2
  ```
  表52DBE_XML.XML_DOM_GET_DETAIL_DOC_TREE_INFO接口参数说明 
  | 参数 | 类型      | 入参/出参 | 是否可以为空 | 描述             |
  |:---|:---|:---|:---|:---|
  | id | RAW(13) | IN    | 否      | 指定的xmldom类型对象。 |