本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
移轉至 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 1.x 驅動程式 | ODBC 2.x 驅動程式 | |
|---|---|---|
| 連線字串名稱 | LogLevel |
LogLevel |
| 參數類型 | 選用 | 選用 |
| 預設值 | 0 |
OFF |
| 可能的值 | 0-6 |
對於 2.0.6.0 之前的版本： 對於 2.0.6.0 |
| 連線字串範例 | 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 定價
當您測試 ODBC 2.x 驅動程式連線時，驅動程式會呼叫 GetWorkGroup Athena API 動作。呼叫會使用您指定的身分驗證類型和對應的憑證提供者來擷取憑證。使用 ODBC 2.x 驅動程式時，可免費使用連線測試，且測試不會在您的 Amazon S3 儲存貯體中產生查詢結果。
