다음을 통해 공유


getClientConnectionID 메서드(SQLServerConnection)

JDBC 드라이버 다운로드

연결 시도가 성공 또는 실패했는지 여부에 관계 없이 최근 연결 시도의 연결 ID를 가져옵니다.

구문

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

Return Value

가장 최근에 연결을 시도한 연결 ID를 나타내는 16바이트 GUID입니다. 또는 연결 요청이 시작된 후 실패하거나 사전 로그인 핸드셰이크가 있을 경우 NULL입니다.

예외

SQLServerException

설명

확장 이벤트 로그의 진단 정보 액세스에 대한 자세한 내용은 확장 이벤트 로그의 진단 정보 액세스를 참조하세요.

다음 예제는 연결 ID를 가져오는 방법을 설명합니다.

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

다음 예제는 연결 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는 연결하는 서버의 버전에 상관없이 작동하지만 확장 이벤트 로그 및 연결 링 버퍼 오류에 대한 항목은 SQL Server 2008 R2 이전 버전에 표시되지 않습니다.

연결 ID 로깅이 활성화되어 있는 확장 이벤트이고 서버에서 실패가 발생한 경우 확장 이벤트 로그에서 연결 ID를 찾아 확인할 수 있습니다. 특정 연결 오류의 경우 연결 링 버퍼(연결 링 버퍼를 사용하여 SQL Server 2008의 연결 문제 해결)에서 연결 ID를 찾을 수도 있습니다. 연결 ID가 연결 링 버퍼에 없는 경우 네트워크 오류를 가정해 볼 수 있습니다.

참고 항목

SQLServerConnection 멤버
SQLServerConnection 클래스