共用方式為

getClientConnectionID 方法 (SQLServerConnection)

  • 發行項

下載 JDBC 驅動程式

取得最新連接嘗試的連接識別碼，不論嘗試成功或失敗。

語法

public Java.util.UUID SQLServerConnection.getClientConnectionID();

傳回值

16 位元組 GUID，代表最新連接嘗試的連接識別碼。 如果起始連接要求以及預先登入交握之後發生失敗，則為 NULL。

例外狀況

SQLServerException

備註

如需存取擴充事件記錄檔中之診斷資訊的詳細資訊，請參閱存取擴充事件記錄檔中的診斷資訊。

下列範例會示範如何取得連接識別碼：

Connection con = DriverManager.getConnection(connectionUrl);  
UUID id = ((ISQLServerConnection)con).getClientConnectionId();

下列範例會示範另一種取得連接識別碼的方式：

SQLServerConnectionPoolDataSource ds = new SQLServerConnectionPoolDataSource();  
ds.setUser("...");  
ds.setPassword("...");  
ds.setServerName("...");  
PooledConnection pcon= ds.getPooledConnection();  
Connection cn = pcon.getConnection();  
UUID conid = ((ISQLServerConnection)cn).getClientConnectionId();

不論連線的伺服器版本為何，getClientConnectionID 皆可運作，但是擴充事件記錄檔以及連線通道緩衝區錯誤的相關項目，不會出現在 SQL Server 2008 R2 和先前版本中。

如果記錄連接識別碼的擴充事件已啟用，您就可以在擴充事件記錄檔中找出連接識別碼，以便查看失敗是否位於伺服器。 此外，您也可以針對特定連線錯誤，在連線信號緩衝區中找出連線識別碼 (透過連線信號緩衝區針對 SQL Server 2008 中的連線問題進行疑難排解)。 如果連接識別碼不在連接信號緩衝區中，您就可以假設發生網路錯誤。

另請參閱

SQLServerConnection 成員
SQLServerConnection 類別