getClientConnectionID 方法 (SQLServerConnection)
取得最新連接嘗試的連接識別碼,不論嘗試成功或失敗。
語法
public Java.util.UUID SQLServerConnection.getClientConnectionID();
傳回值
16 位元組 GUID,代表最新連接嘗試的連接識別碼。 如果起始連接要求以及預先登入交握之後發生失敗,則為 NULL。
例外狀況
備註
如需存取擴充事件記錄檔中之診斷資訊的詳細資訊,請參閱存取擴充事件記錄檔中的診斷資訊。
下列範例會示範如何取得連接識別碼:
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 中的連線問題進行疑難排解)。 如果連接識別碼不在連接信號緩衝區中,您就可以假設發生網路錯誤。