Bağlantı dayanıklılığı (JDBC)

JDBC sürücüsünü indirin

Bağlantı dayanıklılığı , JDBC sürücüsünün bozuk boşta kalan bağlantıyı saydam bir şekilde geri yüklemesine ve başarısız olursa ilk bağlantıyı yeniden denemesine olanak tanır. Bu makale, bu davranışı denetleyen iki bağlantı dizesi özelliğini (connectRetryCount ve connectRetryInterval) ve sürücünün kesilen boşta bir bağlantıyı algılamak için kullandığı keepalive ayarlarını ele alır. Bağlantı dayanıklılığı, SQL Server için Microsoft JDBC Sürücüsü 10.2.0 ile başlayarak kullanılabilir. Bozuk boşta bağlantıyı yeniden bağlamak için 2014 veya sonraki SQL Server ya da Azure SQL Veritabanı gerekir.

Tip

Bağlantı dayanıklılığı yalnızca ilk bağlantıyı yeniden dener ve kesilen boşta bağlantıları sessizce yeniden kurar. Başarısız deyimleri otomatik olarak yeniden denemek (örneğin, kilitlenme kurbanı 1205 veya kilit zaman aşımı 1222) ya da bağlantı yeniden deneme listesini özel hata numaralarıyla (örneğin, 40197 veya 40613 gibi geçici hatalar Azure SQL) genişletmek için Yapılandırılabilir yeniden deneme mantığını kullanın. CRL kural tabanlıdır; hangi hataların ve geri dönüş mekanizmasının kullanılacağını siz belirlersiniz ve bu makalede açıklanan özelliklerle birlikte çalışır.

JDBC sürücüsü nasıl yeniden dener

JDBC sürücüsü üç bağımsız yeniden deneme mekanizması sağlar. Birlikte çalışırlar, böylece hepsini aynı anda kullanabilirsiniz:

Mekanizma Ne yapar? Daha fazla bilgi nereden edinilir?
Boşta bağlantı dayanıklılığı Kullanıcıya fark ettirmeden kesilen boşta durumdaki bir bağlantıyı (örneğin, sunucu veya yük dengeleyici tarafından kapatılan bağlantı havuzundaki bir bağlantıyı) yeniden kurar. Bozuk boşta bağlantıları algılama (bu makale)
İlk bağlantı yeniden denemesi Yerleşik bir geçici hata listesi için, başarısız olan ilk bağlantı denemesi sabit bir zamanlamayla yeniden denenir. İlk bağlantıları yeniden deneyin (bu makale)
Yapılandırılabilir yeniden deneme mantığı (CRL) Başarısız ifadeler ve özel hata numaraları için kural tabanlı yeniden deneme. Microsoft JDBC Driver 12.10 ile kullanıma sunulmuştur. Yapılandırılabilir yeniden deneme mantığı

İlk bağlantıları yeniden deneyin

JDBC sürücüsü, ilk bağlantıyı yeniden denemeden önce sürücünün ne sıklıkta ve ne kadar bekleyeceğini denetleyebilen iki bağlantı özelliği içerir. Bu özellikleri bağlantı dizesi ekleyin veya veri kaynağı özellikleri aracılığıyla ayarlayın.

Keyword Değerler Varsayılan Description
connectRetryCount 0 ile 255 arasında tamsayı (dahil) 1 Vazgeçmeden önce bağlantı kurma veya yeniden kurma girişim sayısı üst sınırı. Varsayılan olarak, sürücü tek bir yeniden deneme girişiminde bulunur. 0 değeri yeniden denemeyi devre dışı bırakır.
connectRetryInterval 1 ile 60 arasında tamsayı (dahil) 10 Bağlantı yeniden deneme girişimleri arasındaki saniye cinsinden süre. Sürücü, kopmuş durumdaki boşta bir bağlantı algıladığında hemen yeniden bağlanmayı dener, ardından tekrar denemeden önce connectRetryInterval saniye bekler. connectRetryCount, 0 olduğunda bu özellik yok sayılır.

connectRetryCount * connectRetryInterval, loginTimeout değerinden büyükse sürücü, loginTimeout değerine ulaşıldığında bağlanmayı denemeyi durdurur. Aksi takdirde, connectRetryCount tükenene kadar devam eder.

Bu özellikler yalnızca geçici bağlantı hatalarının yerleşik listesini yeniden dener. Kapsanan hataların tam listesi (4060, 40197, 40501, 40613, 49918-49920 ve diğerleri) için bkz. Yerleşik geçici bağlantı hata listesi. Bu kümeye özel hata numaraları eklemek veya tamamen değiştirmek için retryConn kullanın. Başarısız deyimleri yeniden denemek için aynı makalede kullanın retryExec .

Özellikleri ayarlama

connectRetryCount ve connectRetryInterval öğelerini JDBC URL’sinde, bir Properties nesnesinde veya bir SQLServerDataSource üzerinde ayarlayın.

JDBC URL'sinde:

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

Bir Properties nesnesi ile. Bu makaledeki Java kod parçacıklarında, kısalık amacıyla import ifadelerine ve sınıf tanımlarına yer verilmemiştir.

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

ile : SQLServerDataSource

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

Bozuk boşta bağlantıları algılama

Tipik bir boşta bağlantı, bağlantı havuzunda bekleyen bir bağlantıdır. Sürücü, yaklaşık 30 saniye sonra hiçbir etkinlik olmadan boşta bir bağlantı olduğunu düşünür. Sunucu veya istemci ile sunucu arasındaki bir ağ cihazı, boştaki bağlantıları kapatabilir; bu nedenle sürücünün, bir sonraki sorgu çalıştırılmadan önce soketin artık geçersiz olduğunu tespit etmesinin bir yoluna ihtiyaç vardır.

Kopmuş boşta kalan bağlantıları algılamak için sürücü, soket düzeyinde TCP canlı tutma paketlerine dayanır. Linux ve Java 11 veya sonraki sürümlerde sürücü, keepalive paketlerini 30 saniyelik aralıklarla otomatik olarak etkinleştirir (KeepAliveTime) ve bir hata oluştuğunda yeniden denemeler arasında 1 saniyelik gecikme uygular (KeepAliveInterval).

Önemli

Windows’ta ve Java 11 ya da önceki sürümlerde, kesilmiş boşta bağlantıların kurtarılmasından yararlanmak için işletim sisteminde keepalive ayarlarını el ile yapılandırmanız gerekir. Keepalive'leri yapılandırma hakkında bilgi için bkz. Azure SQL veritabanına bağlantı.

Sınırlamalar

Aşağıdaki koşullardan herhangi biri doğru olduğunda sürücü bozuk boşta bağlantıyı geri yükleyemez:

  • Tam olarak ayrıştırılmamış veya arabelleğe alınmamış açık bir sonuç kümesi vardır.
  • Bağlantı veritabanlarını Azure SQL karşı değiştirdi.
  • Açık bir işlem var.

İlgili içerik

  • Last updated on