Microsoftの接続オプション。Data.SqlClient

Microsoft。Data.SqlClient接続オプションは、ドライバが接続の確立、識別、ルーティング、再試行、プール化の方法を制御します。 接続文字列で、または対応する SqlConnectionStringBuilder プロパティを使用して設定します。

Microsoft Entra ID認証については、Microsoft Entra ID認証を参照してください。 TLSの設定については、「 暗号化および証明書検証」を参照してください。

SqlConnectionStringBuilderでオプションを設定する

接続文字列の断片を連結する代わりに、ビルダーを使用します:

var builder = new SqlConnectionStringBuilder
{
    DataSource = "tcp:sql.example.com,1433",
    InitialCatalog = "Orders",
    IntegratedSecurity = true,
    Encrypt = SqlConnectionEncryptOption.Mandatory,
    ApplicationName = "Orders.Worker",
    ConnectTimeout = 30,
    ConnectRetryCount = 3,
    ConnectRetryInterval = 10,
    MultiSubnetFailover = true,
};

このコードはビルダーの物件名を使用しています。 これらの表では、接続文字列の一般的な表記を使用しています。 ドライバーはまた、記録された偽名も受け入れています。

タイムアウトの選択肢

接続タイムアウトとコマンドタイムアウトは異なる作業を測定します。 Connect Timeout クエリの実行を制限しません。 Command Timeout 認証やプーリング接続の待ち時間を制限しません。

CancellationTokenは両方の設定とは別です。 呼び出し元がタイムアウトが切れる前に待つ必要がないように、 OpenAsync、コマンド実行、リーダー各メソッドに渡します。

ワークロードの識別とルーティングオプション

Application Intent=ReadOnly 通常は、可用性グループのリスナーや読み取りルーティングをサポートするサービスエンドポイントとペアリングされます。 「 高可用性」および「災害復旧」を参照してください。

ネットワークおよびパケットオプション

MultiSubnetFailover=true 名前付きインスタンス、非TCPプロトコル、データベースミラーリング、または64以上のIPアドレスを持つエンドポイントではサポートされていません。 単一IPのTCPエンドポイントには安全です。

Microsoft。Data.SqlClient 7.0には、すべての接続がMultiSubnetFailover=trueのように振る舞うプロセス全体のAppContextスイッチも搭載されています。 そのスイッチが有効でないと接続文字列のデフォルトはfalseのままです。 SqlClientのAppContextスイッチを参照してください。

プーリングオプション

プール設定はプロセス全体やデータベースサーバー全体ではなく、それぞれ異なるプールに適用されます。 Max Pool Sizeを提出する前に、接続とリーダーが迅速に処分されていること、そしてデータベースがすべてのアプリケーションインスタンスで結果の合計を受け入れられるかを確認してください。

プールキー、トークン挙動、ブロッキング期間、クリア、診断については、SQL Server接続プーリングを参照してください。

接続復旧オプション

接続復旧時の最初のリトライは即座に行われます。 Connect Retry Interval 後の試みの前に適用されます。 1回の操作で内蔵の初期オープンリトライを回避するには、 OpenWithoutRetryのオープンオーバーロードを使用します。

これらのキーワードは、実行中に失敗したコマンドをリトライしません。 カスタムのオープンポリシーやコマンドポリシーには 設定可能なリトライロジ ックを使いましょう。 リトライコマンドは効果を安全に繰り返した場合のみ行います。

サーバー識別と証明書のオプション

これらのオプションは、特定の証明書やKerberosの命名要件を満たします。 通常の認証や証明書検証の代わりにはなりません。

Host Name In Certificate 証明書マッチングに使用される名前を変更すること。 信用できない発行者を信用しません。 Server Certificate 証明書ファイルを正確にピン留めし、その証明書がローテーションされる際にアプリケーションの更新を要求します。

誤ったSPNオーバーライドはKerberos認証を妨げたり、意図された本人確認を弱めたりする可能性があります。 可能であれば、オーバーライドを設定する代わりにDNSとSPNの登録を修正しましょう。

接続紐は小さく保ちましょう。 どの動作を変えるか、そしてワークロードがその動作をどのように検証するかを指定できる場合にのみオプションを追加してください。

オプションの変更点をレビュー

本番環境でオプションを変更する前に:

1. 現在の接続文字列、ドライバーのバージョン、エンドポイントタイプ、そして観察された問題を記録します。
2. 一度に一つの行動を変えましょう。
3. 接続確立、認証、証明書検証、プーリング、フェイルオーバー、キャンセル、クエリ実行のテストを行います。
4. ハード接続数、プール待ち時間、接続レイテンシ、エラー数を測定してください。
5. すべてのデプロイ済みインスタンスで設定を確認してください。

接続文字列はプールキーの一部です。 段階的な展開では、旧プールと新旧プールの両方を一時的に作成できるため、物理的なデータベース接続数が増加します。

関連するコンテンツ

• 接続文字列
• データ ソースへの接続
• SQL Server 接続プーリング
• 暗号化と証明書の検証
• 高可用性とディザスター リカバリー
• SqlConnectionStringBuilder