CosmosClientBuilder.WithConnectionModeDirect Método

Referencia

Definición

Espacio de nombres:: Microsoft.Azure.Cosmos.Fluent

Ensamblado:: Microsoft.Azure.Cosmos.Client.dll

Paquete:: Microsoft.Azure.Cosmos v3.38.1

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Sobrecargas

WithConnectionModeDirect()	Establece el modo de conexión en Directo. El cliente lo usa al conectarse al servicio Azure Cosmos DB.
WithConnectionModeDirect(Nullable<TimeSpan>, Nullable<TimeSpan>, Nullable<Int32>, Nullable<Int32>, Nullable<PortReuseMode>, Nullable<Boolean>)	Establece el modo de conexión en Directo. El cliente lo usa al conectarse al servicio Azure Cosmos DB.

WithConnectionModeDirect()

Source:: CosmosClientBuilder.cs

Establece el modo de conexión en Directo. El cliente lo usa al conectarse al servicio Azure Cosmos DB.

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

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

Public Function WithConnectionModeDirect () As CosmosClientBuilder

Se aplica a

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

Source:: CosmosClientBuilder.cs

Establece el modo de conexión en Directo. El cliente lo usa al conectarse al servicio 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

Parámetros

idleTcpConnectionTimeout: Nullable<TimeSpan>

Controla la cantidad de tiempo de inactividad después de la cual se cierran las conexiones sin usar. De forma predeterminada, las conexiones inactivas se mantienen abiertas indefinidamente. El valor debe ser mayor o igual que 10 minutos. Los valores recomendados están comprendidos entre 20 minutos y 24 horas. Principalmente útil para el acceso poco frecuente a una cuenta de base de datos grande.

openTcpConnectionTimeout: Nullable<TimeSpan>

Controla la cantidad de tiempo permitido para intentar establecer una conexión. El tiempo de espera predeterminado es de 5 segundos. Los valores recomendados son mayores o iguales que 5 segundos. Cuando transcurre el tiempo, se cancela el intento y se devuelve un error. Los tiempos de espera más largos retrasarán los reintentos y los errores.

maxRequestsPerTcpConnection: Nullable<Int32>

Controla el número de solicitudes permitidas simultáneamente a través de una única conexión TCP. Cuando haya más solicitudes en curso simultáneamente, el cliente direct/TCP abrirá conexiones adicionales. La configuración predeterminada permite 30 solicitudes simultáneas por conexión. No establezca este valor inferior a 4 solicitudes por conexión o superior a 50-100 solicitudes por conexión.
El primero puede dar lugar a un gran número de conexiones que se van a crear. Este último puede provocar bloqueos de línea, latencia alta y tiempos de espera. Las aplicaciones con un alto grado de paralelismo por conexión, con solicitudes o respuestas grandes, o con requisitos de latencia muy ajustados podrían obtener un mejor rendimiento con 8-16 solicitudes por conexión.

maxTcpConnectionsPerEndpoint: Nullable<Int32>

Controla el número máximo de conexiones TCP que se pueden abrir en cada back-end de Cosmos DB. Junto con MaxRequestsPerTcpConnection, esta configuración limita el número de solicitudes que se envían simultáneamente a un único back-end de Cosmos DB (MaxRequestsPerTcpConnection x MaxTcpConnectionPerEndpoint). El valor predeterminado es 65.535. El valor debe ser superior o igual a 16.

portReuseMode: Nullable<PortReuseMode>

(Directo/TCP) Controla la directiva de reutilización de puertos de cliente usada por la pila de transporte. El valor predeterminado es PortReuseMode.ReuseUnicastPort.

enableTcpConnectionEndpointRediscovery: Nullable<Boolean>

(Directo/TCP) Controla la actualización de caché de direcciones en la notificación de restablecimiento de conexión TCP. El valor predeterminado es false.