接続の回復性 (JDBC)

JDBC ドライバーのダウンロード

接続の回復性 により、JDBC ドライバーは中断されたアイドル状態の接続を透過的に復元し、障害が発生した場合は最初の接続を再試行できます。 この記事では、この動作を制御する 2 つの接続文字列プロパティ (connectRetryCount と connectRetryInterval) と、ドライバーがアイドル接続の切断を検出するために使用するキープアライブ設定について説明します。 接続の回復性は、Microsoft JDBC Driver 10.2.0 for SQL Server 以降で使用できます。 壊れたアイドル接続を再接続するには、SQL Server 2014以降のバージョンかAzure SQL Databaseが必要です。

JDBC ドライバーの再試行方法

JDBC ドライバーには、3 つの独立した再試行メカニズムが用意されています。 これらは一緒に動作するため、すべての機能を一度に使用できます。

初期接続を再試行する

JDBC ドライバーには、最初の接続を再試行する前にドライバーが待機する頻度と時間を制御する 2 つの接続プロパティが含まれています。 これらのプロパティを接続文字列に追加するか、データ ソース プロパティを使用して設定します。

ドライバーは最初のリトライを即座に実行し、その後のリトライの connectRetryInterval 秒を待つため、 connectRetryCount リトライは約 (connectRetryCount - 1) * connectRetryInterval 秒間かかります。 loginTimeout はシーケンス全体の上限を定めます。ドライバーは、経過時間に connectRetryInterval を足した値が loginTimeout に達すると再試行を停止します。これは loginTimeout 自体の1間隔前に発生します。

これらのプロパティは、 一時的な接続エラーの組み込みリストのみを再試行します。 対象となるエラーの完全な一覧 (4060、40197、40501、40613、49918-49920 など) については、 組み込みの一時的な接続エラーの一覧を参照してください。 このセットにカスタム エラー番号を追加するか、完全に置き換えるには、retryConnのを使用します。 失敗したステートメントを再試行するには、同じ記事の retryExec を使用します。

プロパティを設定する

JDBC URL、connectRetryCount オブジェクト、または connectRetryInterval に 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);

自動一時停止のサーバーレスデータベースに接続

Azure SQL Databaseのサーバーレスで自動一時停止を有効にすると、最初の接続試行でデータベースが再開されます。 その試みはエラー40613で失敗し、再開が実行されます。 データベースは通常1分以内に再開されます。 詳細は「 自動一時停止」と「自動再開」をご覧ください。

エラー40613は内蔵の過渡接続エラーリストに含まれているため、ドライバーは接続を再試行します。 この場合、あなたのアプリケーションは独自のリトライループを必要としません。 デフォルト設定では再開は含まれていません。 connectRetryCount は 1で、ドライバーはその1回の再試行を即座に実行します。 どちらの試みもデータベースが再開中の間に起こるため、アプリケーションはエラーを認識します。

履歴書を処理するには、3つのプロパティをすべてまとめて設定します:

以下の値は約1分間繰り返し試行されます。これは典型的な履歴書をカバーしています:

jdbc:sqlserver://<server>.database.windows.net;databaseName=<database>;encrypt=true;loginTimeout=120;connectRetryCount=5;connectRetryInterval=15

loginTimeout をそれ単独で引き上げても効果はありません。接続試行はハングするのではなく、40613 で即座に失敗するためです。 connectRetryCount を単独で引き上げても役に立ちません。loginTimeout がシーケンスを途中で打ち切ってしまうからです。

切断されたアイドル接続を検出する

典型的なアイドル状態接続とは、接続プール内にある接続のことです。 ドライバーは、アクティビティなしで約 30 秒後に接続がアイドル状態であると見なします。 クライアントとサーバーの間のサーバーまたはネットワーク デバイスはアイドル状態の接続を閉じる可能性があるため、ドライバーは、次のクエリを実行する前にソケットが停止していることを確認する方法が必要です。

切断されたアイドル状態を検出するために、ドライバーはソケット レベルで TCP キープアライブ パケットに依存しています。 Linux Java 11以降のバージョンでは、ドライバーは30秒間隔(KeepAliveTime)でキープアライブパケットを自動的に有効化し、失敗時には再試行間隔1秒(KeepAliveInterval)があります。

制限事項

次のいずれかの条件に該当する場合、ドライバーは、破損したアイドル接続を復元できません。

• 完全に解析またはバッファー処理されていないオープンな結果セットがあります。
• 接続がAzure SQLに対してデータベースを切り替えました。
• 開いているトランザクションがあります。

関連するコンテンツ

• 構成可能な再試行ロジック (JDBC)
• Azure SQL データベースに接続する
• JDBC ドライバーのタイムアウト プロパティについて
• 技術記事: アイドル状態の接続の回復性
• JDBC ドライバーの概要