連線到 Azure SQL 資料庫

  • 發行項

下載 JDBC 驅動程式

本文討論使用 Microsoft JDBC Driver for SQL Server 連線到 Azure SQL Database 時發生的問題。 如需連線到 Azure SQL Database 的詳細資訊，請參閱：

詳細資料

若要連線到 Azure SQL Database，您應連線至 master 資料庫以呼叫 SQLServerDatabaseMetaData.getCatalogs。
Azure SQL Database 不支援從使用者資料庫傳回整組目錄。 SQLServerDatabaseMetaData.getCatalogs 會使用 sys.databases 檢視來取得目錄。 請參閱 sys.databases (Transact-SQL) 中關於權限的討論，以了解 Azure SQL Database 上的 SQLServerDatabaseMetaData.getCatalogs 行為。

登入逾時

連線到 Azure SQL Database 時，建議的預設 loginTimeout 為 30 秒。 如果您要連線到無伺服器執行個體，建議您使用 60 秒以上的較長 loginTimeout。 如果無伺服器執行個體已閒置，可能需要一些時間來喚醒初始連線。 如需如何設定 loginTimeout 的詳細資訊，請參閱設定連線屬性。

連線中斷

連線到 Azure SQL Database 時，網路元件 (例如防火牆) 可能會在一段時間沒有活動之後終止閒置連線。 在此內容中，有兩種閒置連接類型：

  • TCP 層閒置，其中任何數目的網路裝置都可能會卸除連接。

  • 因 Azure SQL 閘道而閒置，可能會出現 TCP 保持運作訊息 (使連線從 TCP 觀點而言未閒置)，但在 30 分鐘內沒有使用中查詢。 在此狀況下，閘道會在 30 分鐘時判定 TDS 連線閒置並結束連線。

若要解決第二點並避免閘道終止閒置連線，您可以：

  • 使用重新導向連線原則來設定您的Azure SQL 資料來源。

  • 透過輕量活動讓連線保持作用中狀態。 不建議使用此方法，應只在沒有其他可能的選擇時使用。

若要解決第一點並避免網路元件卸除閒置連線，請在載入該驅動程式的作業系統上設定下列登錄設定或其非 Windows 的對等項目：

登錄設定 建議值
HKEY_LOCAL_MACHINE \ SYSTEM \ CurrentControlSet \ Services \ Tcpip \ Parameters \ KeepAliveTime 30000
HKEY_LOCAL_MACHINE \ SYSTEM \ CurrentControlSet \ Services \ Tcpip \ Parameters \ KeepAliveInterval 1000
HKEY_LOCAL_MACHINE \ SYSTEM \ CurrentControlSet \ Services \ Tcpip \ Parameters \ TcpMaxDataRetransmissions 10

重新啟動電腦，讓這些登錄設定生效。

KeepAliveTime 與 KeepAliveInterval 值是以毫秒為單位。 這些設定會導致 10 到 40 秒內沒有回應的連線中斷連線。 如果在傳送「保持運作」封包之後沒有收到任何回應，則會每秒重試一次，最多 10 次。 如果在這段時間內沒有收到任何回應，就會中斷用戶端通訊端的連線。 視環境而定，建議您增加 KeepAliveInterval 以配合可能導致伺服器超過 10 秒無法回應的已知中斷情形 (例如虛擬機器移轉)。

注意

在 Windows Vista 或 Windows 2008 與更新版本上，無法控制 TcpMaxDataRetransmissions。

若要在 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 Database，您必須將伺服器名稱附加至連接字串中的 UserId。 例如 user@servername。 從 Microsoft JDBC Driver for SQL Server 4.0 版開始，您不再需要將 @servername 附加至連接字串中的 UserId。

使用加密需要設定 hostNameInCertificate

在 Microsoft JDBC Driver for SQL Server 7.2 版之前，連線到 Azure SQL Database 時，如果您指定了 encrypt=true (如果連接字串中的伺服器名稱為 shortName.domainName，請將 hostNameInCertificate 屬性設定為 *.domainName)，則應該指定 hostNameInCertificate。 從驅動程式 7.2 版開始，這個屬性是選擇性的。

例如：

jdbc:sqlserver://abcd.int.mscds.com;databaseName=myDatabase;user=myName;password=myPassword;encrypt=true;hostNameInCertificate=*.int.mscds.com;

另請參閱

使用 JDBC 驅動程式連線到 SQL Server