View a markdown version of this page

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

Amazon Athena ODBC 2.x 发布说明

这些发布说明详细介绍了 Amazon Athena ODBC 2.x 驱动程序中的增强功能、特征、已知问题和工作流变更。

2.4.0.0

发布时间:2026 年 9 月 28 日

此版本包括自 2.2.0.1 版以来所做的更改。

修复

  • 修复了导致 SQLTables 和 SQLColumns 在架构中大约 200 及更高位置省略相应表的问题。当驱动程序在对元数据结果进行分页时连续收到两个空页时,就会出现这种情况。

  • 修复了导致来自 ADO.NET 应用程序(例如 Power BI)的空字符串筛选模式返回零行而非所有行的问题。现在,驱动程序将空字符串模式视为无限制,即匹配所有值。

  • 修复了导致 SQLColumns 在驱动程序无法识别的列类型(例如 uuid 或 json)上失败的问题。这些列现在报告了 SQL 类型 VARCHAR。TYPE_NAME 列继续报告 Athena 类型名称。

  • 修复了使用 SageMakerBrowserIdc 身份验证插件的连接在设置 SSOOIDCEndpointOverride 参数时停止响应直至身份提供商响应超时的问题。

  • 修复了使用 BrowserSSOOIDC 身份验证插件进行连接时致使驱动程序忽略 SSOEndpointOverride 参数的问题。

  • 修复了在代理执行 DNS 解析时,通过代理服务器建立的连接因域名系统(DNS)解析错误而失败的问题。Amazon SDK 内部创建的 HTTP 客户端现在使用驱动程序配置的代理设置。

  • 修复了未设置 TrustedCerts 参数时,导致 Linux 上传输层安全性(TLS)证书验证失败的问题。现在,驱动程序会在运行时定位 CA 捆绑包,并支持 CURL_CA_BUNDLE 和 SSL_CERT_FILE 环境变量。所解析的 CA 捆绑包也适用于 Amazon SDK 内部创建的 HTTP 客户端。

  • 修复了 Linux 驱动程序无法在配备 glibc 2.28 的发行版上进行安装的问题,包括 Red Hat Enterprise Linux 8 和 Rocky Linux 8。Linux 驱动程序现在基于 glibc 2.28 基准构建,需要 glibc 2.28 或更高版本。SUSE Linux Enterprise Server 15 上使用 SP3 或更高版本,该版本提供了兼容的 glibc 版本。

  • 修复了在已加载其他 OpenSSL 库(例如 R 环境)的主机应用程序加载驱动程序时,可能导致 Linux 驱动程序崩溃的问题。现在,该驱动程序将其导出符号限制为 ODBC API,这样其捆绑的加密库就不会受到主机应用程序的 OpenSSL 的影响。

  • 修复了导致驱动程序向没有 User-Agent 标头的身份提供商发送请求的问题。

    需要执行的操作:更改 User-Agent 标头

    此版本更改了 Athena、Amazon Glue、Amazon S3 和支持的身份提供商请求中的驱动程序 User-Agent 标头。Windows 集成身份验证继续使用浏览器 User-Agent。

    如果您在 IAM aws:UserAgent 策略条件、日志筛选条件或身份提供商登录规则中匹配驱动程序的 User-Agent,请将模式更新为 *lib/AmazonAthenaODBC#*。此模式与 Windows 集成身份验证请求不匹配。

  • 修复了 SageMakerBrowserIdc 和 BrowserSSOOIDC 身份验证可能在具有环境 Amazon 凭证的主机上产生失败的问题。驱动程序不再对这些插件使用的 SSO OIDC RegisterClient 和 CreateToken 请求进行 SigV4 签名。BrowserSSOOIDC 也不再对 SSO GetRoleCredentials 请求进行 SigV4 签名。CreateTokenWithIAM 请求仍保持 SigV4 签名状态。

  • 修复了可能导致 Amazon S3 结果提取出现短暂失败,并返回不完整结果的问题。当流以一个未终止的、带引号的多行 CSV 记录作为结尾时,这种问题还可能导致驱动程序停止响应。现在,驱动程序对每个块最多进行三次尝试。每次尝试都会从当前流偏移量中获取字节范围。在两次尝试的间隙,驱动程序会重新创建 Amazon S3 客户端,以便重试时可以使用刷新的凭证。非暂时性错误(例如拒绝访问)将直接返回,不会进行重试。如果结果文件过早结束,应用程序当前会收到 SQL_ERROR,而不是收到部分行且后面加上 SQL_NO_DATA。

  • 修复了驱动程序如何格式化与 SQLBindParameter 绑定的参数值的问题。现在,驱动程序将每个值作为类型化的 SQL 字面值进行发送,并转义其中的单引号,因此包含引号的值不再被视为查询的一部分。字符串参数不再封装在 CAST(value AS CHAR(n)) 中。现在,包含嵌入空字符的值会被拒绝,并返回 SQL_ERROR。此行为与 Amazon Athena JDBC 3.x 驱动程序一致。

    需要执行的操作:绑定字符串参数中存在尾随空格

    由于驱动程序不再将字符串参数作为 CHAR 值进行发送,因此与其比较将不再忽略尾随空格。诸如 WHERE column = ? 之类的谓词,以前会匹配那些列值仅在尾随空格上与绑定值不同的行,而现在返回的行数会变少。如果您的应用程序依赖于之前的行为,请去除比较的两端,例如 WHERE rtrim(column) = rtrim(?)。

  • 修复了导致绑定为“空”并附带 SQL_NULL_DATA 的参数发送为某个值而不是 NULL 的问题。空值 SQL_REAL、SQL_FLOAT 或 SQL_DOUBLE 参数被发送为 0.0。其他任何类型的空参数被发送为字符串 NULL。对于字符串参数,此值与包含文本 NULL 的行匹配。绑定空日期和时间参数的查询失败。现在,对于任何类型的空参数,驱动程序将发送 NULL。

  • 添加了可选的 UserAgentPrivacyMode 连接参数。将此参数设置为 1 可在身份提供商请求的 User-Agent 标头中忽略运行时环境元数据,同时保留 lib/AmazonAthenaODBC#<version>。向 Amazon 服务(包括 Athena、Amazon Glue 和 Amazon S3)发送的请求始终包含完整的 User-Agent 标头。

要下载新的 ODBC 版本 2 驱动程序,请参阅 ODBC 2.x 驱动程序下载。有关连接信息,请参阅 Amazon Athena ODBC 2.x。

2.2.0.1

发布时间:2026 年 7 月 6 日

修复

  • 修复了由于缺少 Content-Length 标头而导致某些基于浏览器的身份验证请求失败的问题。

  • 修复了在使用 SQL_C_WCHAR 绑定时导致查询参数被截断的问题。

  • 许可证文件现在包含对 Amazon 服务条款的引用。

要下载新的 ODBC 版本 2 驱动程序,请参阅 ODBC 2.x 驱动程序下载。有关连接信息,请参阅 Amazon Athena ODBC 2.x。

2.2.0.0

发布时间:2026 年 5 月 29 日

改进

  • SageMaker 身份验证 – 增加了对 SageMaker 身份验证插件 SageMakerBrowserIdc 和 SageMakerIam 的支持。您现在可以连接到 SageMaker 项目,并使用来自首选第三方工具的数据。有关更多信息,请参阅SageMaker 浏览器 IDC和SageMaker IAM。

  • 多目录浏览 — 增加了对智能湖仓功能的多目录浏览支持。该驱动程序现在可以在联合目录环境中发现并连接所有目录,从而支持通过 Amazon Athena 使用 S3 表和目录联合身份验证。

  • macOS 通用安装程序 — macOS 驱动程序现在作为单一通用二进制文件分发,同时支持 ARM 和 Intel 架构,从而简化了所有 Mac 硬件上的安装。

  • HTTP 客户端迁移 — 通过迁移到 Amazon SDK CRT HTTP 客户端,从 ODBC 二进制文件中移除了 libcurl 依赖项。CRT 客户端使用平台的原生 TLS 堆栈和系统信任存储,从而提高了连接可靠性,并消除了对 OpenSSL 和 zlib 的传递依赖项。

修复

  • 为 STS AssumeRole 增加了 ExternalId 支持,以用于跨账号角色代入。ExternalId 是从 Amazon 配置文件配置中读取的。

要下载新的 ODBC 版本 2 驱动程序,请参阅 ODBC 2.x 驱动程序下载。有关连接信息,请参阅 Amazon Athena ODBC 2.x。在 Windows 上安装 2.2.0.0 版本前,请先卸载之前的版本。

2.1.0.0

发布时间:2026 年 3 月 20 日

Amazon Athena Amazon Athena ODBC v2.1.0.0 驱动程序包含安全改进。此版本增强了身份验证流程、查询处理和传输安全性。建议尽快升级到此版本。

重大更改

  • 默认启用 SSL 证书验证:现在,驱动程序在连接到身份提供者时会强制执行 SSL 证书验证。如果您使用的本地身份提供者没有有效的 SSL 证书,则必须在连接字符串中显式设置 SSL_Insecure=1。有关更多信息,请参阅 SSL 不安全(IdP)。

  • 强制执行 TLS 1.2 或更高版本:驱动程序不再接受与身份提供者的 TLS 1.0 或 TLS 1.1 连接。所有 IdP 连接现在都需要 TLS 1.2 或更高版本。

  • BrowserSSOOIDC 身份验证流程已更新:BrowserSSOOIDC 插件现在使用 PKCE 授权码,而非设备代码授权。有一个新的可选参数 listen_port(默认值为 7890)可用于 OAuth 2.0 回调服务器。您可能需要将此端口添加到您的网络允许列表中。默认范围已更改为 sso:account:access。有关更多信息,请参阅 浏览器 SSO OIDC。

改进

  • BrowserSSOOIDC:从设备代码流程迁移到 PKCE 授权码以提高安全性。

  • BrowserAzureAD:在 OAuth 2.0 授权流程中添加了 PKCE(代码交换的证明密钥),以防止授权码截取攻击。

  • BrowserSAML:添加了 RelayState CSRF 保护以防止 SAML 令牌注入攻击。

  • 凭证缓存:从 v2.1.0.0 开始,缓存的凭证以纯文本 JSON 格式存储在 user-profile/.athena-odbc/ 目录中,文件权限仅限于拥有用户,这与 Amazon CLI 保护本地存储凭证的方式一致。

  • IAM 配置文件:除了现有 Ec2InstanceMetadata 之外,还增加了对 EcsContainer 和 Environment 凭证源的支持。

  • 连接字符串解析器:实现了正确的 ODBC }} 转义处理。

  • 目录查询:为架构名称和表模式添加了 SQL 标识符转义。

  • ODBC 模式匹配:将基于正则表达式的匹配替换为直接 ODBC LIKE 通配符匹配器。

  • XML 解析:为 SAML 令牌添加了递归深度限制(100 个级别)和大小限制(1MB)。

  • ADFS 身份验证:为 ADFS 服务器响应添加了响应大小限制(200KB)。

修复

  • 修复了身份验证组件中特殊元素的不当中和问题,该问题可能导致通过精心设计的连接参数执行代码或重定向身份验证流程。影响 BrowserSSOOIDC、BrowserAzureAD 和 BrowserSAML 插件。

  • 修复了查询处理组件中特殊元素的不当中和问题,该问题可能导致通过精心设计的表元数据进行拒绝服务攻击或 SQL 注入。

  • 修复了连接到身份提供者时证书验证不正确的问题。

  • 修复了基于浏览器的身份验证流程中缺失的身份验证安全控件,包括 OAuth 的 PKCE、SAML 的 CSRF 保护、安全凭证缓存和独占回调端口绑定。

  • 修复了解析组件中不受控制的资源消耗问题,该问题可能导致通过精心设计的输入模式、无限制的服务器响应或深度嵌套的 XML 有效载荷来进行拒绝服务攻击。

  • 修复了在 Power BI 导入模式下对跨账户联合目录使用 UseSingleCatalogAndSchema=1 时 SQLColumns 和 SQLTables 未返回任何结果的问题。

要下载新的 ODBC 版本 2 驱动程序,请参阅 ODBC 2.x 驱动程序下载。有关连接信息,请参阅 Amazon Athena ODBC 2.x。

2.0.6.0

发布时间:2025 年 11 月 21 日

改进

  • 浏览器可信身份传播身份验证插件:添加了新的身份验证插件,以支持基于浏览器的 OpenID Connect(OIDC)身份验证及可信身份传播。该插件通过默认浏览器处理完整的 OAuth 2.0 流程,自动提取 JSON Web 令牌(JWT),并与可信身份传播集成,从而提供无缝的身份验证体验。该插件专为单用户桌面环境而设计。有关启用和使用可信身份传播的信息,请参阅 What is trusted identity propagation?。

  • 增强的日志记录框架:通过以下方式显著改进了驱动程序的日志记录机制:

    • 除基本的 0/1 选项外,引入了更精细的日志级别

    • 删除冗余日志语句

    • 优化日志记录框架以包含与诊断相关的信息

    • 解决导致运营延误的性能问题

    • 启用日志记录时减少过多的日志文件生成

修复

  • 结果提取器优化:修复了将提取大小参数限制错误地应用于流式和非流式结果提取器的问题。现在,该限制仅正确应用于非流式结果提取器。

要下载新的 ODBC 版本 2 驱动程序,请参阅 ODBC 2.x 驱动程序下载。有关连接信息,请参阅 Amazon Athena ODBC 2.x。

2.0.5.1

发布时间:2025 年 10 月 13 日

修复

Amazon Athena ODBC 版本 2.0.5.1 驱动程序包含以下针对基于浏览器的身份验证插件的修复。

  • 实现了登录 URL 和架构检查验证。

  • 改进了 Linux 上的浏览器启动机制以利用系统 API,从而提高了稳定性和安全性。

要下载新的 ODBC 版本 2 驱动程序,请参阅 ODBC 2.x 驱动程序下载。有关连接信息,请参阅 Amazon Athena ODBC 2.x。

2.0.5.0

发布时间:2025 年 9 月 10 日

改进

  • JWT 可信身份提供者(TIP)身份验证插件:添加了新的身份验证插件,以支持 JWT 可信身份提供者(TIP)与 ODBC 驱动程序集成。通过此身份验证类型,您可以使用从外部身份提供者处获得的 JSON Web 令牌(JWT)作为连接参数,在 Athena 进行身份验证。使用 TIP,可以向 IAM 角色添加身份上下文,以识别请求访问 Amazon 资源的用户身份。有关启用和使用 TIP 的信息,请参阅 What is Trusted Identity Propagation?。

  • 自定义 SSO 管理端点支持:增加了对 ODBC 驱动程序中自定义 SSO 管理端点的支持。在 VPC 后面运行 ODBC 时,此增强功能可以为 SSO 服务指定自有端点。

  • AmazonSDK 版本更新:我们已将驱动程序中使用的 Amazon SDK 版本更新到 2.32.16,并更新了 2.0.5.0 版本的项目依赖关系。

2.0.4.0

发布时间:2025 年 6 月 17 日

Amazon Athena ODBC 版本 2.0.4.0 驱动程序包含以下改进和修复。

改进

  • 结果提取器 – 此驱动程序现在会自动选择方法来下载查询结果。这样在大多数情况下就无需手动配置提取器。有关更多信息,请参阅 结果提取器。

  • Curl 库已更新至 8.12.1。

修复

  • 修复了在连接到 STS 时 IAM 配置文件的代理配置。该修复允许使用 IAM 配置文件进行成功身份验证。

  • 读取带有身份验证插件的 IAM 配置文件的所有其他配置选项。这包括 UseProxyForIdP、SSL_Insecure、LakeformationEnabled 和 LoginToRP 以解决受影响插件的错误配置。

  • 通过允许接受可选的第二个参数来修复了 round 函数。它成功处理包含转义语法的查询。

  • 修复了 TIME WITH TIME ZONE 和 TIMESTAMP WITH TIME ZONE 数据类型的列大小。具有时间戳和时区数据类型的值不会被截断。

要下载新的 ODBC 版本 2 驱动程序,请参阅 ODBC 2.x 驱动程序下载。有关连接信息,请参阅 Amazon Athena ODBC 2.x。

2.0.3.0

发布时间:2024 年 4 月 8 日

Amazon Athena ODBC 版本 2.0.3.0 驱动程序包含以下改进和修复。

改进

  • Linux 和 Mac 平台上添加了对 Okta 身份验证插件的 MFA 支持。

  • 适用于 Windows 的 athena-odbc.dll 库和 AmazonAthenaODBC-2.x.x.x.msi 安装程序现在均已签名。

  • 更新了随驱动程序一起安装的 CA 证书 cacert.pem 文件。

  • 缩短了列出 Lambda 目录下的表所需的时间。对于 LAMBDA 目录类型,ODBC 驱动程序现在可以提交 SHOW TABLES 查询来获取可用表的列表。有关更多信息,请参阅 使用查询来列出表。

  • 引入了 UseWCharForStringTypes 连接参数,以便使用 SQL_WCHAR 和 SQL_WVARCHAR 来报告字符串数据类型。有关更多信息,请参阅 使用 WCHAR 作为字符串类型。

修复

  • 修复了使用 Get-OdbcDsn PowerShell 工具时出现的注册表损坏警告。

  • 更新了解析逻辑,以便处理查询字符串开头的注释。

  • 日期和时间戳数据类型现在允许年份字段为零。

要下载新的 ODBC 版本 2 驱动程序,请参阅 ODBC 2.x 驱动程序下载。有关连接信息,请参阅 Amazon Athena ODBC 2.x。

2.0.2.2

发布时间:2024 年 2 月 13 日

Amazon Athena ODBC 版本 2.0.2.2 驱动程序包含以下改进和修复。

改进

  • 添加了两个连接参数 StringColumnLength 和 ComplexTypeColumnLength,可用于更改字符串和复杂数据类型的默认列长度。有关更多信息,请参阅字符串列长度和复杂类型列长度。

  • 添加了对 Linux 和 macOS(英特尔和 ARM)操作系统的支持。有关更多信息,请参阅Linux和macOS。

  • AWS-SDK-CPP 已更新到 1.11.245 标签版本。

  • curl 库已更新到 8.6.0 版本。

修复

  • 解决了导致在精度列中类似字符串数据类型的结果集元数据中报告错误值的问题。

要下载 ODBC 版本 2 驱动程序,请参阅 ODBC 2.x 驱动程序下载。有关连接信息,请参阅 Amazon Athena ODBC 2.x。

2.0.2.1

发布时间:2023 年 12 月 7 日

Amazon Athena ODBC 版本 2.0.2.1 驱动程序包含以下改进和修复。

改进

  • 改进了所有接口的 ODBC 驱动程序线程安全性。

  • 启用日志记录后,现在会以毫秒精度记录日期时间值。

  • 在使用 浏览器 SSO OIDC 插件进行身份验证期间,终端现在会打开,向用户显示设备代码。

修复

  • 解决了在解析流式传输 API 的结果时出现的内存释放问题。

  • 针对接口 SQLTablePrivileges()、SQLSpecialColumns() SQLProcedureColumns() 和 SQLProcedures() 的请求现在会返回空结果集。

要下载 ODBC 版本 2 驱动程序,请参阅 ODBC 2.x 驱动程序下载。有关连接信息,请参阅 Amazon Athena ODBC 2.x。

2.0.2.0

发布时间:2023 年 10 月 17 日

Amazon Athena ODBC 版本 2.0.2.0 驱动程序包含以下改进和修复。

改进

  • 为浏览器 Azure AD、浏览器 SSO OIDC 和 Okta 基于浏览器的身份验证插件添加了文件缓存功能。

    像 Power BI 这样的 BI 工具和基于浏览器的插件会使用多个浏览器窗口。新的文件缓存连接参数允许在 BI 应用程序打开的多个进程之间缓存和重复使用临时凭证。

  • 现在,应用程序可以在准备好语句后查询有关结果集的信息。

  • 增加了默认连接和请求超时,以便在速度较慢的客户端网络中使用。有关更多信息,请参阅连接超时和请求超时。

  • 为 SSO 和 SSO OIDC 添加了端点覆盖。有关更多信息,请参阅 端点覆盖。

  • 添加了一个连接参数,可将身份验证请求的 URI 参数传递给 Ping。您可以使用此参数来绕过 Lake Formation 的单个角色限制。有关更多信息,请参阅 Ping URI 参数。

修复

  • 修复了使用基于行的绑定机制时出现的整数溢出问题。

  • 从浏览器 SSO OIDC 身份验证插件所需的连接参数列表中删除了超时。

  • 为 SQLStatistics()、SQLPrimaryKeys()、SQLForeignKeys() 和 SQLColumnPrivileges() 添加了缺少的接口,并添加了根据请求返回空结果集的功能。

要下载新的 ODBC 版本 2 驱动程序,请参阅 ODBC 2.x 驱动程序下载。有关连接信息,请参阅 Amazon Athena ODBC 2.x。

2.0.1.1

发布时间:2023 年 8 月 10 日

Amazon Athena ODBC 版本 2.0.1.1 驱动程序包含以下改进和修复。

改进

  • 在 Okta 身份验证插件中添加了 URI 日志记录。

  • 向外部凭证提供程序插件添加了首选角色参数。

  • 在 Amazon 配置文件的配置文件名称中添加了对配置文件前缀的处理。

修复

  • 更正了 Lake Formation 和 Amazon STS 客户端一起使用时出现的 Amazon Web Services 区域 使用问题。

  • 已将缺少的分区键还原到表列列表中。

  • 在 Amazon 配置文件中添加了缺少的 BrowserSSOOIDC 身份验证类型。

要下载新的 ODBC 版本 2 驱动程序,请参阅 ODBC 2.x 驱动程序下载。

2.0.1.0

发布时间:2023 年 6 月 29 日

Amazon Athena 发布了 ODBC 版本 2.0.1.0 驱动程序。

Athena 发布了一个新的 ODBC 驱动程序,该驱动程序改善了连接、查询和可视化来自兼容的 SQL 开发和商业智能应用程序的数据的体验。最新版本的 Athena ODBC 驱动程序支持现有驱动程序的功能,并且易于升级。新版本支持通过 Amazon IAM Identity Center 对用户进行身份验证。还提供了从 Amazon S3 读取查询结果的选项,这样就可以更快地获得查询结果。

有关更多信息,请参阅 Amazon Athena ODBC 2.x。