# 迁移到 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 及更高版本：`OFF`、`ERROR`、`WARN`、`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, Amazon Glue, ProxyAPI, Query | 0,1 |
| 连接字符串示例 | MetadataRetrievalMethod=ProxyAPI; | QueryExternalCatalogs=1; |
## 连接测试
当您测试 ODBC 1.x 驱动程序连接时，该驱动程序会运行一个 `SELECT 1` 查询，以在 Amazon S3 存储桶中生成两个文件：一个用于结果集，另一个用于元数据。测试连接根据 [Amazon Athena 定价](https://www.amazonaws.cn/athena/pricing/)策略进行收费。
在测试 ODBC 2.x 驱动程序连接时，该驱动程序会调用 [GetWorkGroup](https://docs.amazonaws.cn/athena/latest/APIReference/API_GetWorkGroup.html) Athena API 操作。该调用使用您指定的身份验证类型和相应的凭证提供程序来检索凭证。在使用 ODBC 2.x 驱动程序时，不会收取连接测试费用，并且测试不会在 Amazon S3 存储桶中生成查询结果。