迁移到 ODBC 2.x 驱动程序 - Amazon Athena
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

迁移到 ODBC 2.x 驱动程序

由于大多数 Athena ODBC 2.x 连接参数都与 ODBC 1.x 驱动程序向后兼容,因此您可以在 Athena ODBC 2.x 驱动程序中重用大部分现有连接字符串。但是,需要修改以下连接参数。

日志级别

虽然当前 ODBC 驱动程序提供了一系列可用日志记录选项,从 LOG_OFF (0)LOG_TRACE (6),但 Amazon Athena ODBC 驱动程序只有两个值:0(禁用)和 1(启用)。

有关记录 ODBC 2.x 驱动程序的更多信息,请参阅 日志记录选项

ODBC 1.x 驱动程序 ODBC 2.x 驱动程序
连接字符串名称 LogLevel LogLevel
参数类型 可选 可选
默认值 0 0
可能的值 0-6 0,1
连接字符串示例 LogLevel=6; LogLevel=1;

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 定价策略进行收费。

在测试 ODBC 2.x 驱动程序连接时,该驱动程序会调用 GetWorkGroup Athena API 操作。该调用使用您指定的身份验证类型和相应的凭证提供程序来检索凭证。在使用 ODBC 2.x 驱动程序时,不会收取连接测试费用,并且测试不会在 Amazon S3 存储桶中生成查询结果。