CosmosClientBuilder.WithConnectionModeDirect Méthode

Définition

Espace de noms:

Microsoft.Azure.Cosmos.Fluent

Assembly:

Microsoft.Azure.Cosmos.Client.dll

Paquet:

Microsoft.Azure.Cosmos v3.38.1

Surcharges

WithConnectionModeDirect()	Définit le mode de connexion sur Direct. Il est utilisé par le client lors de la connexion au service Azure Cosmos DB.
WithConnectionModeDirect(Nullable<TimeSpan>, Nullable<TimeSpan>, Nullable<Int32>, Nullable<Int32>, Nullable<PortReuseMode>, Nullable<Boolean>)	Définit le mode de connexion sur Direct. Il est utilisé par le client lors de la connexion au service Azure Cosmos DB.

WithConnectionModeDirect()

Source:

CosmosClientBuilder.cs

Définit le mode de connexion sur Direct. Il est utilisé par le client lors de la connexion au service Azure Cosmos DB.

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

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

Public Function WithConnectionModeDirect () As CosmosClientBuilder

Retours

CosmosClientBuilder

CosmosClientBuilder actuel.

Remarques

Pour plus d’informations, consultez Stratégie de connexion : utiliser le mode de connexion directe.

Voir aussi

• ConnectionMode

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

Source:

CosmosClientBuilder.cs

Définit le mode de connexion sur Direct. Il est utilisé par le client lors de la connexion au service 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

Paramètres

idleTcpConnectionTimeout

Nullable<TimeSpan>

Contrôle le temps d’inactivité après lequel les connexions inutilisées sont fermées. Par défaut, les connexions inactives restent ouvertes indéfiniment. La valeur doit être supérieure ou égale à 10 minutes. Les valeurs recommandées sont comprises entre 20 minutes et 24 heures. Principalement utile pour l’accès peu fréquent à un compte de base de données volumineux.

openTcpConnectionTimeout

Nullable<TimeSpan>

Contrôle le temps nécessaire pour tenter d’établir une connexion. Le délai d’attente par défaut est de 5 secondes. Les valeurs recommandées sont supérieures ou égales à 5 secondes. Lorsque le temps s’écoule, la tentative est annulée et une erreur est retournée. Des délais d’expiration plus longs retardent les nouvelles tentatives et les échecs.

maxRequestsPerTcpConnection

Nullable<Int32>

Contrôle le nombre de requêtes autorisées simultanément sur une seule connexion TCP. Lorsque d’autres requêtes sont en cours d’exécution simultanément, le client direct/TCP ouvre des connexions supplémentaires. Les paramètres par défaut autorisent 30 demandes simultanées par connexion. Ne définissez pas cette valeur inférieure à 4 requêtes par connexion ou supérieure à 50 à 100 requêtes par connexion.
Le premier peut entraîner la création d’un grand nombre de connexions. Ce dernier peut entraîner un blocage de la tête de ligne, une latence élevée et des délais d’expiration. Les applications avec un degré de parallélisme très élevé par connexion, avec des demandes ou des réponses volumineuses, ou avec des exigences de latence très strictes peuvent obtenir de meilleures performances avec 8 à 16 demandes par connexion.

maxTcpConnectionsPerEndpoint

Nullable<Int32>

Contrôle le nombre maximal de connexions TCP qui peuvent être ouvertes à chaque serveur principal Cosmos DB. Avec MaxRequestsPerTcpConnection, ce paramètre limite le nombre de requêtes envoyées simultanément à un seul back-end Cosmos DB (MaxRequestsPerTcpConnection x MaxTcpConnectionperEndpoint). La valeur par défaut est 65 535. La valeur doit être supérieure ou égale à 16.

portReuseMode

Nullable<PortReuseMode>

(Direct/TCP) Contrôle la stratégie de réutilisation du port client utilisée par la pile de transport. La valeur par défaut est PortReuseMode.ReuseUnicastPort.

enableTcpConnectionEndpointRediscovery

Nullable<Boolean>

(Direct/TCP) Contrôle l’actualisation du cache d’adresses lors de la notification de réinitialisation de connexion TCP. La valeur par défaut est false.

Retours

CosmosClientBuilder

CosmosClientBuilder actuel.

Remarques

Pour plus d’informations, consultez Stratégie de connexion : utiliser le mode de connexion directe.

Voir aussi

• ConnectionMode