Resiliência de conexão (JDBC)

Baixar driver JDBC

A resiliência da ligação permite ao driver JDBC restaurar de forma transparente uma ligação inativa avariada e tentar novamente a ligação inicial se esta falhar. Este artigo aborda as duas propriedades da cadeia de ligação que controlam este comportamento (connectRetryCount e connectRetryInterval) e as definições de keepalive que o driver utiliza para detetar uma ligação de repouso interrompida. A resiliência de ligação está disponível a partir do Microsoft JDBC Driver 10.2.0 para SQL Server. Reconectar uma ligação inativa avariada requer o SQL Server 2014 ou posterior, ou o Base de Dados SQL do Azure.

Como o controlador JDBC faz novas tentativas

O controlador JDBC dispõe de três mecanismos de retentativa independentes. Funcionam em conjunto, por isso pode usar todos ao mesmo tempo:

Tentar novamente as conexões iniciais

O driver JDBC inclui duas propriedades de ligação que controlam com que frequência e quanto tempo o driver espera antes de tentar novamente a ligação inicial. Adicione estas propriedades à cadeia de ligação ou defina-as através das propriedades da fonte de dados.

Se connectRetryCount * connectRetryInterval for maior que loginTimeout, o condutor para de tentar ligar assim que loginTimeout é alcançado. Caso contrário, continua até que connectRetryCount se esgote.

Estas propriedades repetem apenas a lista integrada de erros transitórios de ligação. Para a lista completa de erros abordados (4060, 40197, 40501, 40613, 49918-49920, entre outros), veja Lista de erros de ligação transitória incorporada. Para adicionar números de erro personalizados a este conjunto, ou substituí-lo completamente, use retryConn em Lógica de repetição configurável. Para tentar novamente afirmações falhadas, use retryExec no mesmo artigo.

Defina as propriedades

Definir connectRetryCount e connectRetryInterval no URL JDBC, num Properties objeto, ou num SQLServerDataSource.

No URL do JDBC:

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

Com um objeto Properties. Os excertos em Java neste artigo omitem importações e wrappers de classe para maior brevidade.

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);

Com SQLServerDataSource:

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

Detetar ligações inativas interrompidas

Uma ligação típica inativa é aquela que está num pool de ligações. O controlador considera uma ligação inativa após cerca de 30 segundos sem atividade. O servidor ou um dispositivo de rede entre o cliente e o servidor pode fechar ligações inativas, por isso o driver precisa de uma forma de perceber que o socket está morto antes da próxima consulta ser executada.

Para detetar conexões ociosas quebradas, o driver depende de pacotes keepalive TCP no nível do soquete. No Linux e no Java 11 ou posterior, o controlador ativa automaticamente os pacotes keepalive com um intervalo de 30 segundos (KeepAliveTime), com um atraso de 1 segundo entre repetições quando ocorre uma falha (KeepAliveInterval).

Limitações

O condutor não pode restaurar uma ligação de repouso avariada quando alguma das seguintes condições é verdadeira:

• Há um conjunto de resultados aberto que não está completamente analisado ou bufferizado.
• A ligação alternava entre bases de dados e SQL do Azure.
• Há uma transação em aberto.

Conteúdo relacionado

• Lógica de retentativa configurável (JDBC)
• Conectar-se a uma base de dados SQL do Azure
• Compreender as propriedades de tempo limite no driver JDBC
• Artigo técnico: Resiliência da Ligação Ociosa
• Visão geral do driver JDBC