CosmosClientBuilder.WithConnectionModeDirect Methode

Definition

Namespace:

Microsoft.Azure.Cosmos.Fluent

Assembly:

Microsoft.Azure.Cosmos.Client.dll

Paket:

Microsoft.Azure.Cosmos v3.38.1

Überlädt

WithConnectionModeDirect()	Legt den Verbindungsmodus auf Direct fest. Dies wird vom Client verwendet, wenn eine Verbindung mit dem Azure Cosmos DB-Dienst hergestellt wird.
WithConnectionModeDirect(Nullable<TimeSpan>, Nullable<TimeSpan>, Nullable<Int32>, Nullable<Int32>, Nullable<PortReuseMode>, Nullable<Boolean>)	Legt den Verbindungsmodus auf Direct fest. Dies wird vom Client verwendet, wenn eine Verbindung mit dem Azure Cosmos DB-Dienst hergestellt wird.

WithConnectionModeDirect()

Quelle:

CosmosClientBuilder.cs

Legt den Verbindungsmodus auf Direct fest. Dies wird vom Client verwendet, wenn eine Verbindung mit dem Azure Cosmos DB-Dienst hergestellt wird.

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

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

Public Function WithConnectionModeDirect () As CosmosClientBuilder

Gibt zurück

CosmosClientBuilder

Der aktuelle CosmosClientBuilder.

Hinweise

Weitere Informationen finden Sie unter Verbindungsrichtlinie: Verwenden des Direktverbindungsmodus.

Weitere Informationen

• ConnectionMode

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

Quelle:

CosmosClientBuilder.cs

Legt den Verbindungsmodus auf Direct fest. Dies wird vom Client verwendet, wenn eine Verbindung mit dem Azure Cosmos DB-Dienst hergestellt wird.

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

Parameter

idleTcpConnectionTimeout

Nullable<TimeSpan>

Steuert die Leerlaufzeit, nach der nicht verwendete Verbindungen geschlossen werden. Standardmäßig werden Verbindungen im Leerlauf unbegrenzt geöffnet gehalten. Der Wert muss größer oder gleich 10 Minuten sein. Empfohlen werden Werte zwischen 20 Minuten und 24 Stunden. Hauptsächlich nützlich für spärlichen seltenen Zugriff auf ein großes Datenbankkonto.

openTcpConnectionTimeout

Nullable<TimeSpan>

Steuert die Zeit, die für den Versuch, eine Verbindung herzustellen, zulässig ist. Das Standardtimeout beträgt 5 Sekunden. Empfohlene Werte sind größer oder gleich 5 Sekunden. Wenn die Zeit verstrichen ist, wird der Versuch abgebrochen, und es wird ein Fehler zurückgegeben. Längere Timeouts verzögern Wiederholungen und Fehler.

maxRequestsPerTcpConnection

Nullable<Int32>

Steuert die Anzahl von Anforderungen, die gleichzeitig über eine einzelne TCP-Verbindung zulässig sind. Wenn mehrere Anforderungen gleichzeitig im Flight ausgeführt werden, öffnet der Direct/TCP-Client zusätzliche Verbindungen. Die Standardeinstellungen lassen 30 gleichzeitige Anforderungen pro Verbindung zu. Legen Sie diesen Wert nicht unter 4 Anforderungen pro Verbindung oder höher als 50-100 Anforderungen pro Verbindung fest.
Ersteres kann zu einer großen Anzahl von Verbindungen führen, die erstellt werden müssen. Letzteres kann zu Head-of-Line-Blockierung, hoher Latenz und Timeouts führen. Anwendungen mit einem sehr hohen Grad an Parallelität pro Verbindung, mit großen Anforderungen oder Antworten oder mit sehr engen Latenzanforderungen können mit 8-16 Anforderungen pro Verbindung eine bessere Leistung erzielen.

maxTcpConnectionsPerEndpoint

Nullable<Int32>

Steuert die maximale Anzahl von TCP-Verbindungen, die für jedes Cosmos DB-Back-End geöffnet werden können. Zusammen mit MaxRequestsPerTcpConnection begrenzt diese Einstellung die Anzahl der Anforderungen, die gleichzeitig an ein einzelnes Cosmos DB Back-End gesendet werden (MaxRequestsPerTcpConnection x MaxTcpConnectionPerEndpoint). Der Standardwert lautet 65535. Der Wert muss größer als oder gleich 16 sein.

portReuseMode

Nullable<PortReuseMode>

(Direct/TCP) Steuert die Wiederverwendungsrichtlinie des Clientports, die vom Transportstapel verwendet wird. Der Standardwert ist PortReuseMode.ReuseUnicastPort.

enableTcpConnectionEndpointRediscovery

Nullable<Boolean>

(Direct/TCP) Steuert die Aktualisierung des Adresscaches bei der Benachrichtigung zum Zurücksetzen der TCP-Verbindung. Der Standardwert ist „FALSE“.

Gibt zurück

CosmosClientBuilder

Der aktuelle CosmosClientBuilder.

Hinweise

Weitere Informationen finden Sie unter Verbindungsrichtlinie: Verwenden des Direktverbindungsmodus.

Weitere Informationen

• ConnectionMode