为什么Oracle AWR报告中SQL模块名显示为JDBC Thin Client

胖静酱_3233

胖静酱_3233

2026-09-29

341人浏览

原创

awr报告中sql的module列为“jdbc thin client”是jdbc thin驱动初始化连接时硬编码通报的默认值,需在执行sql前调用connection.setclientinfo("module", "...")(oracle 11.2+有效)或通过connection-init-sql调用dbms_application_info.set_module方可覆盖;该变更仅影响后续sql,且受限于ash采样频率与保留窗口。

为什么oracle awr报告中sql模块名显示为jdbc thin client

AWR报告里SQL的MODULE列显示为jdbc thin client,不是配置错误,也不是驱动缺陷,而是JDBC Thin驱动在建立连接时默认向数据库通报自身身份的行为结果。

为什么Thin驱动会填这个值

JDBC Thin驱动在初始化连接时,会通过OCI协议的OCISessionBegin调用向Oracle服务端传递客户端元信息,其中module字段由驱动内部硬编码设定为"jdbc thin client"(Oracle官方驱动源码可验证)。这个值不随应用代码里的setClientInfo("Module", "...")覆盖——除非显式调用setClientInfo()且数据库版本 ≥ 11.2,否则AWR捕获到的就是默认字符串。

  • 该行为与OCI驱动不同:OCI驱动通常继承操作系统进程名或由ORACLE_HOME/ORACLE_SID环境变量推导出模块名
  • 从Oracle 10g起,V$SESSION和DBA_HIST_ACTIVE_SESS_HISTORY中的MODULE字段即来源于此通报,AWR报告直接聚合这些历史快照数据
  • 即使应用层使用Spring Boot + HikariCP,只要底层用的是标准ojdbc8.jar或更高版本,且未主动设置模块名,就一定会看到这个值

如何让模块名变成你想要的业务标识

必须在获取连接后、执行SQL前,调用JDBC标准接口Connection.setClientInfo(),且需确保数据库兼容性:

Crypto Sniper Oracle
Crypto Sniper Oracle

机构级量化市场预言机,提供订单簿失衡(OBI)、VWAP分析、自动化报告及Telegram预警。

下载
  • Oracle 11.2及以上版本支持该方法写入V$SESSION.MODULE;低于11.2的版本调用无效,仍显示jdbc thin client
  • 示例代码:
    connection.setClientInfo("ApplicationName", "order-service");
    connection.setClientInfo("Module", "payment-process");
    connection.setClientInfo("Action", "submit-payment");
  • 若用连接池(如HikariCP),需配置connection-init-sql执行DBMS_APPLICATION_INFO.SET_MODULE,例如:CALL DBMS_APPLICATION_INFO.SET_MODULE('inventory-api', 'stock-check')

为什么改了还是没出现在AWR里

常见原因不是代码没写,而是时间窗口或采样精度问题:

  • AWR默认每小时采样一次V$SESSION,而setClientInfo()只影响当前会话的内存状态;如果SQL执行很快(毫秒级),可能根本没被ASH采样到,自然也不会进WRH$_ACTIVE_SESSION_HISTORY表
  • DBA_HIST_ACTIVE_SESS_HISTORY中MODULE字段只保留最近1小时的活跃会话快照(默认),旧快照已归档,新报告查不到
  • 确认是否真的生效:在SQL*Plus中执行SELECT MODULE FROM V$SESSION WHERE SID = SYS_CONTEXT('USERENV','SID');,返回值应是你设的值,而非jdbc thin client

最易被忽略的一点:模块名变更只对后续执行的SQL生效,已提交的SQL语句在AWR中永远保留它最初执行时的MODULE值。哪怕你在事务中途调用setClientInfo(),之前那几条SQL在AWR里还是jdbc thin client。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

oracle

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
oracle清空表数据
oracle清空表数据

当表中的数据不需要时,则应该删除该数据并释放所占用的空间。本专题为大家提供oracle清空表数据的相关文章,帮助大家解决该问题。

2023.08.16

861

5

Oracle中declare的使用
Oracle中declare的使用

Oracle DECLARE语句是PL/SQL编程语言中用于声明变量、常量、游标或异常的关键字。它的主要作用是在程序中定义这些对象,以便在后续的代码中使用。DECLARE语句的语法简单明了,可以根据需要声明多个对象。通过使用这些声明的对象,可以进行各种操作,如计算、查询数据库、处理异常等 。

2023.09.15

2353

5

oracle怎么分页
oracle怎么分页

实现分页的步骤:1、使用ROWNUM进行分页查询;2、在执行查询之前进行设置分页参数;3、使用"COUNT(*)"函数来获取总行数,并使用"CEIL"函数来向上取整计算总页数;4、在外部查询中使用"WHERE"子句来筛选出特定的行号范围,以实现分页查询。想了解更多oracle怎么分页的文章,可以来阅读本专题先的文章。

2023.09.18

2390

5

Oracle查看表操作历史记录
Oracle查看表操作历史记录

查看操作历史记录的方法:1、使用Oracle内置的审计功能,可以记录数据库中发生的各种操作,包括登录、DDL语句、DML语句等;2、使用Oracle日志文件,其中包含了数据库中发生的各种操作,可以通过查看日志文件来获取操作历史记录;3、使用Oracle的Flashback功能,可以查看数据库在某个时间点的操作历史记录;4、使用第三方工具等。本专题还提供其他查看表操作的文章,大家可以免费阅读。

2023.09.19

1389

3

Oracle中RAC的用法
Oracle中RAC的用法

Oracle中RAC的用法:1、通过在多个服务器上运行数据库实例来提供高可用性;2、允许在需要时增加或减少节点数量;3、通过将工作负载分布到多个节点上来实现负载均衡;4、使用共享存储来实现多个节点之间的数据共享;5、允许多个节点同时处理数据库请求,从而实现并行处理;6、提供了透明故障切换功能;7、使用了一些技术来确保数据的一致性;8、提供了管理工具来简化RAC环境的管理和维护。本专题还提供RAC相关的其他文章,大家可以免费阅读。

2023.09.19

1973

7

oracle imp
oracle imp

imp是Oracle数据库中的一个命令行工具,用于将导出的数据和对象从一个数据库实例导入到另一个数据库实例。imp命令的一般语法为“imp username/password@connect_string file=file_name [options]”。

2023.09.19

2569

4

常用的数据库软件
常用的数据库软件

常用的数据库软件有MySQL、Oracle、SQL Server、PostgreSQL、MongoDB、Redis、Cassandra、Hadoop、Spark和Amazon DynamoDB。更多关于数据库软件的内容详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.02

4169

19

oracle通配符有哪些
oracle通配符有哪些

oracle通配符有“%”、“_”、“[]”和“[^]"。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.08

237

5

oracle四舍五入怎么操作
oracle四舍五入怎么操作

oracle四舍五入操作可以使用ROUND函数来实现,其语法为“ROUND(number, decimal_places)”,其中,number是要进行四舍五入的数值,decimal_places是指定的小数位数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.14

666

5

热门下载

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

精品课程

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