O que há de novo na Microsoft. Data.SqlClient

Microsoft.Data.SqlClient é distribuído independentemente do .NET. Este artigo resume as características significativas, mudanças de comportamento e mudanças de compatibilidade em cada linha de lançamento. As tabelas de lançamento incluem todas as publicações de pacotes estáveis, incluindo cada hotfix e pacote não listado. Para cada atualização de correção e dependência, veja as notas completas de lançamento no repositório SqlClient.

Versões atuais

Não use versões de pré-visualização em produção. APIs e comportamentos de pré-visualização podem mudar antes da Disponibilidade Geral (GA).

Tabelas de lançamento e resumos de disponibilidade geral utilizam o mês de publicação do NuGet. O artigo sobre o ciclo de vida lista datas oficiais de lançamento, que podem variar. Para períodos de suporte, veja ciclo de vida do suporte ao driver SqlClient.

7.1 STS

A versão 7.1 chegou à disponibilidade geral em setembro de 2026. É a linha STS atual.

Características e mudanças

• Suporte a SqlBatch no .NET Framework.
• Sobrecargas assíncronas SqlConnection.GetSchemaAsync .
• Relatórios de identidade do aplicativo por meio de SqlConnection.RegisteredApplication e da versão 2 do conteúdo de TDS USERAGENT. Defina a propriedade antes de abrir a conexão. O valor não faz parte da chave do pool de conexão, portanto, uma conexão física reutilizada informa qual aplicativo a criou originalmente. A identidade da aplicação é telemetria fornecida pelo cliente, não uma base para autorização ou outras decisões de segurança.
• Aliases de string de conexão como ColumnEncryption, ConnectTimeout, FailoverPartner, PacketSize, e WorkstationId.
• Mapeamentos de pseudo-colunas de grafo SQL para $node_id, $edge_id, $from_id e $to_id em SqlBulkCopy.
• O tipo json do SQL Server na coleção DataTypes retornada por SqlConnection.GetSchema, inclusive no SQL do Azure.
• Aceitar aplicação de Connection Idle Timeout por meio de Switch.Microsoft.Data.SqlClient.UseLegacyIdleTimeoutBehavior=false. O tempo limite padrão de idle é de 300 segundos; 0 desativa a expiração do idle. O comportamento padrão de pooling permanece inalterado.
• Um modo de aceitação de tempo limite de conexão que inclui o tempo gasto esperando por uma conexão em pool por meio de Switch.Microsoft.Data.SqlClient.UseOverallConnectTimeoutForPoolWait=true. O interruptor por padrão é false.
• Suporte ampliado a transações, recuperação de conexão interrompida, aquecimento do pool, poda ociosa, recuperação de conexão vazada e diagnósticos no pool de conexões V2. O pool permanece em avaliação e requer Switch.Microsoft.Data.SqlClient.UseConnectionPoolV2.
• Métodos assíncronos em provedores de armazenamento de chaves Always Encrypted. O driver ainda não chama esses métodos durante a execução do comando, então eles não tornam as operações Always Encrypted existentes assíncronas.
• Pacotes SNI nativos atualizados para 7.1.0. Os alvos de aplicação suportados permanecem o .NET Framework 4.6.2 e versões posteriores, além do .NET 8 e versões posteriores.

Mudanças de compatibilidade

• SqlConnectionStringBuilder.TransparentNetworkIPResolutionestá obsoleto no .NET Framework. Use MultiSubnetFailover em seu lugar. Essa mudança adiciona um aviso em tempo de compilação; não altera o comportamento em tempo de execução nem o padrão de nenhuma das opções.
• SqlBatchCommand.CommandBehavior e os CommandBehavior passados para SqlBatch.ExecuteReader são respeitados. Versões anteriores ignoravam essas configurações.
• A opção de conexão obsoleta Type System Version=SQL Server 2000 agora gera ArgumentException quando você abre a conexão. Use um valor com suporte, como Latest.

A versão 7.1 também inclui as correções de validação de certificados e enclaves disponibilizadas nas versões 6.1.7 e 7.0.3. Quando você habilita a validação de certificados no SNI gerenciado, ServerCertificate compara o arquivo de certificado configurado com o certificado apresentado pelo servidor. Um arquivo inválido ou ilegível faz a conexão falhar em vez de burlar a verificação do certificado configurado. O atestado de enclave do VSM (Modo Seguro Virtual) e do HGS (Serviço Guardião de Host) verifica se a chave pública do enclave está vinculada ao relatório de atestado assinado. Reteste esses caminhos ao fazer upgrade de uma versão anterior que não inclui essas correções.

Correções principais

• Corrigidas as conexões agrupadas que permaneciam quebradas após um rollback TransactionScope, o que poderia causar falha em uma chamada posterior BeginTransaction().
• Correção dos nomes literais de servidor IPv6 em Pipes Nomeados na SNI gerenciada.
• Fixou os overflows de grandes decimal parâmetros com precisão e escala explícitas, DateOnly parâmetros e parâmetros de tabela usando sql_variant, e dados de colunas em fluxo sendo pulados após IsDBNull().
• Corrigidos os contadores do pool de conexão, a atividade desnecessária do temporizador de manutenção do pool e as regressões de throughput V2 de abertura/fechamento do pool de conexão.
• Correção da lógica de repetição configurável registrando um manipulador permanente de resolução de assembly em todo o processo no .NET moderno. Assemblies de retentativas personalizadas devem estar no diretório base da aplicação; dependências carregadas após a construção do provedor devem ser resolvidas por meio da resolução normal de dependências da aplicação ou por um handler fornecido pela aplicação.

Lançamentos

A versão 7.1.0 do Azure Key Vault Provider implementa os métodos de provedor de armazenamento de chaves assíncronos e corrige o crescimento de cache e clientes de chave duplicados sob concorrência. Esses métodos assíncronos beneficiam chamadas diretas de provedores. Os caminhos de execução de comandos do driver ainda usam operações síncronas de chave. As versões da extensão do Azure e das abstrações de extensão alinham as versões sem alterações na API pública.

Para o histórico das prévias, veja as notas de lançamento para preview1, preview2 e preview3.

7.0 STS

A versão 7.0 atingiu disponibilidade geral em março de 2026. Ele permanece suportado até 17 de dezembro de 2026, três meses após o lançamento da versão 7.1.

Características e mudanças

• A autenticação Microsoft Entra fornecida pelo driver foi transferida do pacote principal para Microsoft.Data.SqlClient.Extensions.Azure. Adicione o pacote de extensão quando usar um modo de autenticação do Active Directory.
• O pacote principal não depende mais de Azure.Core, Azure.Identity, ou da Biblioteca do Microsoft Authenticator (MSAL).
• SqlConnection.SspiContextProvider suporta negociação personalizada de tokens Kerberos e NTLM. A identidade do provedor faz parte da chave do pool de conexão.
• Roteamento aprimorado para SQL do Azure Hyperscale e réplicas de leitura nomeadas é negociado automaticamente.
• Eventos de diagnóstico de comando, conexão e transação fortemente tipados estão disponíveis no .NET Framework e no .NET atual.
• SqlConfigurableRetryFactory.BaselineTransientErrors expõe a lista padrão de erros transitórios do driver.
• Active Directory Password A autenticação está obsoleta. Use autenticação interativa para aplicações de usuário, autenticação do principal de serviço para serviços ou identidade gerenciada para cargas de trabalho hospedadas no Azure.
• O suporte ao destino começa no .NET Framework 4.6.2 e .NET 8. O driver também suporta a construção e execução em .NET 10.

A multiplexação de pacotes para leituras assíncronas permanece como funcionalidade de pré-visualização e é opt-in na versão 7.0. Teste switches de compatibilidade com cargas de trabalho de produção e mantenha um caminho de rollback.

Lançamentos

6.1 LTS

A versão 6.1.0 foi lançada em julho de 2025, mas depois foi retirada da lista devido a regressões críticas. A versão 6.1.1, lançada em agosto de 2025, estabeleceu a linha 6.1 LTS suportada.

Características e mudanças

• Transporte vetorial nativo do SQL Server 2025 por meio de SqlVector<T>, inicialmente para vetores de ponto flutuante de precisão simples.
• Um recurso de referência .NET Standard 2.0 para compatibilidade com bibliotecas. Este ativo não é uma implementação de runtime. Aplicações executáveis devem usar um ativo de runtime suportado do .NET Framework ou .NET.
• Trabalho de multiplexação de pacotes opt-in para grandes leituras assíncronas e tratamento de endpoints para banco de dados SQL no Microsoft Fabric.
• Suporte aprimorado para compilação nativa Ahead-of-Time (AOT).
• Redução das alocações nos caminhos de processamento de conexão e de TDS.
• A base interna para a extensibilidade da SSPI (Interface do Provedor de Suporte de Segurança) foi adicionada na versão 7.0.

Não implante a versão 6.1.0. A versão 6.1.1 reverteu as alterações afetadas de detecção de pacotes e de reprodução.

Lançamentos

Linhas de lançamento anteriores

As seguintes linhas de lançamento não são mais suportadas. Use os resumos ao planejar uma atualização em várias versões de drivers.

6.0

A versão 6.0 atingiu disponibilidade geral em janeiro de 2025. O patch final foi 6.0.5, lançado em janeiro de 2026.

• Adicionou suporte nativo a SQL Server JSON por meio de Microsoft.Data.SqlTypes.SqlJson, incluindo caminhos de leitura, escrita, streaming e cópia em massa.
• Adicionados payloads diagnósticos públicos e fortemente tipados para eventos de comando, conexão e transação.
• Adicionado OpenAsync(SqlConnectionOverrides, CancellationToken), incluindo OpenWithoutRetry.
• Adicionado suporte a DateOnly e TimeOnly em parâmetros estruturados de DataTable e SqlDataRecord
• Adicionado suporte ao .NET 9.
• Removidos os ativos de runtime .NET Standard e .NET 6. Os alvos suportados passaram a ser o .NET Framework 4.6.2 e versões posteriores, além do .NET 8 e versões posteriores.
• EnableOptimizedParameterBinding restrito a comandos de texto.

Lançamentos

5.2

A versão 5.2 chegou à disponibilidade geral em fevereiro de 2024. O patch final foi 5.2.3, lançado em abril de 2025.

• Adicionado SqlConnection.AccessTokenCallback para aquisição de tokens assíncrona e compatível com pool.
• Adicionados SqlBatch e SqlBatchCommand no .NET 6 e versões posteriores.
• Adicionado suporte SqlDiagnosticListener ao .NET Standard.
• Adicionado 64 bits SqlBulkCopy.RowsCopied64. A propriedade mais antiga RowsCopied permanece um inteiro de 32 bits.
• Adicionada Active Directory Workload Identity autenticação.
• Adicionado suporte a .NET 8 e à plataforma big-endian.
• Alteração de UseOneSecFloorInTimeoutCalculationDuringLogin para o padrão para true.
• Usado NegotiateAuthentication para SSPI gerenciado no .NET 7 e versões posteriores.

Lançamentos

5.1

A versão 5.1 atingiu disponibilidade geral em janeiro de 2023. O patch final foi o 5.1.9, lançado em janeiro de 2026.

• Adicionado suporte ao .NET 6 e removido o suporte ao .NET Core 3.1.
• Adicionado suporte a DateOnly e TimeOnly para valores de parâmetros e GetFieldValue.
• Adição de TLS 1.3 no .NET e caminhos nativos da SNI (Interface de Rede do SQL Server).
• Adição de ServerCertificate para correspondência exata de certificado com Encrypt=Mandatory e Encrypt=Strict.
• Adicionado suporte ao Windows ARM64 para o .NET Framework.
• Tornou o SqlConnectionEncryptOption parser de strings público.
• A versão 5.1.3 corrigiu o caminho de downgrade de criptografia CVE-2024-0056 e a validação da cadeia de certificados.

Lançamentos

5.0

A versão 5.0 atingiu a disponibilidade geral em agosto de 2022. O patch final foi a versão 5.0.2, lançada em março de 2023.

• Adicionado TDS 8.0 por meio de Encrypt=Strict. O modo estrito inicia o TLS antes da troca de login do TDS e sempre valida o certificado do servidor.
• Mudou SqlConnectionStringBuilder.Encrypt de bool para SqlConnectionEncryptOption.
• Migração dos tipos de CLR (Common Language Runtime) do SQL Server para o pacote Microsoft.SqlServer.Server versionado separadamente.
• Adicionadas opções de conexão Server SPN e Failover Server SPN.
• Adicionado suporte a alias do Windows SQL Server no .NET atual.
• Adicionado SqlDataSourceEnumerator no Windows.
• Removido o suporte ao .NET Framework 4.6.1.

Lançamentos

4.1

A versão 4.1 chegou à disponibilidade geral em janeiro de 2022. O patch final foi 4.1.1, lançado em setembro de 2022.

• Adicionado Attestation Protocol=None para enclaves de Segurança Baseada em Virtualização (VBS).
• Solicitações do Protocolo de Resolução do SQL Server paralelizadas no Linux e macOS quando MultiSubnetFailover está habilitado.
• Corrigidas as verificações da lista de revogação de certificados durante a autenticação.
• Corrigido a autenticação do Microsoft Entra, valores nulos SqlBinary e rowversion, e o comportamento de colação do UTF-8.

Lançamentos

4.0

A versão 4.0 entrou em disponibilidade geral em novembro de 2021. O patch final foi 4.0.6, lançado em agosto de 2024.

• Alterou o valor padrão de Encrypt de false para true.
• Adicionado SqlCommand.EnableOptimizedParameterBinding para comandos com muitos parâmetros.
• Adicionado SqlFileStream para Windows através da implementação do .NET Standard.
• Adicionado suporte a instâncias compartilhadas de LocalDB no SNI gerenciado.
• Adicionado GetFieldValue<T> e GetFieldValueAsync<T> para XmlReader, TextReader, e Stream.
• Remoção da alternância de segurança da lógica de repetição configurável. O Retry permaneceu desativado até que um aplicativo configurasse um provedor.
• Alteração das falhas de autenticação do Microsoft Entra para lançar SqlException em vez de AggregateException.
• Removido o suporte ao .NET Core 2.1.
• A versão 4.0.5 corrigiu o caminho de downgrade de criptografia CVE-2024-0056 e a validação da cadeia de certificados.

Lançamentos

3.1

A versão 3.1 atingiu disponibilidade geral em março de 2022. O patch final foi 3.1.7, lançado em agosto de 2024.

• Adicionado Attestation Protocol=None para enclaves VBS.
• Adicionados os erros SQL 42108 e 42109 à lista padrão de erros transitórios.
• Adicionado suporte ao Windows ARM64 para .NET Framework na versão 3.1.2.
• Redução das repetidas solicitações de tokens Microsoft Entra por meio da aquisição silenciosa de tokens na versão 3.1.3.
• Corrigido o caminho de downgrade de criptografia CVE-2024-0056 na versão 3.1.5.
• Corrigidos o cleanup de transações antes do pooling e o tratamento de timeout do token Microsoft Entra na 3.1.7.

Lançamentos

3.0

A versão 3.0 chegou à disponibilidade geral em junho de 2021. O patch final foi 3.0.1, lançado em setembro de 2021.

• Adicionada lógica de retentativa configurável para operações de conexão e comando. Na versão 3.0, permaneceu como opção de aceitação, condicionado a Switch.Microsoft.Data.SqlClient.EnableRetryLogic.
• Adicionados EventCounters para conexão e atividade do pool.
• Adicionada Active Directory Default autenticação por meio de Azure.Identity.
• Adicionou o registro de provedor de armazenamento de chaves Always Encrypted com escopo de conexão e comando.
• Preferência de endereço IP TCP adicionada.
• Alterada a autenticação de identidade gerenciada atribuída pelo usuário para usar o ID do cliente em vez do ID do objeto em User Id.
• Alteração dos valores nulos rowversion de SQL para retornar DBNull em vez de uma matriz de bytes vazia. Um switch AppContext preservou o comportamento antigo.
• Elevei a versão mínima de destino do .NET Framework de 4.6 para 4.6.1.

Provedores de armazenamento de chaves do sistema têm precedência sobre provedores registrados em uma conexão ou comando a partir da versão 3.0. Renomeie um provedor personalizado se seu nome conflitar com o de um provedor embutido.

Lançamentos

2.1

A versão 2.1 chegou à disponibilidade geral em novembro de 2020. O patch final foi 2.1.7, lançado em janeiro de 2024.

• Estendemos o Always Encrypted para as plataformas .NET Standard 2.0 compatíveis.
• Adicionou suporte a enclave seguro no Unix para .NET Core e em plataformas .NET Standard 2.1.
• Adição de Active Directory Device Code Flow e gerenciei a autenticação de identidade gerenciada.
• Foram adicionados ganchos de personalização para autenticação interativa e de código de dispositivo.
• Adição de metadados de classificação de confidencialidade.
• Adicionado SqlConnection.ServerProcessId.
• Adicionada a Command Timeout opção de conexão como padrão para comandos criados por uma conexão.
• A versão 2.1.7 corrigiu o caminho de downgrade de criptografia CVE-2024-0056.

Lançamentos

2.0

A versão 2.0 chegou à disponibilidade geral em junho de 2020. A versão final do patch foi 2.0.1, lançada em agosto de 2020.

• Adicionada a autenticação Active Directory Interactive e Active Directory Integrated no .NET Core e no .NET Standard.
• Adicionada Active Directory Service Principal autenticação.
• Adicionado Microsoft.Data.SqlClient.EventSource rastreamento.
• Adicionado suporte multiplataforma a TCP keep-alive e uma implementação de rede gerenciada opt-in no Windows para testes e depuração. O caminho gerenciado não suportava autenticação do Windows que não seja de domínio.
• Adição de SqlBulkCopy.RowsCopied e solicitação de dicas de cópia em massa.
• Adicionado SqlConnection.Open(SqlConnectionOverrides.OpenWithoutRetry).
• Adicionei suporte a Windows ARM através da Microsoft.Data.SqlClient.SNI.runtime dependência.
• Começou a validar o certificado do servidor quando um servidor força a criptografia, inclusive quando a cadeia de conexão define Encrypt=false. As conexões podem falhar após essa atualização se o certificado não for confiável ou se seu nome não corresponder ao servidor.
• Alterado o tratamento da escala de parâmetros decimais para usar arredondamento compatível com SQL Server.

Lançamentos

1.1

A versão 1.1 chegou à disponibilidade geral em novembro de 2019. O patch final foi a 1.1.4, lançada em março de 2021.

• Adicionado Always Encrypted com enclaves seguros nos alvos suportados do Framework .NET e do .NET Core.
• Adicionada expansão |DataDirectory| em AttachDBFilename no .NET Core.
• Leituras assíncronas aprimoradas com cache multipacote de buffer de destino.
• Redução da sobrecarga de snapshots em TdsParserStateObject e SqlDataReader.
• Erros de cabeçalho de estado de timeout e de Múltiplos Conjuntos de Resultados Ativos (MARS) corrigidos em patches posteriores.

Lançamentos

1.0

Microsoft. Data.SqlClient 1.0 atingiu disponibilidade geral em agosto de 2019. O patch final foi 1.0.19269.1, lançado em setembro de 2019.

• Introdução do provedor Microsoft.Data.SqlClient fornecido separadamente.
• Suporta o .NET Framework 4.6 e versões posteriores, .NET Core 2.1 e versões posteriores e o .NET Standard 2.0.
• Adicionada Active Directory Interactive autenticação no .NET Framework.
• Adicionada Active Directory Password autenticação no .NET Core.
• Metadados de classificação de sensibilidade de dados adicionados em SqlDataReader.
• Adicionado suporte à ordenação UTF-8 do SQL Server 2019.
• Adicionado suporte a Always Encrypted no .NET Core.

Lançamentos

Para uma aplicação migrando do provedor antigo, use Migrar do System.Data.SqlClient para Microsoft.Data.SqlClient em vez de ler apenas as notas de versão.

Notas opcionais de lançamento do pacote

Pacotes opcionais têm suas próprias notas de lançamento. A partir da versão 7.0.2, eles são enviados alinhado à versão com o driver principal.

Não faça referência a Microsoft.Data.SqlClient.Internal.Logging diretamente. É uma dependência interna compartilhada pelos pacotes de drivers.

Avalie uma atualização

1. Identifique cada driver e cada versão de pacote opcional usados direta ou transitivamente.
2. Leia as notas de lançamento de todas as versões secundárias e principais abrangidas pela atualização.
3. Verifique o ciclo de vida do suporte ao driver SqlClient para compatibilidade com o framework alvo e banco de dados.
4. Atualize todos os pacotes relacionados para versões compatíveis.
5. Construa e teste a autenticação da aplicação, criptografia, pooling de conexões, parâmetros, transações, novas tentativas, diagnósticos e saída de implantação.

Para ver comandos de instalação e implantação, consulte Instalar, atualizar e implantar Microsoft.Data.SqlClient.

Conteúdo relacionado

• Instalar, atualizar e implantar o Microsoft.Data.SqlClient
• Ciclo de vida de suporte do driver do SqlClient
• Migre do System.Data.SqlClient para o Microsoft.Data.SqlClient
• Notas de versão do Microsoft.Data.SqlClient