연결 복원력(JDBC)

JDBC 드라이버 다운로드

연결 복원력을 통해 JDBC 드라이버는 손상된 유휴 연결을 투명하게 복원하고 실패할 경우 초기 연결을 다시 시도할 수 있습니다. 이 문서에서는 이 동작을 제어하는 두 개의 연결 문자열 속성(connectRetryCount 및 connectRetryInterval)과 드라이버가 끊어진 유휴 연결을 감지하는 데 사용하는 keepalive 설정에 대해 설명합니다. 연결 복원력은 SQL Server Microsoft JDBC Driver 10.2.0부터 사용할 수 있습니다. 끊어진 유휴 연결을 다시 연결하려면 SQL Server 2014 이상 또는 Azure SQL Database 필요합니다.

JDBC 드라이버가 다시 시도되는 방법

JDBC 드라이버는 세 가지 독립적인 재시도 메커니즘을 제공합니다. 함께 작동하므로 한 번에 모두 사용할 수 있습니다.

초기 연결 다시 시도

JDBC 드라이버에는 초기 연결을 다시 시도하기 전에 드라이버가 대기하는 빈도와 시간을 제어하는 두 개의 연결 속성이 포함되어 있습니다. 이러한 속성을 연결 문자열 추가하거나 데이터 원본 속성을 통해 설정합니다.

connectRetryCount * connectRetryInterval가 loginTimeout보다 크면 드라이버는 loginTimeout에 도달하면 연결 시도를 중지합니다. 그렇지 않으면 connectRetryCount이 소진될 때까지 계속됩니다.

이러한 속성은 임시 연결 오류의 기본 제공 목록만 다시 시도합니다. 다루는 오류의 전체 목록(4060, 40197, 40501, 40613, 49918-49920 등)은 기본 제공 임시 연결 오류 목록을 참조하세요. 이 집합에 사용자 지정 오류 번호를 추가하거나 완전히 바꾸려면 retryConn에서 사용합니다. 실패한 명령문을 다시 시도하려면 같은 문서에서 retryExec을 사용하세요.

속성 설정

connectRetryCount 및 connectRetryInterval를 JDBC URL, Properties 개체 또는 SQLServerDataSource에서 설정합니다.

JDBC URL에서:

jdbc:sqlserver://server;databaseName=db;connectRetryCount=3;connectRetryInterval=10

Properties 개체와 함께. 이 문서의 Java 코드 조각은 간단히 하기 위해 가져오기 및 클래스 래퍼를 생략합니다.

Properties props = new Properties();
props.setProperty("user", "...");
props.setProperty("password", "...");
props.setProperty("connectRetryCount", "3");
props.setProperty("connectRetryInterval", "10");
Connection c = DriverManager.getConnection("jdbc:sqlserver://server;databaseName=db", props);

SQLServerDataSource 사용함:

SQLServerDataSource ds = new SQLServerDataSource();
ds.setServerName("server");
ds.setDatabaseName("db");
ds.setUser("...");
ds.setPassword("...");
ds.setConnectRetryCount(3);
ds.setConnectRetryInterval(10);

유휴 연결 끊김 감지

일반적인 유휴 연결은 연결 풀에 있는 연결입니다. 드라이버는 활동 없이 약 30초 후에 연결 유휴 상태로 간주합니다. 클라이언트와 서버 사이의 서버 또는 네트워크 디바이스는 유휴 연결을 닫을 수 있으므로 드라이버는 다음 쿼리가 실행되기 전에 소켓이 중지된 것을 확인할 수 있는 방법이 필요합니다.

끊어진 유휴 연결을 검색하기 위해 드라이버는 소켓 수준에서 TCP keepalive 패킷을 사용합니다. Linux 및 Java 11 이상에서는 드라이버가 keepalive 패킷을 30초 간격으로(KeepAliveTime) 자동으로 활성화하며, 실패가 발생하면 재시도 사이에 1초 지연을 둡니다(KeepAliveInterval).

제한 사항

다음 조건 중 어느 것이라도 충족되면 드라이버는 끊어진 유휴 연결을 복원할 수 없습니다.

• 완전히 구문 분석되거나 버퍼링되지 않은 개방형 결과 집합이 있습니다.
• 연결에서 데이터베이스를 Azure SQL 전환했습니다.
• 열려 있는 트랜잭션이 있습니다.

관련 콘텐츠

• 구성 가능한 재시도 논리(JDBC)
• Azure SQL 데이터베이스에 연결
• JDBC 드라이버의 시간 제한 속성 이해
• 기술 문서: 유휴 연결 복원성
• JDBC 드라이버 개요