

 Amazon Redshift 將不再支援從修補程式 198 開始建立新的 Python UDFs。現有 Python UDF 將繼續正常運作至 2026 年 6 月 30 日。如需詳細資訊，請參閱[部落格文章](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 設定 記錄
<a name="jdbc20-configuring-logging"></a>

您可以在驅動程式中開啟日誌記錄功能，以協助診斷問題。

您可以使用下列方法記錄驅動程式資訊：
+ 若要將記錄的資訊儲存在 .log 檔案中，請參閱[使用日誌檔案](jdbc20-using-log-files.md)。
+ 若要將記錄的資訊傳送到 DriverManager 中指定的 LogStream 或 LogWriter，請參閱[使用 LogStream 或 LogWriter](jdbc20-logstream-option.md)。

您要在連線 URL 中提供組態資訊給驅動程式。如需連線 URL 語法的相關資訊，請參閱[建置連線 URL](jdbc20-build-connection-url.md)。

# 使用日誌檔案
<a name="jdbc20-using-log-files"></a>

日誌記錄功能應該要開啟到足以找到問題的時間長度就好。日誌記錄功能會降低效能，而且還會消耗大量磁碟空間。

在連線 URL 中設定 LogLevel 機碼以開啟日誌記錄功能，並指定日誌檔案中包含的詳細資訊數量。下表列出 Amazon Redshift JDBC 驅動器 2.x 版所提供的日誌記錄層級 (排序方式為最不詳細到最詳細)。


| LogLevel 值 | Description | 
| --- | --- | 
|  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
<a name="jdbc20-logstream-option"></a>

日誌記錄功能應該要開啟到足以找到問題的時間長度就好。日誌記錄功能會降低效能，而且還會消耗大量磁碟空間。

在連線 URL 中設定 LogLevel 機碼以開啟日誌記錄功能，並指定傳送至 DriverManager 中所指定 LogStream 或 LogWriter 的詳細資訊數量。

**若要開啟使用 LogStream 或 LogWriter 的日誌記錄功能：**

1. 若要設定驅動程式以記錄描述驅動程式進度的一般資訊，請將 LogLevel 屬性設定為 1 或 INFO。

1. 若要確保新設定生效，請重新啟動 JDBC 應用程式並重新連線至伺服器。