0

0

如何在 Oracle JDBC 连接中正确设置自定义 clientInfo

心靈之曲

心靈之曲

发布时间:2026-01-27 09:12:09

|

714人浏览过

|

来源于php中文网

原创

如何在 Oracle JDBC 连接中正确设置自定义 clientInfo

oracle jdbc 驱动对 `setclientinfo()` 方法的命名空间有严格限制,仅支持预定义的 `ocsid` 等少数命名空间(如 clientid、module、action),直接使用任意键(如 `"user.userid"`)会触发 ora-28267 错误。

在 Oracle 12c 及更高版本中,JDBC 驱动遵循 Oracle Call Stack Identifier(OCSID)标准,仅允许通过 setClientInfo(String name, String value) 设置特定命名空间下的属性,且命名空间必须为 "OCSID" —— 其他自定义前缀(如 "USER"、"APP" 或 "CUSTOM")均不被识别,将导致 ORA-28267: Invalid Namespace Value 异常。

✅ 正确可用的 OCSID 属性包括:

  • "OCSID.CLIENTID":标识客户端用户或会话逻辑身份(如 "Alice_HR_Payroll")
  • "OCSID.MODULE":标识应用模块名(如 "APP_HR_PAYROLL")
  • "OCSID.ACTION":标识当前执行的操作(如 "PAYROLL_REPORT")
  • "OCSID.CLIENT_INFO":最多 64 字节的通用字符串(兼容旧版 DBMS_APPLICATION_INFO.SET_CLIENT_INFO)

⚠️ 注意事项:

数说Social Research
数说Social Research

社媒领域的AI Agent,全能营销智能助手

下载
  • 所有键名必须全大写且严格匹配上述格式(大小写敏感);
  • 值长度受 Oracle 内部限制(如 CLIENTID 最长 64 字节,MODULE/ACTION 各 48 字节);
  • 设置后可通过 V$SESSION 视图查询:
    SELECT client_identifier, module, action, client_info FROM v$session WHERE sid = SYS_CONTEXT('USERENV', 'SID');
  • 不支持嵌套命名空间(如 "USER.USERID")、点号分隔的自定义前缀,或未在 OCSID 规范中定义的键。

? 示例代码(Java 8 + Oracle JDBC 12.2+):

// ✅ 正确:使用标准 OCSID 命名空间
connection.setClientInfo("OCSID.CLIENTID", "john_doe@hr-app");
connection.setClientInfo("OCSID.MODULE", "HR-Payroll-Service");
connection.setClientInfo("OCSID.ACTION", "generate_monthly_report");
connection.setClientInfo("OCSID.CLIENT_INFO", "tenant=us-east;env=prod");

// ❌ 错误:自定义命名空间将抛出 ORA-28267
// connection.setClientInfo("USER.USERID", "john_doe"); // 不支持
// connection.setClientInfo("APP.VERSION", "2.1.0");     // 不支持

? 补充建议:若需传递更丰富的上下文信息(如用户 ID、租户、请求 ID),推荐组合使用 OCSID.CLIENTID(主标识)与 OCSID.CLIENT_INFO(结构化补充),并确保值经 URL 编码或 Base64 处理以规避特殊字符截断风险。同时,务必在连接池(如 HikariCP、Tomcat JDBC Pool)配置中启用 connectionInitSql 或 dataSourceProperties 显式初始化 client info,避免连接复用导致信息污染。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

868

2023.06.15

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

745

2023.07.05

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

741

2023.07.31

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

398

2023.08.01

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

440

2023.08.02

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

447

2023.08.02

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

431

2023.08.02

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

16948

2023.08.03

拼多多赚钱的5种方法 拼多多赚钱的5种方法
拼多多赚钱的5种方法 拼多多赚钱的5种方法

在拼多多上赚钱主要可以通过无货源模式一件代发、精细化运营特色店铺、参与官方高流量活动、利用拼团机制社交裂变,以及成为多多进宝推广员这5种方法实现。核心策略在于通过低成本、高效率的供应链管理与营销,利用平台社交电商红利实现盈利。

31

2026.01.26

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
SQL 教程
SQL 教程

共61课时 | 3.6万人学习

Java 教程
Java 教程

共578课时 | 51.7万人学习

oracle知识库
oracle知识库

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号