在Oracle 18c之前，SQL表函数如果要返回结果集，其输出结构必须在创建函数时就确定下来，例如使用对象类型或集合类型定义好每一列的名称与数据类型。当需要在不同的表上执行类似的列裁剪、脱敏或格式转换时，开发人员通常只能为每张表单独编写视图或存储过程，维护成本较高。Oracle 18c引入的多态表函数Polymorphic Table Functions，简称PTF，正是为了应对这类需求。它允许函数在SQL编译阶段接收输入表的结构信息，并在返回时动态调整列集合、列类型甚至行数据。换句话说，同一个PTF函数作用在不同结构的表上，可以产生不同的输出列结构。
PTF并不是简单的语法糖，它背后依赖一套PL/SQL接口。开发人员需要编写一个实现包，并在包内定义DESCRIBE过程，通过DBMS_TF包对输入表元数据进行操作。查询时，Oracle优化器会调用这个过程生成最终的行集描述，随后执行正常的表函数数据流。这一机制使得PTF成为SQL层可扩展性的重要增强，尤其适合数据服务平台和通用工具包场景。
一、对比传统表函数与视图，PTF解决了哪些痛点
先来看传统管道表函数。开发人员需要先定义一个对象类型或记录类型，声明每一列的名称和类型，然后再创建一个基于该类型的表函数。这个函数一旦编译完成，返回结构就固定了。如果要对另一张列结构不同的表做类似处理，要么重新创建一个函数，要么把输入表拆分成标量参数，做法非常笨重。视图虽然能够基于单表做列裁剪或脱敏，但逻辑通常会绑定在某一张具体表上，无法在不同结构的表之间复用。
PTF则把输入表本身作为一个参数传给函数，函数在编译阶段动态读取这张表的列信息，然后决定输出哪些列、列名是什么、是否需要转换类型。例如一个数据脱敏函数可以接受任意包含手机号、身份证号或邮箱列的表，通过识别列名自动对这些列进行掩码处理，而不需要为每一张表单独写函数。这种灵活性大幅减少了重复代码，也让统一安全策略更容易落地。
与传统表函数相比，PTF还有一个重要差异：传统表函数的输出列由函数定义静态决定，优化器在执行查询前就能完整知道结果集结构；PTF的输出结构则是在查询编译时由实现包动态生成。因此，PTF对优化器的元数据解析能力要求更高，也带了更高的调试成本，但换来了更强大的抽象能力。
二、PTF的实现机制与关键组件
创建一个多态表函数需要两部分配合。第一部分是函数声明，使用POLYMORPHIC USING子句指向一个实现包，函数的输入参数通常声明为TABLE类型，返回类型同样为TABLE。第二部分是实现包，包内必须包含一个名为DESCRIBE的过程，该过程负责在编译阶段检查输入表结构，并调用DBMS_TF包中的过程来修改输出元数据。
DBMS_TF包是Oracle 18c为PTF提供的专用接口。在DESCRIBE过程中，开发人员可以遍历输入表的列信息，根据列名、数据类型或位置执行移除列、隐藏列、重命名列、修改列类型等操作。如果只是做列裁剪，直接调用DBMS_TF.REMOVE_COLUMN即可；如果要根据条件动态决定输出结构，也可以在过程中加入判断逻辑。这意味着同一个函数可以被不同列结构的表调用，每次调用都能输出符合该表特征的结果集。
除了DESCRIBE过程，PTF实现包还可以选择性地实现FETCH_ROWS过程。该过程在运行时被调用，用于对行数据进行进一步加工，比如行过滤、行扩展或基于行内容的计算。不过对于大多数列级转换场景，仅实现DESCRIBE就已经足够。理解这两个过程的职责边界，是掌握PTF开发的关键。
三、完整示例：通过PTF动态移除敏感列
下面通过一个简单示例展示如何创建并使用PTF。假设有一张员工表SCOTT.EMP，其中第3列是工资字段，需要在查询输出时自动移除该列。先创建实现包，在DESCRIBE过程中直接移除输入表的第3列。
CREATE OR REPLACE PACKAGE ptf_demo_pkg AS
PROCEDURE describe (p_tab IN OUT DBMS_TF.TABLE_T);
END;
/
CREATE OR REPLACE PACKAGE BODY ptf_demo_pkg AS
PROCEDURE describe (p_tab IN OUT DBMS_TF.TABLE_T) AS
BEGIN
-- 假设输入表第3列是敏感字段，这里直接移除第3个列
DBMS_TF.REMOVE_COLUMN(p_tab, 3);
END;
END;
/
CREATE OR REPLACE FUNCTION hide_sal_ptf(p_tab TABLE)
RETURN TABLE PIPELINED ROW POLYMORPHIC USING ptf_demo_pkg;
/
创建完成后，可以直接在查询中把这个函数当作表来使用。这里传入SCOTT.EMP表，输出结果将不包含原来的第3列工资字段，其余列原样返回。
SELECT * FROM hide_sal_ptf(scott.emp);
从这个例子可以看出，函数声明本身完全没有指定返回列结构，只是把输入表交给实现包处理。如果换一张列结构不同的表调用同一个函数，只要该表至少有3列，第3列同样会被移除。这种基于位置或列名的动态处理能力，是传统表函数无法做到的。实际项目中更常用的做法是根据列名判断，例如找到所有包含手机号字样的列并进行掩码，从而实现跨表复用的数据脱敏策略。
需要注意的是，DBMS_TF.TABLE_T表示输入表的描述结构，在18c版本中通过该类型可以读取每列的名称、类型、长度、精度等信息。开发人员可以在循环中检查这些属性，再决定如何处理。虽然代码复杂度高于普通表函数，但一旦封装成通用工具包，收益非常明显。
四、PTF的使用限制与最佳实践
PTF虽然强大，但在Oracle 18c中仍然存在一些限制。首先，它不能在PL/SQL块中直接调用，只能在SQL语句中使用。其次，PTF的参数传递方式比较特殊，输入表需要作为表引用传入，不能把标量子查询结果当作表参数。此外，PTF实现包中的DESCRIBE过程在查询编译时执行，如果过程内部包含异常或死循环，会直接影响SQL解析，导致查询无法执行。因此编写实现包时要注意异常处理和逻辑简洁。
在性能方面，PTF的动态元数据解析会带来一些额外开销，尤其是在复杂查询或多表关联场景中。对于高频调用的简单列裁剪，仍然建议使用普通视图或直接写SQL；而对于跨表复用的脱敏、日志脱敏、动态列生成等场景，PTF的优势更加明显。调试时可以使用DBMS_TF.TRACE相关功能或查看执行计划中的表函数调用信息，确认输出结构是否符合预期。
最后，建议将PTF实现包与业务逻辑包分开管理，因为实现包需要较高的系统权限，通常由数据库管理员或平台团队维护。命名时明确区分函数与实现包的关系，并在包注释中说明支持哪些列名规则。这样可以降低后续维护成本，也便于在团队中推广这一Oracle 18c的重要新特性。
Oracle 18c多态表函数PTF修改时间：2026-09-19 22:46:42