如何使用AWS凭证配置文件创建Amazon Athena的JDBC连接URL？

问题描述 #

尝试通过InstanceProfileCredentialsProvider或ProfileCredentialsProvider调用AWS配置文件中的凭证创建Amazon Athena的JDBC连接时，仅在连接字符串显式写入用户名和密码的情况下能成功连接；使用凭证提供类的连接串均报错：

java.sql.SQLException: Missing credentials error: Either UID/PWD or AwsCredentialsProviderClass must be provided.

可行的硬编码凭证连接字符串 #

jdbc:awsathena://AwsRegion=us-west-2;WorkGroup=primary;Catalog=AwsDataCatalog;
Database=default;S3OutputLocation=s3://fdsa-athena-data-store/;
User=AKIAEXAMPLE;Password=EXAMPLESECRET;

尝试过的无效连接字符串 #

• 使用InstanceProfileCredentialsProvider的连接串：

jdbc:awsathena://AwsRegion=us-west-2;WorkGroup=primary;Catalog=AwsDataCatalog;
Database=default;S3OutputLocation=s3://fdsa-athena-data-store/;AwsCredentialsProviderClass=com.simba.athena.amazonaws.auth.InstanceProfileCredentialsProvider;

• 使用ProfileCredentialsProvider的连接串：

jdbc:awsathena://AwsRegion=us-west-2;WorkGroup=primary;Catalog=AwsDataCatalog;
Database=default;S3OutputLocation=s3://fdsa-athena-data-store/;
AwsCredentialsProviderClass=com.simba.athena.amazonaws.auth.profile.ProfileCredentialsProvider;
AwsProfile=default;

解决方案 #

1. 升级JDBC驱动版本 #

确保使用Simba Athena JDBC驱动2.0.24及以上版本，旧版本对凭证提供类的识别存在兼容性问题，升级后可修复该报错。

2. 修正凭证提供类的路径 #

不同驱动版本的类路径存在差异：

• 对于v2.x版本驱动，ProfileCredentialsProvider的正确类路径为：com.simba.athena.amazonaws.auth.profile.ProfileCredentialsProvider
• 对于v1.x版本驱动，类路径需改为：com.amazonaws.auth.profile.ProfileCredentialsProvider

3. 验证AWS配置文件有效性 #

使用ProfileCredentialsProvider时，本地AWS配置文件需符合格式要求：

• 凭证文件路径：Linux/macOS为~/.aws/credentials，Windows为C:\Users\<用户名>\.aws\credentials，内容示例：

[default]
aws_access_key_id = AKIAEXAMPLE
aws_secret_access_key = EXAMPLESECRET

• 可选的区域配置文件~/.aws/config（或对应Windows路径）：

[default]
region = us-west-2

4. 正确的连接字符串示例 #

基于本地AWS配置文件的连接串（ProfileCredentialsProvider）

jdbc:awsathena://AwsRegion=us-west-2;WorkGroup=primary;Catalog=AwsDataCatalog;
Database=default;S3OutputLocation=s3://fdsa-athena-data-store/;
AwsCredentialsProviderClass=com.simba.athena.amazonaws.auth.profile.ProfileCredentialsProvider;
AwsProfile=default;

基于AWS实例角色的连接串（InstanceProfileCredentialsProvider，适用于EC2/EKS等AWS服务内环境）

jdbc:awsathena://AwsRegion=us-west-2;WorkGroup=primary;Catalog=AwsDataCatalog;
Database=default;S3OutputLocation=s3://fdsa-athena-data-store/;
AwsCredentialsProviderClass=com.simba.athena.amazonaws.auth.InstanceProfileCredentialsProvider;

5. 环境与权限检查 #

• 若在EC2实例上使用InstanceProfileCredentialsProvider，需确认实例已关联具备Athena访问权限的IAM角色，且实例元数据服务（IMDS）可正常访问。
• 本地环境使用ProfileCredentialsProvider时，确保运行程序的用户对.aws目录拥有读取权限。

内容的提问来源于stack exchange，提问作者Richard Camilo Saavedra Coneo