CosmosClientBuilder.WithConnectionModeDirect Méthode

Référence

Définition

Espace de noms:: Microsoft.Azure.Cosmos.Fluent

Assembly:: Microsoft.Azure.Cosmos.Client.dll

Paquet:: Microsoft.Azure.Cosmos v3.38.1

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

S’applique à

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.