Oracle XMLPI() 函数使用指南

在 Oracle 数据库中，XMLPI() 是一个用于**生成符合 W3C 标准的 XML 处理指令（Processing Instruction，简称 PI）**的内置函数。处理指令常用于向处理 XML 文档的下游应用程序传递指示信息（例如指定样式表 xml-stylesheet、渲染引擎参数或数据清洗规则），格式通常为 <?target instruction?>。

语法

Oracle XMLPI() 函数的标准语法如下：

XMLPI ( [ NAME ] <identifier> [, <value_expr> ] )

参数说明

NAME identifier：必需。指定处理指令的目标名称（Target Identifier）。例如 "xml-stylesheet" 或 "app-directive"。
- 重要规范：identifier 不能是小写、大写或大小写混合的 "xml"，否则将违反 W3C XML 1.0 规范，Oracle 会报错拒绝执行。
value_expr（可选）：处理指令的具体内容字符串。
- 重要规范：内容中绝对不能包含子字符串 ?>，因为 ?> 是 XML 处理指令的法定结束标识符。

返回值

返回一个包含处理指令的 XMLType 实例。如果 value_expr 为 NULL，则生成只有目标名称的处理指令。

使用示例

示例 1：生成关联 XSLT 样式表的处理指令

SELECT 
    XMLPI(NAME "xml-stylesheet", 'type="text/xsl" href="orders_style.xsl"') AS stylesheet_pi
FROM dual;

输出结果：

<?xml-stylesheet type="text/xsl" href="orders_style.xsl"?>

示例 2：与 XMLCONCAT 结合组装完整文档

将处理指令与根 XML 元素拼接成完整的 XML 实体：

SELECT 
    XMLCONCAT(
        XMLPI(NAME "app-config", 'mode="production"'),
        XMLELEMENT("root", '系统运行中')
    ) AS full_xml
FROM dual;