PERL通过Simba JDBC连接Databricks时发生认证传输错误

算力阿峰

2026-10-25

核心问题定位

你遇到的Invalid status 21、Broken pipe报错，本质是Simba驱动根本没和Databricks的HTTPS thrift接口完成TLS握手，根源是三个配置完全错配：

本地端口与远端端口概念混淆
DBD::JDBC模块的工作原理是：在本地拉起一个常驻Java进程做桥接，Perl代码通过本地端口和这个Java进程通信，再由Java进程通过JDBC驱动发起对外连接。代码里写的9001只是这个本地桥接进程的监听端口，和远端Databricks服务没有任何关系。但你额外在jdbc_properties里传了host.port=9001，强制让Simba驱动去连Databricks的9001端口——Databricks托管服务根本不会在9001端口开明文thrift服务，这个连接请求发出去就会被服务端直接断开，直接触发管道破裂错误。
重复传入冲突的连接参数
你已经在JDBC URL里完整写了所有远端连接信息：host是443端口的HTTPS地址、认证方式、用户名密码、httpPath。但你又通过jdbc_properties结构体传入了一套user、password、host.port参数，驱动解析配置时会优先读取properties里的参数值，直接把本来要连的443 HTTPS端口改成了9001明文端口，和URL里的配置完全冲突。
认证参数本身是对的，错的是传输层
你用的AuthMech=3、UID=token、PWD填个人访问令牌的配置完全符合Databricks PAT认证的要求，根本不需要换无认证、单用户名这些模式，所有认证模式尝试都失败的原因，是连接根本没到认证那一步，就在TCP/TLS握手阶段被断开了。

修正方案

按照下面的调整改代码即可正常连接：

保留本地桥接的本地监听端口（比如9001只要本地没被占用，随便用），绝对不要把这个端口值传给Simba驱动作为远端连接端口
把所有和JDBC URL重复的properties配置全部删掉，所有远端连接参数统一在JDBC URL里配置，不要重复传
确认JDBC URL完全匹配Databricks的连接要求：远端地址是443端口，开启SSL，HTTP传输模式，httpPath和控制台复制的完全一致

修正后的可运行代码参考：

#!/usr/bin/perl
use strict;
use DBI;

# 本地桥接端口：仅用于Perl和本地Java桥接进程通信，无其他作用
my $local_bridge_port = 9001;
my $databricks_host = "你的工作区名.azuredatabricks.net";

# 所有远端连接参数统一写在JDBC URL里，不要重复传递
my $jdbc_url = "jdbc:spark://$databricks_host:443/default;"
             . "transportMode=http;"
             . "ssl=1;"
             . "httpPath=sql/protocolv1/o/你的工作区ID/你的SQL Warehouse计算ID;"
             . "AuthMech=3;"
             . "UID=token;"
             . "PWD=你的个人访问令牌字符串";

# DSN仅配置本地桥接的连接信息，不在这里传任何远端连接参数
my $dsn = "dbi:JDBC:hostname=127.0.0.1;port=$local_bridge_port;url=$jdbc_url";
my $dbh = DBI->connect($dsn, undef, undef, {
    PrintError => 0,
    RaiseError => 1,
}) or die "连接失败: ($DBI::err) $DBI::errstr\n";

my $sql = "select * from 你的目标表";
my $sth = $dbh->prepare($sql);
$sth->execute();
while (my @row = $sth->fetchrow_array) {
    print join(", ", @row), "\n";
}

上线前验证清单

确认本地9001端口没有被其他程序占用，避免Java桥接进程启动失败
逐字符核对JDBC URL里的httpPath，确保没有截断、没有多余空格，和Databricks控制台SQL Warehouse连接页复制的路径完全一致
确认个人访问令牌在有效期内，且对应账号有目标表的查询权限
确认运行Perl代码的机器可以正常访问Databricks主机的443端口，没有防火墙、出站代理拦截HTTPS请求

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