文档主页
MySQL Connector/J 开发者指南
相关文档 下载本手册
PDF (US Ltr) - 1.2Mb
PDF (A4) - 1.2Mb


6.3.14 调试/分析

  • logger

    用于记录消息的实现 'com.mysql.cj.log.Log' 的类的名称。(默认为 'com.mysql.cj.log.StandardLogger',它记录到 STDERR)。

    默认值 com.mysql.cj.log.StandardLogger
    版本 3.1.1
  • profilerEventHandler

    实现接口 'com.mysql.cj.log.ProfilerEventHandler' 的类的名称,该接口将用于处理分析/跟踪事件。

    默认值 com.mysql.cj.log.LoggingProfilerEventHandler
    版本 5.1.6
  • useNanosForElapsedTime

    对于测量经过时间的分析/调试功能,驱动程序是否应尝试使用纳秒分辨率?

    默认值 false
    版本 5.0.7
  • maxQuerySizeToLog

    控制在分析或跟踪时将记录的查询部分的最大长度。

    默认值 2048
    版本 3.1.3
  • maxByteArrayAsHex

    预处理语句中转换为十六进制字面量的字节数组参数的最大大小,该字面量由 'JdbcPreparedStatement.toString()' 插值。任何大于此值的字节数组都将被通用地插值为“**字节数组数据**”。

    默认值 1024
    版本 8.0.31
  • profileSQL

    将查询及其执行/获取时间跟踪到配置的 'profilerEventHandler'。

    默认值 false
    版本 3.1.0
  • logSlowQueries

    是否应将执行时间超过 'slowQueryThresholdMillis' 或由 'autoSlowLog' 监控检测到的查询报告给已注册的 'profilerEventHandler'?

    默认值 false
    版本 3.1.2
  • slowQueryThresholdMillis

    如果启用了 'logSlowQueries',则查询应在记录为慢速查询之前花费多长时间(以毫秒为单位)?

    默认值 2000
    版本 3.1.2
  • slowQueryThresholdNanos

    如果启用了 'logSlowQueries','useNanosForElapsedTime' 设置为“true”,并且此属性设置为非零值,则驱动程序将使用此阈值(以纳秒为单位)来确定查询是否缓慢。

    默认值 0
    版本 5.0.7
  • autoSlowLog

    不是使用 'slowQueryThreshold*' 来确定查询是否足够慢以至于需要记录,而是维护允许驱动程序确定超出第 99 个百分点的查询的统计信息?

    默认值 true
    版本 5.1.4
  • explainSlowQueries

    如果启用了 'logSlowQueries',驱动程序是否应自动在服务器上发出 'EXPLAIN' 并将结果发送到配置的记录器(警告级别)?

    默认值 false
    版本 3.1.2
  • gatherPerfMetrics

    驱动程序是否应收集性能指标,并每隔 'reportMetricsIntervalMillis' 毫秒通过配置的记录器报告它们?

    默认值 false
    版本 3.1.2
  • reportMetricsIntervalMillis

    如果启用了 'gatherPerfMetrics',则应多久记录一次(以毫秒为单位)?

    默认值 30000
    版本 3.1.2
  • logXaCommands

    驱动程序是否应将 'MysqlXaConnection' 发送到服务器的 XA 命令记录到 DEBUG 级别的日志中?

    默认值 false
    版本 5.0.5
  • traceProtocol

    是否应在 TRACE 级别记录网络协议?

    默认值 false
    版本 3.1.2
  • enablePacketDebug

    启用后,将保留一个 'packetDebugBufferSize' 数据包的环形缓冲区,并在驱动程序代码的关键区域中抛出异常时转储该缓冲区。

    默认值 false
    版本 3.1.3
  • packetDebugBufferSize

    'enablePacketDebug' 为“true”时要保留的最大数据包数。

    默认值 20
    版本 3.1.3
  • useUsageAdvisor

    驱动程序是否应向 'profilerEventHandler' 发出使用警告,建议正确有效地使用 JDBC 和 MySQL Connector/J?

    默认值 false
    版本 3.1.1
  • resultSetSizeThreshold

    如果 'useUsageAdvisor' 为“true”,则在驱动程序警告结果集可疑地大之前,结果集应包含多少行?

    默认值 100
    版本 5.0.5
  • autoGenerateTestcaseScript

    驱动程序是否应将其正在执行的 SQL(包括服务器端预处理语句)转储到 STDERR?

    默认值 false
    版本 3.1.9
  • openTelemetry

    驱动程序是否应生成 OpenTelemetry 跟踪并处理到 MySQL 服务器的上下文传播?此选项接受值“REQUIRED”、“PREFERRED”和“DISABLED”。如果设置为“REQUIRED”,则 OpenTelemetry 库必须在运行时可用,否则与 MySQL 服务器的连接将失败。将其设置为“DISABLED”将关闭 Connector/J 生成 OpenTelemetry 检测。将其设置为“PREFERRED”可以在运行时提供 OpenTelemetry 库的情况下启用生成 OpenTelemetry 检测,否则会发出警告。未为此属性设置值等效于将其设置为“PREFERRED”,但在运行时没有 OpenTelmetry 库可用时不会发出警告。Connector/J 完全依赖于调用应用程序中配置的 OpenTelemetry 导出器,并且不提供任何配置其自身导出器的方法。

    默认值 PREFERRED
    版本 8.4.0