Apache Superset连接Athena时，如何转义密钥中的斜杠？

我在使用Apache Superset连接Amazon Athena时，遇到了连接字符串中斜杠“/”的转义问题。根据官方文档，采用pyathena的连接字符串格式：

awsathena+rest://{aws_access_key_id}:{aws_secret_access_key}@athena.{region_name}.amazonaws.com/{schema_name}?s3_staging_dir={s3_staging_dir}&...

我按该格式配置的连接字符串如下：

awsathena+rest://KDB45:199USqN/88C13Cw/VVCdGC0k@athena.us-west-2.amazonaws.com/prod-ak?s3_staging_dir=s3://abc/def

但出现错误：

An error occurred while creating databases: Connection failed, please check your connection settings

问题出在我的AWS密钥包含斜杠：

199USqN/88C13Cw/VVCdGC0k

我尝试了以下转义方法均无效：

• 双反斜杠转义：

  awsathena+rest://KDB45:199USqN/\\88C13Cw/\\VVCdGC0k@athena.us-west-2.amazonaws.com/prod-ak?s3_staging_dir=s3://abc/def
  

• 手动替换单个斜杠为%2F：

  awsathena+rest://KDB45:199USqN%2F/88C13Cw%2F/VVCdGC0k@athena.us-west-2.amazonaws.com/prod-ak?s3_staging_dir=s3://abc/def
  

• 使用Python的urllib库编码（操作不当）：

  urllib.quote("P@ssword")
  

另外尝试替换s3://为s3%3A//也无效。请问该如何正确转义连接字符串中的斜杠？

解决方案 #

1. 对整个AWS密钥进行完整URL编码 #

问题在于你之前只转义了部分斜杠，或者编码方式不对。需要对整个密钥字符串进行URL编码，而不是手动替换个别字符：

• Python 2环境使用urllib.quote()：

  import urllib
  secret_key = "199USqN/88C13Cw/VVCdGC0k"
  encoded_key = urllib.quote(secret_key)
  # 输出：199USqN%2F88C13Cw%2FVVCdGC0k
  

• Python 3环境使用urllib.parse.quote()：

  from urllib.parse import quote
  secret_key = "199USqN/88C13Cw/VVCdGC0k"
  encoded_key = quote(secret_key)
  # 输出：199USqN%2F88C13Cw%2FVVCdGC0k
  

2. 替换到连接字符串的正确格式 #

将编码后的密钥替换到连接字符串中，最终格式如下：

awsathena+rest://KDB45:199USqN%2F88C13Cw%2FVVCdGC0k@athena.us-west-2.amazonaws.com/prod-ak?s3_staging_dir=s3://abc/def

3. 更优方案：使用IAM角色替代硬编码密钥 #

如果你的Superset部署在AWS环境（比如ECS、EC2），建议直接给实例绑定具有Athena访问权限的IAM角色，不需要在连接字符串中硬编码密钥，既避免转义问题，也提升安全性。

内容的提问来源于stack exchange，提问作者AB21