从补丁 198 开始，Amazon Redshift 将不再支持创建新的 Python UDF。现有的 Python UDF 将继续正常运行至 2026 年 6 月 30 日。有关更多信息，请参阅[博客文章](https://www.amazonaws.cn/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)。

# 配置日志记录


您可以在驱动程序中打开日志记录以帮助诊断问题。

您可以使用以下方法记录驱动程序信息：
+ 要将记录的信息保存在 .log 文件中，请参阅 [使用日志文件](jdbc20-using-log-files.md)。
+ 要将记录的信息发送到 DriverManager 中指定的 LogStream 或 LogWriter，请参阅 [使用 LogStream 或 LogWriter](jdbc20-logstream-option.md)。

在连接 URL 中将配置信息提供给驱动程序。有关连接 URL 的语法的更多信息，请参阅 [构建连接 URL](jdbc20-build-connection-url.md)。

# 使用日志文件


只有打开足够长的日志记录才能捕获问题。日志记录会降低性能，并会占用大量磁盘空间。

在连接 URL 中设置 LogLevel 键以打开日志记录并指定包含在日志文件中的详细信息量。下表列出了 Amazon Redshift JDBC 驱动程序版本 2.x 提供的日志记录级别，按从最不详细到最详细的顺序排列。


| LogLevel 值 | 描述 | 
| --- | --- | 
|  1  |  记录将导致驱动程序中止的严重错误事件。  | 
|  2  |  记录也许不会导致驱动程序中止运行的错误事件。  | 
|  3  |  记录在未执行操作时可能导致错误的事件。此日志记录级别和高于此级别的日志记录级别也会记录用户的查询。  | 
|  4  |  记录描述驱动程序进程的一般信息。  | 
|  5  |  记录用于调试驱动程序的详细信息。  | 
|  6  |  记录所有驱动程序活动。  | 

**要设置使用日志文件的日志记录**

1. 将 LogLevel 属性设置为要包含在日志文件中的所需信息级别。

1. 将 LogPath 属性设置为您要保存日志文件的目标文件夹的完整路径。

   例如，以下连接 URL 启用日志记录级别 3 并将日志文件保存在 C:\$1temp 文件夹中：`jdbc:redshift://redshift.company.us-west- 1.redshift.amazonaws.com:9000/Default;DSILogLevel=3;LogPath=C:\temp`

1. 要确保新设置生效，请重新启动 JDBC 应用程序并重新连接到服务器。

   Amazon Redshift JDBC 驱动程序在 LogPath 属性中指定的位置生成以下日志文件：
   +  redshift\$1jdbc.log 文件，该文件记录不特定于连接的驱动程序活动。
   + 与数据库建立的每个连接的 redshift\$1jdbc\$1connection\$1[Number].log 文件，其中 [Number] 是标识每个日志文件的编号。此文件记录特定于连接的驱动程序活动。

如果 LogPath 值无效，则驱动程序将记录的信息发送到标准输出流（`System.out`）

# 使用 LogStream 或 LogWriter


只有打开足够长的日志记录才能捕获问题。日志记录会降低性能，并会占用大量磁盘空间。

在连接 URL 中设置 LogLevel 键以打开日志记录，并指定发送到 DriverManager 中指定的 LogStream 或 LogWriter 的详细信息量。

**要打开使用 LogStream 或 LogWriter 的日志记录：**

1. 要将驱动程序配置为记录描述驱动程序进度的一般信息，请将 LogLevel 属性设置为 1 或 INFO。

1. 要确保新设置生效，请重新启动 JDBC 应用程序并重新连接到服务器。