SqlClientに組み込まれたリトライロジックプロバイダ

適用対象: .NET Framework .NET .NET Standard

ADO.NET のダウンロード

Microsoft.Data.SqlClient.SqlConfigurableRetryFactory は、一般的な再試行スケジュール用のプロバイダーを作成します。 設定可能なリトライロジックはデフォルトでオフになっています。 そのオブジェクトに対してプロダ SqlConnection.RetryLogicProvider または SqlCommand.RetryLogicProvider を割り当てて有効化させます。

リトライプロバイダーを選ぶ

固定、増分型、指数型の各プロバイダーは、それぞれの間隔にランダムなジッターを追加します。 ジッターは、多くのクライアントが同じ障害に遭遇した際の同期再試行バーストを減らします。

NumberOfTries は初回の操作を含む試行回数の合計です。 例えば、 NumberOfTries = 3 は初回の試みと最大2回の再挑戦を許可しています。 有効範囲は1から60までです。

組み込みの一時的エラー一覧

SqlRetryLogicOption.TransientErrorsがnullされると、組み込みのプロバイダーは故障発生地ごとにグループ分けした20のエラー番号をSqlConfigurableRetryFactory.BaselineTransientErrorsで再試行します。

各誤りは以下のセクションで説明されています。

Microsoft.Data.SqlClient 7.0 では、SqlConfigurableRetryFactory.BaselineTransientErrors は組み込みのリストを読み取り専用コレクションとして公開しています。 ドライバーソースからエラー番号をコピーせずにベースラインを拡張するために使います:

var transientErrors = SqlConfigurableRetryFactory.BaselineTransientErrors
    .Append(12345)
    .ToArray();

var options = new SqlRetryLogicOption
{
    NumberOfTries = 5,
    DeltaTime = TimeSpan.FromSeconds(2),
    MaxTimeInterval = TimeSpan.FromSeconds(30),
    TransientErrors = transientErrors,
};

以前のドライバーバージョンでは、必要なベースラインエラーと追加エラーを含むアプリケーション所有のコレクションを作成しましょう。 ベースラインをコピーする前に、インストール済みパッケージのバージョンに合致する SqlClientソースタグ を選択し、 SqlConfigurableRetryFactory.csを確認してください。 mainブランチのリストは、パッケージがリリースされた後に変更されることがあります。

接続確立時のエラー

以下のエラーは組み込みリストで再試行可能で、または TransientErrors リストの上に追加する価値があります。

以下のエラーは、接続確立時やサーバーへのリクエスト送信時に一時的に発生することがあります。 短い境界付きバックオフで再試行します。 数回のリトライを経てもエラーが続くのは、サーバーの誤り、権限の欠落、暗号化設定の互換性がなさない、またはクォータが尽きてリトライでは直らない設定の問題を示していることが多いです。

ステートメント レベルのエラーは、接続が確立された後に発生し、エラーによってセッションが使用可能な状態になるため、この一覧には含まれません。 再試行可能な最も一般的なステートメント エラーは、1205 (デッドロックの対象) と 1222 (ロック要求タイムアウト) です。 単一の失敗したステートメントではなく、トランザクション全体を再試行してください。

エラー メッセージ テキストはAzure SQL の一時的な接続エラーから取得されます。 これらのエラーは、SQL Server、Azure SQL Database、Azure SQL Managed Instance、Microsoft FabricのSQL Database、およびAzure Synapse Analyticsの専用SQLプールで再試行が可能です。

コマンド実行時のエラー

以下のエラーは、接続が確立された後にコマンドが実行されているときに発生します。 個別の明細ではなく、取引全体をやり直してください。 トランザクション内で1つの文をやり直すことで、以前の作業が重複したり、トランザクションの順序付け保証に違反したりする可能性があります。

バッチやスキーマの問題を反映する文レベルのエラー(例: 102 構文エラー、 207 カラムの無効、 2812 ストアドプロシージャの欠如)は一時的ではありません。 クエリテキストやスキーマバインディングを修正します。再挑戦しても効果はありません。

エラーメッセージのテキストは sys.messages カタログビューから取得しています。 これらのエラーはSQL Serverエンジンから発生するため、SQL Server、Azure SQL Database、Azure SQL Managed Instance、Microsoft FabricのSQLデータベース、専用のSQLプールで数値は同じですAzure Synapse Analytics、ドライバーに関係なく。

エンジンではなくドライバーが、ステートメントのタイムアウト エラーおよびキャンセル エラーのクライアント側での表現（たとえば、Microsoft.Data.SqlClient -2 タイムアウト）を示すため、これらのエラーは組み込みリストに含まれていません。 もしアプリケーションがこれらのエラーを別々にキャッチする場合は、先に説明したエンジンエラーと同じトランザクション境界で処理してください。

コマンドおよびトランザクションの挙動

組み込みのプロバイダーは、コマンドがアンビエント TransactionScope 内で実行されたり SqlTransaction が接続されている場合、リトライをスキップします。 コマンドはリトライロジックなしで一度実行されます。 トランザクション内で単一の文を再試行すると、以前の作業が重複したり、トランザクションの意図された順序に違反したりすることがあります。

SqlRetryLogicOption.AuthorizedSqlConditionを使って、アプリケーションが安全に繰り返し可能な操作にコマンドの再試行を制限しましょう。 プレディケートはコマンド テキストを受け取ります。 述語が falseを返した場合、コマンドはリトライロジックなしで一度実行されます。

例

接続およびコマンドの完全な例については、以下をご覧ください:

• SqlConnection.RetryLogicProvider
• SqlCommand.RetryLogicProvider

関連するコンテンツ

• SqlClient用のカスタムリトライプロバイダーを作成してください
• SqlClient の構成可能な再試行ロジック
• Microsoft.Data.SqlClient for SQL Server