JDBC 跟踪配置
如果应用程序显示与 JDBC 相关的异常消息,请激活 JDBC 跟踪服务。生成的日志文本可以帮助您识别该问题。
通过管理控制台为大多数数据库 JDBC 实现打开跟踪;有关指示信息,请参阅“在服务器启动时启用跟踪”主题。
通过管理控制台为大多数数据库 JDBC 实现打开跟踪;有关指示信息,请参阅“启用跟踪”一文。
此方法可对指定服务器中运行的所有应用程序激活 JDBC 跟踪。通过选择跟踪组 WAS.database 和在控制台中输入下列跟踪字符串之一来标识数据库类型:
- com.ibm.ws.database.logwriter 使用 GenericDataStoreHelper 的数据库的跟踪字符串。还可以将此跟踪字符串用于不受支持的数据库。
- com.ibm.ws.db2.logwriter DB2® 数据库的跟踪字符串。
- com.ibm.ws.oracle.logwriter Oracle 数据库的跟踪字符串。
- com.ibm.ws.db2.logwriter Derby 数据库的跟踪字符串。
- com.ibm.ws.informix.logwriter Informix® 数据库的跟踪字符串。
- com.ibm.ws.sqlserver.logwriter Microsoft SQL Server 数据库的跟踪字符串。
- com.ibm.ws.sybase.logwriter Sybase 数据库的跟踪字符串。
一些 JDBC 驱动程序要求在数据源级别对跟踪进行不同的设置。这些驱动程序包含:
- Microsoft SQL Server JDBC 驱动程序
- 用于 MS SQL Server 的 DataDirect Connect for JDBC 驱动程序
通过数据源定制属性设置对前面提到的 JDBC 驱动程序的跟踪。例如,使用 spyAttributes 定制数为 DataDirect Connect for JDBC 驱动程序启用 JDBC 跟踪。有关对 JDBC 实现启用跟踪的定制属性的详细信息,请参阅驱动程序文档。
特定于提供程序的配置
一些 JDBC 提供程序具有一些定制属性和配置设置,可用于调整其跟踪设置。
- DB2 数据源含 DB2 Data Server Driver for JDBC and SQLJ 的数据源定制属性是:
- traceLevel
traceLevel 的可能值包括:
- TRACE_NONE = 0
- TRACE_CONNECTION_CALLS = 1
- TRACE_STATEMENT_CALLS = 2
- TRACE_RESULT_SET_CALLS = 4
- TRACE_DRIVER_CONFIGURATION = 16
- TRACE_CONNECTS = 32
- TRACE_DRDA_FLOWS = 64
- TRACE_RESULT_SET_META_DATA = 128
- TRACE_PARAMETER_META_DATA = 256
- TRACE_DIAGNOSTICS = 512
- TRACE_SQLJ = 1024
- TRACE_XA_CALLS = 2048
- TRACE_META_CALLS = 8192
- TRACE_DATASOURCE_CALLS = 16384
- TRACE_LARGE_OBJECT_CALLS = 32768
- TRACE_SYSTEM_MONITOR = 131072
- TRACE_TRACEPOINTS = 262144
- TRACE_ALL = -1
避免故障: 跟踪 Statement 调用将集合中的用户数据展示给 PreparedStatement 对象,跟踪 ResultSet 调用将展示从 ResultSet 对象中返回的数据。gotcha
- traceFile
- 指定将 DB2 Data Server Driver for JDBC and SQLJ 跟踪与应用程序服务器的跟踪功能进行集成:
- 如果不设置值,那么将跟踪集成。如果使用集成跟踪,那么可以动态启用或禁用跟踪,方法是在运行时在应用程序服务器的跟踪规范中设置以下属性:
WAS.database=all
- 如果将 traceFile 属性设置为文件的有效路径名,那么“数据服务器驱动程序”跟踪将写入到指定文件,无论应用程序服务器的跟踪规范如何都是如此。
- 如果不设置值,那么将跟踪集成。
- traceFileAppend
- 指定附加或覆盖由 traceFile 属性指定的文件:
- 要附加到当前文件,请将此属性设置为 true。
- 要覆盖当前文件,请将此属性设置为 false。
避免故障: 如果更改 traceLevel、traceFile 或 traceFileAppend 的值,那么必须重新启动应用程序服务器以使用更改的设置来实例化新的数据源对象。gotcha
其他资源
如果 JDBC 跟踪服务无法帮助您找出并解决问题,请访问 WebSphere® Application Server 的 IBM® 支持 Web 站点。使用该站点的搜索功能来查找有关已知问题及其解决办法的最新信息。找到适当的故障诊断技巧可以节省时间,否则可能要花时间来打开和跟踪 PMR。