本文介绍了在使用 Microsoft JDBC Driver for SQL Server 连接到 Azure SQL 数据库时遇到的问题。 若要详细了解如何连接到 Azure SQL 数据库,请参阅:
详细信息
若要连接到 Azure SQL 数据库,应连接到 master 数据库,以调用 SQLServerDatabaseMetaData.getCatalogs。
Azure SQL 数据库 不支持从用户数据库中返回整个目录集。 SQLServerDatabaseMetaData.getCatalogs 使用 视图来获取目录。 要理解 Azure SQL 数据库 上的 SQLServerDatabaseMetaData.getCatalogs 行为,请参见 sys.databases 中权限的讨论。
登录超时值
连接Azure SQL数据库时,loginTimeout默认30秒是合理的起点。 对于启用了自动暂停的 Azure SQL 数据库无服务器版,请将其调高,以便在数据库恢复期间能够承受驱动程序的连接重试。 欲了解更多信息,请参见 连接自动暂停的无服务器数据库。 要设置 loginTimeout,请参见 设置连接属性。
连接已断开
当你连接到 Azure SQL 数据库 时,网络组件(如防火墙)可能会在一段时间的闲置连接后终止。 在此背景下,空闲连接有两种类型:
TCP 层出现空闲,在此情形下,任意数量的网络设备都可以删除连接。
处于 Azure SQL Gateway 的空闲状态,此时可能正在发生 TCP keepalive 消息(这使得从 TCP 角度来看连接并非空闲),但在 30 分钟内没有进行过任何活动查询。 在这种情况下,网关将确定 TDS 连接处于空闲状态已有 30 分钟,因此将中止连接。
若要解决第二个问题并避免网关终止空闲连接,可以执行以下操作:
为了解决第一个问题并避免网络组件删除空闲连接,请在加载驱动程序的操作系统上设置以下注册表设置(或非 Windows 的等效设置):
注意
从 Microsoft JDBC Driver for SQL Server 版本 10.2 开始,驱动程序会自动在数据库连接期间创建的套接字上设置以下保持活动值,替代下表中定义的 OS 默认值。 此自动设置仅在支持设置套接字保持活动选项的 Java 版本上执行。 在 Linux 和 macOS 上,Java 8+ 的最新更新支持此设置。 在 Windows 上,Java 17+ 的最新更新支持此设置。
| 注册表设置 | 建议值 |
|---|---|
| HKEY_LOCAL_MACHINE \ SYSTEM \ CurrentControlSet \ Services \ Tcpip \ Parameters \ KeepAliveTime | 30000 |
| HKEY_LOCAL_MACHINE \ SYSTEM \ CurrentControlSet \ Services \ Tcpip \ 参数 \ KeepAliveInterval | 1000 |
| HKEY_LOCAL_MACHINE \ SYSTEM \ CurrentControlSet \ Services \ Tcpip \ 参数 \ TcpMaxDataRetransmissions | 10 |
重启计算机,注册表设置才能生效。
KeepAliveTime 和 KeepAliveInterval 值以毫秒为单位。 这些设置会使无响应的连接在 10 到 40 秒内断开连接。 如果在发送保持连接数据包后没有收到响应,则每秒会重试一次,最多可重试 10 次。 如果在该时间段内未收到响应,则客户端套接字会断开连接。 根据你的环境,你可能想要增加 KeepAliveInterval 以适应已知中断(例如虚拟机迁移),这可能会导致服务器无响应时间超过 10 秒。
注意
TcpMaxDataRetransmissions 在 Windows Vista 或 Windows 2008 及更高版本上无法控制。
若要在 Azure VM 中配置此功能,请创建启动任务以添加注册表项。 例如,将以下启动任务添加到服务定义文件:
<Startup>
<Task commandLine="AddKeepAlive.cmd" executionContext="elevated" taskType="simple">
</Task>
</Startup>
然后将 AddKeepAlive.cmd 文件添加到您的项目。 将“复制到输出目录”设置为“始终复制”。 以下脚本是一个 AddKeepAlive.cmd 文件示例:
if exist keepalive.txt goto done
time /t > keepalive.txt
REM Workaround for JDBC keep alive on Azure SQL
REG ADD HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters /v KeepAliveTime /t REG_DWORD /d 30000 >> keepalive.txt
REG ADD HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters /v KeepAliveInterval /t REG_DWORD /d 1000 >> keepalive.txt
REG ADD HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters /v TcpMaxDataRetransmissions /t REG_DWORD /d 10 >> keepalive.txt
shutdown /r /t 1
:done
在连接字符串中将服务器名称附加到 userId 后面
在 Microsoft JDBC Driver for SQL Server 4.0 版之前,若要连接到 Azure SQL 数据库,必须在连接字符串中将服务器名称追加到 UserId 后面。 例如 user@servername。 从 Microsoft JDBC Driver for SQL Server 4.0 版本开始,已不再需要在连接字符串中的 UserId 后追加 @servername。
使用加密需要设置 hostNameInCertificate
在 Microsoft JDBC Driver for SQL Server 7.2 版之前,若要连接到 Azure SQL 数据库,如果指定了 encrypt=true,则应指定 hostNameInCertificate(如果连接字符串中的服务器名称为 shortName.domainName,请将 hostNameInCertificate 属性设置为 *.domainName。) 此属性是驱动程序版本 7.2 的可选属性。
例如:
jdbc:sqlserver://abcd.int.mscds.com;databaseName=myDatabase;user=myName;password=<password>;encrypt=true;hostNameInCertificate=*.int.mscds.com;