Teilen über


getClientConnectionID-Methode (SQLServerConnection)

JDBC-Treiber herunterladen

Ruft die Verbindungs-ID des letzten Versuchs der Verbindungsherstellung ab, wobei es keine Rolle spielt, ob dieser Versuch erfolgreich war oder fehlgeschlagen ist.

Syntax

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

Rückgabewert

Eine 16-Byte-GUID, die die Verbindungs-ID des letzten Verbindungsversuchs darstellt bzw. NULL, wenn nach dem Initiieren der Verbindungsanforderung und dem Voranmeldungshandshake ein Fehler aufgetreten ist.

Ausnahmen

SQLServerException

Bemerkungen

Weitere Informationen über den Zugriff auf Diagnoseinformationen im erweiterten Ereignisprotokoll finden Sie unter Zugreifen auf Diagnoseinformationen im erweiterten Ereignisprotokoll.

Das folgende Beispiel zeigt, wie die Verbindungs-ID abgerufen wird:

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

Das folgende Beispiel zeigt eine andere Methode zum Abrufen der Verbindungs-ID:

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

getClientConnectionID funktioniert unabhängig davon, mit welcher Serverversion Sie eine Verbindung herstellen, erweiterte Ereignisprotokolle und Einträge zu Fehlern bei Konnektivitätsringpuffern sind in SQL Server 2008 R2 und früher nicht verfügbar.

Wenn das erweiterte Ereignis zur Protokollierung der Verbindungs-ID aktiviert ist, können Sie die Verbindungs-ID im erweiterten Ereignisprotokoll suchen, um festzustellen, ob der Fehler auf dem Server aufgetreten ist. Bei bestimmten Verbindungsfehlern können Sie die Verbindungs-ID auch im Verbindungsringpuffer suchen (Connectivity troubleshooting in SQL Server 2008 with the Connectivity Ring Buffer (Behandeln von Verbindungsproblemen in SQL Server 2008 mit dem Verbindungsringpuffer)). Wenn die Verbindungs-ID nicht im Konnektivitätsringpuffer enthalten ist, ist von einem Netzwerkfehler auszugehen.

Weitere Informationen

SQLServerConnection-Elemente
SQLServerConnection-Klasse