共用方式為


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 類別