配置ODBC+SSL连接Heroku PostgreSQL后Tableau驱动加载失败求助

核心原因 #

Tableau（macOS版本）依赖内置的iODBC环境，与系统默认的ODBC配置路径、驱动命名规则存在差异，导致终端测试正常但Tableau无法识别驱动。

具体解决步骤 #

• 确认驱动路径准确性
  确保odbcinst.ini中配置的驱动路径与brew安装的psqlodbc Unicode驱动完全一致，路径通常为：

  [PostgreSQL Unicode]
  Driver = /usr/local/lib/psqlodbcw.so
  

  可通过find /usr/local -name psqlodbcw.so命令验证实际路径。

• 迁移ODBC配置文件到Tableau识别路径
  Tableau优先读取~/Library/ODBC/目录下的配置文件，执行以下命令迁移：

  cp /usr/local/etc/odbcinst.ini ~/Library/ODBC/
  cp ~/.odbc.ini ~/Library/ODBC/
  

• 严格匹配驱动名称
  确保odbc.ini中DSN的Driver字段值与odbcinst.ini中的驱动名称完全一致（包括大小写、空格）。例如：

  [ib3db]
  Driver = PostgreSQL Unicode
  Servername = your-heroku-host
  Port = 5432
  Database = your-db-name
  UID = your-user
  PWD = your-password
  SSLMODE = verify-ca
  

• 修复驱动文件权限
  确保驱动文件对Tableau进程有可读权限：

  chmod 755 /usr/local/lib/psqlodbcw.so
  

• 重启Tableau
  修改配置后必须完全关闭并重新打开Tableau，才能加载新的ODBC配置。

额外排查步骤 #

若上述操作无效，可通过Tableau内置的ODBC管理器验证：

1. 打开Tableau，点击顶部菜单栏的帮助 > 设置和性能 > 管理ODBC数据源
2. 在弹出的iODBC管理器中，切换到驱动程序标签，确认PostgreSQL Unicode驱动已显示且路径正确
3. 切换到用户DSN标签，选中ib3db并点击测试，查看是否能正常连接

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