CosmosClientBuilder.WithConnectionModeDirect メソッド

定義

名前空間:

Microsoft.Azure.Cosmos.Fluent

アセンブリ:

Microsoft.Azure.Cosmos.Client.dll

パッケージ:

Microsoft.Azure.Cosmos v3.38.1

オーバーロード

WithConnectionModeDirect()	接続モードを Direct に設定します。 これは、Azure Cosmos DB サービスに接続するときにクライアントによって使用されます。
WithConnectionModeDirect(Nullable<TimeSpan>, Nullable<TimeSpan>, Nullable<Int32>, Nullable<Int32>, Nullable<PortReuseMode>, Nullable<Boolean>)	接続モードを Direct に設定します。 これは、Azure Cosmos DB サービスに接続するときにクライアントによって使用されます。

WithConnectionModeDirect()

ソース:

CosmosClientBuilder.cs

接続モードを Direct に設定します。 これは、Azure Cosmos DB サービスに接続するときにクライアントによって使用されます。

public Microsoft.Azure.Cosmos.Fluent.CosmosClientBuilder WithConnectionModeDirect ();

member this.WithConnectionModeDirect : unit -> Microsoft.Azure.Cosmos.Fluent.CosmosClientBuilder

Public Function WithConnectionModeDirect () As CosmosClientBuilder

戻り値

CosmosClientBuilder

現在の CosmosClientBuilder です。

注釈

詳細については、「 接続ポリシー: 直接接続モードを使用する」を参照してください。

こちらもご覧ください

• ConnectionMode

WithConnectionModeDirect(Nullable<TimeSpan>, Nullable<TimeSpan>, Nullable<Int32>, Nullable<Int32>, Nullable<PortReuseMode>, Nullable<Boolean>)

ソース:

CosmosClientBuilder.cs

接続モードを Direct に設定します。 これは、Azure Cosmos DB サービスに接続するときにクライアントによって使用されます。

public Microsoft.Azure.Cosmos.Fluent.CosmosClientBuilder WithConnectionModeDirect (TimeSpan? idleTcpConnectionTimeout = default, TimeSpan? openTcpConnectionTimeout = default, int? maxRequestsPerTcpConnection = default, int? maxTcpConnectionsPerEndpoint = default, Microsoft.Azure.Cosmos.PortReuseMode? portReuseMode = default, bool? enableTcpConnectionEndpointRediscovery = default);

member this.WithConnectionModeDirect : Nullable<TimeSpan> * Nullable<TimeSpan> * Nullable<int> * Nullable<int> * Nullable<Microsoft.Azure.Cosmos.PortReuseMode> * Nullable<bool> -> Microsoft.Azure.Cosmos.Fluent.CosmosClientBuilder

Public Function WithConnectionModeDirect (Optional idleTcpConnectionTimeout As Nullable(Of TimeSpan) = Nothing, Optional openTcpConnectionTimeout As Nullable(Of TimeSpan) = Nothing, Optional maxRequestsPerTcpConnection As Nullable(Of Integer) = Nothing, Optional maxTcpConnectionsPerEndpoint As Nullable(Of Integer) = Nothing, Optional portReuseMode As Nullable(Of PortReuseMode) = Nothing, Optional enableTcpConnectionEndpointRediscovery As Nullable(Of Boolean) = Nothing) As CosmosClientBuilder

パラメーター

idleTcpConnectionTimeout

Nullable<TimeSpan>

未使用の接続を閉じるアイドル時間を制御します。 既定では、アイドル状態の接続は無期限に開いた状態になります。 値は 10 分以上である必要があります。 推奨値は 20 分から 24 時間です。 主に、大規模なデータベース アカウントへのアクセス頻度が低いスパースに役立ちます。

openTcpConnectionTimeout

Nullable<TimeSpan>

接続の確立に許可される時間を制御します。 既定のタイムアウトは 5 秒です。 推奨値は 5 秒以上です。 時間が経過すると、試行が取り消され、エラーが返されます。 タイムアウトが長いほど、再試行と失敗が遅延します。

maxRequestsPerTcpConnection

Nullable<Int32>

1 つの TCP 接続で同時に許可される要求の数を制御します。 より多くの要求が同時に送信されると、ダイレクト/TCP クライアントは追加の接続を開きます。 既定の設定では、接続ごとに 30 回の同時要求が許可されます。 この値は、接続あたり 4 つ未満の要求、または接続あたり 50 から 100 件を超える要求を設定しないでください。
前者では、多数の接続が作成される可能性があります。 後者は、行のブロック、待ち時間の長い、タイムアウトにつながる可能性があります。 接続ごとの並列処理が非常に高いアプリケーション、要求または応答が大きいアプリケーション、または待機時間の要件が非常に厳しいアプリケーションでは、接続あたり 8 から 16 個の要求でパフォーマンスが向上する可能性があります。

maxTcpConnectionsPerEndpoint

Nullable<Int32>

各 Cosmos DB バックエンドに対して開くことができる TCP 接続の最大数を制御します。 MaxRequestsPerTcpConnection と合わせて、この設定は、1 つの Cosmos DB バックエンドに同時に送信される要求の数を制限します (MaxRequestsPerTcpConnection と MaxTcpConnectionPerEndpoint の掛け算)。 既定値は 65,535 です。 値は 16 以上でなければなりません。

portReuseMode

Nullable<PortReuseMode>

(Direct/TCP)トランスポート スタックで使用されるクライアント ポート再利用ポリシーを制御します。 既定値は PortReuseMode.ReuseUnicastPort です。

enableTcpConnectionEndpointRediscovery

Nullable<Boolean>

(Direct/TCP)TCP 接続リセット通知のアドレス キャッシュ更新を制御します。 既定値は false です。

戻り値

CosmosClientBuilder

現在の CosmosClientBuilder です。

注釈

詳細については、「 接続ポリシー: 直接接続モードを使用する」を参照してください。

こちらもご覧ください

• ConnectionMode