本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 移轉至 ODBC 2.x 驅動器
由於大多數的 Athena ODBC 2.x 連線參數都與 ODBC 1.x 驅動程式向後相容，因此您可以搭配 Athena ODBC 2.x 驅動程式重複使用大多數現有的連線字串。但是，下列連線參數需要修改。
## 日誌層級
雖然目前的 ODBC 驅動程式提供了一系列可用的記錄選項，但從 `LOG_OFF (0)`到 `LOG_TRACE (6)`，Amazon Athena ODBC 2.x 驅動程式最初只有兩個值：0 （停用） 和 1 （啟用）。從 2.0.6.0 版開始，驅動程式現在支援更精細的記錄層級與增強的記錄功能：
+ `OFF` - 已停用記錄
+ `ERROR` - 只會記錄錯誤訊息
+ `WARN` - 記錄警告訊息和錯誤
+ `INFO` - 記錄資訊性訊息、警告和錯誤
+ `DEBUG` - 記錄詳細的偵錯資訊以及所有較低層級的訊息
+ `TRACE` - 記錄的最詳細層級，包括所有訊息
如需有關記錄 ODBC 2.x 驅動程式的詳細資訊，請參閱 [記錄選項](odbc-v2-driver-logging-options.md)。
****
| | ODBC 1.x 驅動程式 | ODBC 2.x 驅動程式 |
| --- | --- | --- |
| 連線字串名稱 | LogLevel | LogLevel |
| 參數類型 | 選用 | 選用 |
| 預設值 | 0 | OFF |
| 可能的值 | 0-6 | 對於 2.0.6.0 之前的版本： `0,1`
對於 2.0.6.0 `WARN`版和更新版本：`OFF`、`ERROR`、`INFO`、`DEBUG`、 `TRACE` |
| 連線字串範例 | LogLevel=6; | LogLevel=INFO; |
**注意**
在 2.0.6.0 版及更新版本中，日誌架構已經過最佳化，可減少操作延遲和產生過多日誌檔案，同時透過這些精細日誌層級提供更詳細的診斷資訊。每個關卡都包含其下方關卡的所有訊息。
## MetadataRetrievalMethod
目前的 ODBC 驅動程式提供數個選項，以便從 Athena 擷取中繼資料。Amazon Athena ODBC 驅動程序取代了 `MetadataRetrievalMethod`，並始終使用 Amazon Athena API 來擷取中繼資料。
Athena 推出旗標 `QueryExternalCatalogs`，用於查詢外部目錄。若要使用目前的 ODBC 驅動程式查詢外部目錄，請將 `MetadataRetrievalMethod` 設定為 `ProxyAPI`。若要使用 Athena ODBC 驅動程式查詢外部目錄，請將 `QueryExternalCatalogs` 設定為 `1`。
****
| | ODBC 1.x 驅動程式 | ODBC 2.x 驅動程式 |
| --- | --- | --- |
| 連線字串名稱 | MetadataRetrievalMethod | QueryExternalCatalogs |
| 參數類型 | 選用 | 選用 |
| 預設值 | Auto | 0 |
| 可能的值 | Auto, AWS Glue, ProxyAPI, Query | 0,1 |
| 連線字串範例 | MetadataRetrievalMethod=ProxyAPI; | QueryExternalCatalogs=1; |
## 連線測試
當您測試 ODBC 1.x 驅動程式連線時，驅動程式會執行 `SELECT 1` 查詢，在 Amazon S3 儲存貯體中產生兩個檔案：一個用於結果集，另一個用於中繼資料。測試連線是根據 [Amazon Athena 定價](https://aws.amazon.com/athena/pricing/)政策收費。
當您測試 ODBC 2.x 驅動程式連線時，驅動程式會呼叫 [GetWorkGroup](https://docs.aws.amazon.com/athena/latest/APIReference/API_GetWorkGroup.html) Athena API 動作。呼叫會使用您指定的身分驗證類型和對應的憑證提供者來擷取憑證。使用 ODBC 2.x 驅動程式時，可免費使用連線測試，且測試不會在您的 Amazon S3 儲存貯體中產生查詢結果。