通过 JDBC 驱动程序使用 Athena - Amazon Athena
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

通过 JDBC 驱动程序使用 Athena

您可以使用 JDBC 连接将 Athena 连接到商业智能工具和其他应用程序,例如 。要执行此操作,请使用此页面上的 Amazon S3 链接下载、安装和配置 Athena JDBC 驱动程序。有关许可的更多信息,请参阅 通过 JDBC 和 ODBC 连接访问。从版本 2.0.24 开始,有两个版本的驱动程序可用:一个包括 Amazon SDK,一个不包括。

重要

使用 JDBC 驱动程序时,请务必注意以下要求:

  • 保留端口 444 — 保留 Athena 用于流式传输查询结果的端口 444,对出站流量开放。当您使用 PrivateLink 终端节点连接到 Athena 时,请确保附加到 PrivateLink 终端节点的安全组在端口 444 上对入站流量开放。如果端口 444 被阻止,您可能会收到错误消息 [Simba][AthenaJDBC](100123) An error has occurred. Exception during column initialization([Simba][AthenaJDBC](100123) 出现错误。列初始化期间出现异常)。

  • athena:GetQueryResultsStream 策略 — 将 athena:GetQueryResultsStream 策略操作添加到使用 JDBC 驱动程序的 IAM 主体。此策略操作并不通过 API 直接公开。它仅作为流式传输结果的一部分与 ODBC 和 JDBC 驱动程序配合使用。有关策略示例,请参阅 Amazon 托管策略:AWSQuicksightAthenaAccess

  • 4.1 驱动程序 –停止支持 JDBC 版本 4.1 的驱动程序,同时也将不会发布进一步的更新。如果您使用的是 JDBC 4.1 驱动程序,我们强烈建议您迁移到 4.2 驱动程序。指向 4.1 JDBC 版本的链接将从下一个日历年开始移除。

带有 Amazon SDK 的 JDBC 驱动程序

JDBC 驱动程序版本 2.0.32 符合 JDBC API 4.1 和 4.2 数据标准。有关检查您使用的 Java 运行时环境 (JRE) 版本的信息,请参阅 Java 文档。JRE 版本取决于该驱动程序所用的 JDBC API 版本。

下载与您的 JDK 版本和 JDBC 数据标准匹配的驱动程序:

以下 .zip 文件下载包含适用于 JDBC 4.1 和 4.2 的 .jar 文件,且包括 Amazon SDK。

不带 Amazon SDK 的 JDBC 驱动程序

JDBC 驱动程序版本 2.0.32 符合 JDBC API 4.1 和 4.2 数据标准。有关检查您使用的 Java 运行时环境 (JRE) 版本的信息,请参阅 Java 文档。JRE 版本取决于该驱动程序所用的 JDBC API 版本。

下载与您的 JDK 版本和 JDBC 数据标准匹配的驱动程序。这些文件不包括 Amazon SDK:

以下 .zip 文件下载包含适用于 JDBC 4.1 和 4.2 的 .jar 文件。不包括 Amazon SDK。

JDBC 驱动程序发行说明、许可协议和版权声明

下载所需要的版本后,请阅读发布说明,查看许可协议和版权声明。

JDBC 驱动程序文档

下载驱动程序的以下文档:

JDBC 驱动程序注释

将 JDBC 驱动程序用于多个数据目录

若要将 JDBC 驱动程序用于 Athena 的多个数据目录(例如,当使用外部 Hive 元存储或者联合查询),则将 MetadataRetrievalMethod=ProxyAPI 包括在您的 JDBC 连接字符串中。

指定中国地区的端点

在中国区域将 Athena 与 JDBC 结合使用时,请使用 EndpointOverride= 和端点格式 athena.aws-region.amazonaws.com.cn,以在 JDBC URL 中指定您的区域端点。

以下示例指定了中国(北京)区域的终端节点。

jdbc:awsathena://EndpointOverride=athena.cn-north-1.amazonaws.com.cn:443;AwsRegion=cn-north-1;