Partilhar via

CosmosClientBuilder.WithConnectionModeDirect Método

  • Referência

Definição

Namespace:
Microsoft.Azure.Cosmos.Fluent
Assembly:
Microsoft.Azure.Cosmos.Client.dll
Pacote:
Microsoft.Azure.Cosmos v3.38.1

Sobrecargas

WithConnectionModeDirect()

Define o modo de conexão como Direct. Isso é usado pelo cliente ao se conectar ao serviço do Azure Cosmos DB.
WithConnectionModeDirect(Nullable<TimeSpan>, Nullable<TimeSpan>, Nullable<Int32>, Nullable<Int32>, Nullable<PortReuseMode>, Nullable<Boolean>)

Define o modo de conexão como Direct. Isso é usado pelo cliente ao se conectar ao serviço do Azure Cosmos DB.

WithConnectionModeDirect()

Origem:
CosmosClientBuilder.cs

Define o modo de conexão como Direct. Isso é usado pelo cliente ao se conectar ao serviço do Azure Cosmos DB.

public Microsoft.Azure.Cosmos.Fluent.CosmosClientBuilder WithConnectionModeDirect ();
member this.WithConnectionModeDirect : unit -> Microsoft.Azure.Cosmos.Fluent.CosmosClientBuilder
Public Function WithConnectionModeDirect () As CosmosClientBuilder

Retornos

CosmosClientBuilder

O CosmosClientBuilder atual.

Comentários

Para obter mais informações, consulte Política de conexão: usar o modo de conexão direta.

Confira também

Aplica-se a

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

Origem:
CosmosClientBuilder.cs

Define o modo de conexão como Direct. Isso é usado pelo cliente ao se conectar ao serviço do 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 a quantidade de tempo ocioso após o qual as conexões não utilizados são fechadas. Por padrão, as conexões ociosas são mantidas abertas indefinidamente. O valor deve ser maior ou igual a 10 minutos. Os valores recomendados variam entre 20 minutos e 24 horas. Principalmente útil para acesso esparso pouco frequente a uma conta de banco de dados grande.

openTcpConnectionTimeout
Nullable<TimeSpan>

Controla a quantidade de tempo permitida para tentar estabelecer uma conexão. O tempo limite padrão é de 5 segundos. Os valores recomendados são maiores ou iguais a 5 segundos. Quando o tempo passa, a tentativa é cancelada e um erro é retornado. Tempos limite mais longos atrasarão novas tentativas e falhas.

maxRequestsPerTcpConnection
Nullable<Int32>

Controla o número de solicitações permitidas simultaneamente em uma única conexão TCP. Quando mais solicitações estiverem em versão de pré-lançamento simultaneamente, o cliente direto/TCP abrirá conexões adicionais. As configurações padrão permitem 30 solicitações simultâneas por conexão. Não defina esse valor inferior a 4 solicitações por conexão ou superior a 50 a 100 solicitações por conexão.
O primeiro pode levar a um grande número de conexões a serem criadas. Este último pode levar ao bloqueio de linha, alta latência e tempos limite. Aplicativos com um grau muito alto de paralelismo por conexão, com solicitações ou respostas grandes ou com requisitos de latência muito apertados podem obter melhor desempenho com 8 a 16 solicitações por conexão.

maxTcpConnectionsPerEndpoint
Nullable<Int32>

Controla o número máximo de conexões TCP que podem ser abertas para cada back-end do Cosmos DB. Junto com o MaxRequestsPerTcpConnection, essa configuração limita o número de solicitações que são enviadas simultaneamente para um único back-end do Cosmos DB (MaxRequestsPerTcpConnection x MaxTcpConnectionPerEndpoint). O valor padrão é 65,535. O valor deve ser maior ou igual a 16.

portReuseMode
Nullable<PortReuseMode>

(Direct/TCP) Controla a política de reutilização da porta do cliente usada pela pilha de transporte. O valor padrão é PortReuseMode.ReuseUnicastPort.

enableTcpConnectionEndpointRediscovery
Nullable<Boolean>

(Direct/TCP) Controla a atualização do cache de endereços na notificação de redefinição de conexão TCP. O valor padrão é false.

Retornos

CosmosClientBuilder

O CosmosClientBuilder atual.

Comentários

Para obter mais informações, consulte Política de conexão: usar o modo de conexão direta.

Confira também

Aplica-se a