Snowflake ODBC如何配置密钥对认证替代PWD完成数据库连接

场景说明 #

已可通过.odbc.ini配置实现Snowflake数据库的密码认证连接，常规可正常工作的配置参考如下：

[snowflake]
Description=SnowflakeDB
Driver=SnowflakeDSIIDriver
Locale=en-US
SERVER=ourco.us-east-1.snowflakecomputing.com
PORT=443
SSL=on
ACCOUNT=ourco.us-east-1
UID=MY_NAME
PWD=$MyPassword

实际需求为替换明文密码认证逻辑，改用密钥对认证方式完成ODBC连接。前期准备工作已完成：

• 按照密钥对认证流程生成RSA格式密钥对
• 将生成的公钥上传至Snowflake对应用户账户，完成绑定关系配置

初步调整的.odbc.ini配置如下，连接测试过程中连续触发多类报错：

[snowflake]
Description=SnowflakeDB
Driver=SnowflakeDSIIDriver
Locale=en-US
SERVER=ourco.us-east-1.snowflakecomputing.com
PORT=443
SSL=on
UID=MY_NAME
ACCOUNT=ourco.us-east-1
PRIV_KEY_FILE=/home/rstudio-blah/keys/rsa_key.p8 # 私钥存储路径
SNOWSQL_PRIVATE_KEY_PASSPHRASE=potatoes{ # 非真实私钥口令

连接阶段的报错依次为：

1. 未添加额外认证配置时，触发报错：

   Error: nanodbc/nanodbc.cpp:1021: 00000: [unixODBC][Snowflake][DSI] (20032) Required setting 'PWD' is not present in the connection settings.

2. 为绕过校验添加空值PWD=配置项后，触发新报错：

   Error: nanodbc/nanodbc.cpp:1021: 00000: [unixODBC][Snowflake][Snowflake] (31)
   Password not found.

3. 增加AUTHENTICATOR=SNOWFLAKE_JWT配置项后，触发新报错：

   Error: nanodbc/nanodbc.cpp:1021: 00000: [unixODBC][Snowflake][Snowflake] (44)
   Error finalize setting: Marshaling private key failed.

核心诉求：梳理正确的ODBC配置方法，实现基于密钥对认证（而非明文PWD密码）的Snowflake数据库稳定连接。 #

问题根因分析 #

• 未显式指定认证方式时，Snowflake ODBC驱动默认走密码认证流程，会强制校验PWD参数，即使配置了密钥对相关参数，也不会触发JWT认证逻辑，直接报缺少PWD的错误
• 添加空值PWD配置时，驱动仍停留在密码认证流程内校验密码有效性，因无有效密码值触发密码缺失报错
• 配置AUTHENTICATOR=SNOWFLAKE_JWT后报私钥解析失败，核心原因包括：
  • 私钥相关配置参数名错误，驱动无法正确识别私钥路径与私钥口令
  • 私钥文件格式、权限不符合驱动读取要求
  • 配置项语法错误（如参数值多余特殊字符）

正确配置流程 #

1. 私钥文件合规性校验
   • 确保生成的私钥为PEM编码的PKCS#8格式：无加密的私钥文件开头为-----BEGIN PRIVATE KEY-----，带加密的私钥文件开头为-----BEGIN ENCRYPTED PRIVATE KEY-----
   • 调整私钥文件权限为仅所有者可读，执行命令chmod 600 /home/rstudio-blah/keys/rsa_key.p8，避免驱动因权限开放范围过大拒绝读取
   • 清除私钥文件内多余的空行、非标准注释内容，保证文件格式符合PEM编码要求
2. 调整.odbc.ini配置
   按照如下结构填写配置，移除多余特殊字符，替换所有不符合驱动要求的参数名：

   [snowflake]
   Description=SnowflakeDB
   Driver=SnowflakeDSIIDriver
   Locale=en-US
   SERVER=ourco.us-east-1.snowflakecomputing.com
   PORT=443
   SSL=on
   ACCOUNT=ourco.us-east-1
   UID=MY_NAME
   # 显式指定密钥对认证方式，驱动将自动跳过PWD参数校验
   AUTHENTICATOR=SNOWFLAKE_JWT
   # 指定私钥文件存储路径
   PRIV_KEY_FILE=/home/rstudio-blah/keys/rsa_key.p8
   # 带加密的私钥需要配置对口令参数，参数名必须与驱动要求一致
   PRIVATE_KEY_PWD=你的实际私钥口令
   

3. 连接测试注意事项
   • 不需要额外添加空值PWD配置项，只要正确指定认证方式为SNOWFLAKE_JWT，驱动会自动跳过密码校验流程
   • 逐行检查配置文件内的参数值，避免出现之前配置中私钥口令值后多余的{这类语法错误，防止驱动配置解析失败

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