CONTAINS在PL/SQL中正确调用需同时满足四条件：授予CTXAPP角色及CTXSYS.CTX_DDL执行权、字段建有VALID的ctxsys.context索引、CONTAINS仅用于WHERE子句、中文需配置chinese_vgram_lexer或chinese_lexer。
contains 是 oracle 全文检索最核心的查询函数，但直接在 pl/sql 中调用它，必须满足几个硬性前提——否则会报 ora-29902、drg-51030 或 ora-20000 这类错误。不是写个 select ... where contains(...) 就能跑通。
为什么 PL/SQL 里直接写 CONTAINS 常常报错？
根本原因在于：Oracle Text 的索引和查询机制依赖于底层的上下文环境（session context），而 PL/SQL 匿名块或存储过程默认不继承 SQL*Plus 或应用连接中已激活的全文索引元数据状态。常见报错包括：
-
ORA-29902: error in executing ODCIIndexStart()—— 索引未就绪或用户没权限访问索引元数据 -
DRG-51030: wildcard query expansion resulted in too many terms—— 错误地在CONTAINS第二个参数里加了%，比如写成'%产量%'，实际应为'产量' -
ORA-00904: "CONTAINS": invalid identifier—— 用户没被授予CTXAPP角色，或未执行GRANT EXECUTE ON CTXSYS.CTX_DDL TO your_user
CONTAINS 函数在 PL/SQL 中的正确调用方式
不能只当普通函数用，必须确保三件事同时成立：
- 当前用户已通过
GRANT CTXAPP TO your_user和GRANT EXECUTE ON CTXSYS.CTX_DDL TO your_user获得权限 - 目标字段上已建好
ctxsys.context类型索引，且索引状态为VALID（查USER_INDEXES的STATUS列） -
CONTAINS必须出现在 SQL 语句的WHERE子句中，不能单独赋值给变量，例如不能写v_score := CONTAINS(col, 'test');
正确写法示例（在存储过程中）：
DECLARE
v_count NUMBER;
BEGIN
SELECT COUNT(*) INTO v_count
FROM your_table t
WHERE CONTAINS(t.content, '转速') > 0; -- 注意：无 %，无引号嵌套，字符串字面量直接写
DBMS_OUTPUT.PUT_LINE('匹配行数：' || v_count);
END;中文分词与 lexer 配置对 PL/SQL 查询的影响
Oracle 默认的英文 lexer 对中文基本无效；若字段含中文，必须显式创建中文 lexer 并绑定到索引。否则 CONTAINS 查“产量”会完全不命中。
- 推荐 lexer：
chinese_vgram_lexer（适合短文本、响应快）或chinese_lexer（切词更准，建索引慢） - 创建 lexer 必须用
CTX_DDL.CREATE_PREFERENCE，且该操作需在索引创建前完成 - 索引参数中必须显式指定
lexer your_lexer_name，例如：parameters('lexer my_chinese_lexer') - lexer 名称区分大小写，PL/SQL 中调用时拼错（如写成
MY_CHINESE_LEXER而实际是my_chinese_lexer）会导致索引不可用
同步与优化索引必须在 PL/SQL 中定时触发
Oracle Text 索引不会自动反映 DML 变更，新插入/更新的数据默认查不到。靠手动 CTX_DDL.SYNC_INDEX 和 CTX_DDL.OPTIMIZE_INDEX 维护。
-
SYNC_INDEX是增量同步，建议每 15–30 分钟跑一次；OPTIMIZE_INDEX('index_name', 'FULL')是重建，建议每天低峰期执行一次 - 这两个过程必须由有
EXECUTE ON CTXSYS.CTX_DDL权限的用户调用，不能跨用户代理 - 在 PL/SQL 中封装为存储过程后，可用
DBMS_SCHEDULER定时调度，避免用已废弃的DBMS_JOB - 注意：
SYNC_INDEX执行期间表仍可读写，但OPTIMIZE_INDEX(..., 'FULL')会短暂锁索引，影响查询响应
真正容易被忽略的点是：lexer 创建、索引建立、权限授予、同步调度这四步缺一不可，且顺序不能颠倒。少一步，CONTAINS 就只是个报错的语法符号。
