本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
配置 日志记录
您可以在驱动程序中启用日志记录以帮助诊断问题。
您可以使用以下方法记录驱动程序信息:
-
要将记录的信息保存在 .log 文件中,请参阅使用 日志文件。
-
要将记录的信息发送到 LogStream 中指定的 LogWriter 或 DriverManager,请参阅使用 LogStream 或LogWriter。
您可以在连接 URL 中向驱动程序提供配置信息。有关连接 URL 语法的更多信息,请参阅构建连接 URL。
使用 日志文件
您应仅启用日志记录以足够长的时间来捕获问题。日志记录会降低性能并会占用大量磁盘空间。
在连接 URL 中设置 LogLevel 键以启用日志记录,并指定包含在日志文件中的详细信息的数量。下表列出了 Amazon Redshift JDBC 驱动程序版本 2.0 提供的日志记录级别,这些级别按详细程度从低到高详细程度排列。
LogLevel 值 | 描述 |
---|---|
1 |
记录将导致驱动程序中止的严重错误事件。 |
2 |
记录可能允许驱动程序继续运行的错误事件。 |
3 |
如果未执行操作,则记录可能导致错误的日志事件。 |
4 |
记录描述驱动程序进度的一般信息。 |
5 |
记录有助于调试驱动程序的详细信息。 |
6 |
记录所有驱动程序活动。 |
启用使用日志文件的日志记录
-
将 LogLevel 属性设置为要包含在日志文件中的所需信息级别。
-
将 LogPath 属性设置为您要将日志文件保存到的文件夹的完整路径。
例如,以下连接 URL 启用日志记录级别 3 并将日志文件保存在 C:\\temp 文件夹中:
jdbc:redshift://redshift.company.us-west- 1.redshift.amazonaws.com:9000/Default;DSILogLevel=3; LogPath=C:\temp
-
要确保新设置生效,请重新启动 JDBC 应用程序并重新连接到服务器。
JDBC 驱动程序在 Amazon Redshift 属性指定的位置生成以下日志文件:LogPath
-
记录非特定于连接的驱动程序活动的 redshift_jdbc.log 文件。
-
与数据库进行的每个连接对应的 redshift_jdbc_connection_[Number].log 文件,其中 [Number] 是一个标识每个日志文件的数字。此文件记录特定于连接的驱动程序活动。
-
如果 LogPath 值无效,则驱动程序将记录的信息发送到标准输出流 (System.out
)
使用 LogStream 或LogWriter
仅启用日志记录足够长以捕获问题。日志记录会降低性能并会占用大量磁盘空间。
在连接 URL 中设置 LogLevel 键以启用日志记录,并指定发送到 LogStream 中指定的 LogWriter 或 DriverManager 的详细信息的数量。
要启用使用 LogStream 或 LogWriter 的日志记录,请执行以下操作:
-
要配置驱动程序以记录描述驱动程序进度的一般信息,请将 LogLevel 属性设置为 1 或 INFO。
-
要确保新设置生效,请重新启动 JDBC 应用程序并重新连接到服务器。
要禁用使用 LogStream 或 LogWriter 的日志记录,请执行以下操作:
-
从连接 URL 中删除 LogLevel 属性。
-
要确保新设置生效,请重新启动 JDBC 应用程序并重新连接到服务器。