Fornecedores de lógica de retentativa incorporados no SqlClient

Aplica-se a: .NET Framework .NET .NET Standard

Baixar ADO.NET

Microsoft.Data.SqlClient.SqlConfigurableRetryFactory cria provedores para agendamentos comuns de novas tentativas. A lógica de repetição configurável está desativada por defeito. Atribua um provedor a SqlConnection.RetryLogicProvider ou SqlCommand.RetryLogicProvider para ativá-lo nesse objeto.

Escolha um mecanismo de repetição

Os mecanismos fixos, incrementais e exponenciais adicionam uma variação aleatória a cada um dos intervalos. O jitter reduz as rajadas sincronizadas de retentativas quando muitos clientes enfrentam a mesma falha.

NumberOfTries é o número total de tentativas, incluindo a operação inicial. Por exemplo, NumberOfTries = 3 permite a tentativa inicial e até duas tentativas. O seu intervalo válido é de 1 a 60.

Lista de erros transitórios incorporada

Quando SqlRetryLogicOption.TransientErrors é null, os fornecedores incorporados tentam novamente os 20 números de erro em SqlConfigurableRetryFactory.BaselineTransientErrors, agrupados por onde a falha se origina:

Cada erro é descrito nas secções seguintes.

No Microsoft.Data.SqlClient 7.0, SqlConfigurableRetryFactory.BaselineTransientErrors expõe a lista incorporada como uma coleção só de leitura. Use-o para estender a linha base sem copiar números de erro da fonte do driver:

var transientErrors = SqlConfigurableRetryFactory.BaselineTransientErrors
    .Append(12345)
    .ToArray();

var options = new SqlRetryLogicOption
{
    NumberOfTries = 5,
    DeltaTime = TimeSpan.FromSeconds(2),
    MaxTimeInterval = TimeSpan.FromSeconds(30),
    TransientErrors = transientErrors,
};

Para versões anteriores do controlador, crie uma coleção pertencente à aplicação que contenha os erros de base de que precisa e os erros adicionais. Antes de copiar uma linha base, selecione a etiqueta de origem SqlClient que corresponda à versão do seu pacote instalado e inspecione SqlConfigurableRetryFactory.cs. A lista na main agência pode mudar após a libertação do seu pacote.

Erros durante o estabelecimento da ligação

Os seguintes erros permitem nova tentativa na lista integrada ou justificam ser adicionados a TransientErrors além da lista integrada.

Os seguintes erros podem ser transitórios quando ocorrem durante o estabelecimento da ligação ou ao enviar um pedido ao servidor. Tente novamente após um curto intervalo de espera limitado. Erros que persistem depois de algumas tentativas geralmente indicam um problema de configuração, como servidor errado, permissões em falta, definições de encriptação incompatíveis ou quota esgotada, que uma nova tentativa não resolve.

Os erros ao nível da instrução não constam desta lista porque ocorrem depois de a ligação ter sido estabelecida e a falha não inutiliza a sessão. Os erros mais comuns das instruções passíveis de repetição são 1205 (vítima de impasse [deadlock]) e 1222 (tempo limite do pedido de bloqueio). Tente novamente toda a transação em vez do único extrato falhado.

O texto da mensagem de erro provém de erros de ligação transitória do SQL do Azure. Estes erros podem ser repetidos no SQL Server, no Base de Dados SQL do Azure, no Azure SQL Managed Instance, na base de dados SQL no Microsoft Fabric e nos pools SQL dedicados no Azure Synapse Analytics.

Erros durante a execução de comandos

Os seguintes erros ocorrem após o estabelecimento de uma ligação, enquanto um comando está a ser executado. Tente novamente toda a transação, não o extrato individual. Repetir uma instrução dentro de uma transação pode duplicar operações anteriores ou violar as garantias de ordenação da transação.

Erros ao nível da instrução que refletem um problema de lote ou de esquema (por exemplo, 102 erro de sintaxe, 207 coluna inválida, 2812 procedimento armazenado em falta) não são transitórios. Corrija o texto da consulta ou a associação ao esquema; tentar novamente não ajuda.

O texto da mensagem de erro provém da vista de catálogo sys.messages. Estes erros vêm do motor SQL Server, pelo que os seus números são os mesmos em SQL Server, Base de Dados SQL do Azure, Azure SQL Managed Instance, base de dados SQL no Microsoft Fabric e pools SQL dedicados em Azure Synapse Analytics, independentemente do driver.

O driver, e não o motor, apresenta representações no lado do cliente de erros de tempo limite e de cancelamento de instrução (por exemplo, o timeout do Microsoft.Data.SqlClient -2), pelo que estes erros não constam da lista integrada. Se a sua aplicação detetar estes erros separadamente, trate-os na mesma fronteira de transação dos erros do motor descritos anteriormente.

Comportamento de comandos e transações

Os fornecedores incorporados saltam a retentativa quando um comando é executado dentro de um ambiente TransactionScope ou tem um SqlTransaction adjunto. O comando é executado uma vez sem lógica de repetição. Tentar novamente uma instrução isolada dentro de uma transação pode duplicar operações anteriores ou violar a ordem pretendida da transação.

Use SqlRetryLogicOption.AuthorizedSqlCondition para limitar as tentativas de comandos a operações que a sua aplicação pode repetir em segurança. O predicado recebe o texto do comando. Se o predicado devolver false, o comando é executado uma vez sem lógica de repetição.

Example

Para exemplos completos de ligação e comando, veja:

• SqlConnection.RetryLogicProvider
• SqlCommand.RetryLogicProvider

Conteúdo relacionado

• Criar um provedor de retentativas personalizado para SqlClient
• Lógica de repetição configurável no SqlClient
• Microsoft. Data.SqlClient para SQL Server