Baixar a versão mais recente
Este artigo lista os recursos e correções das versões lançadas do SqlPackage.
Como ler estas notas de versão
A coluna Aplica-se a em cada seção está delimitada da seguinte forma:
-
CLI do SqlPackage – ações de linha de comando (publicar, importar, exportar, extrair, Parquet, diagnóstico, ferramenta dotnet)
-
Projetos MSBuild/SQL – compilação de projeto SQL (
Microsoft.Build.Sql SDK, integração do SQL Server Data Tools (SSDT))
-
DacFx API / Comparação de esquema -
Microsoft.SqlServer.DacFx APIs do NuGet, Comparação de esquema
-
Plataforma – ScriptDom, Microsoft.Data.SqlClient, suporte ao .NET, DACPACs do sistema, padrões de compatibilidade
Versões atuais (170.x)
As versões a seguir são as versões com suporte no momento do SqlPackage.
170.3.93 SqlPackage
Data de lançamento: 10 de fevereiro de 2026
dotnet tool install -g microsoft.sqlpackage --version 170.3.93
Features
| Feature |
Details |
Aplica-se a |
| Deployment |
Adicionado suporte para opções ACCELERATED_DATABASE_RECOVERY de banco de dados e OPTIMIZED_LOCKING. |
CLI do SqlPackage; Comparação de esquema/API do DacFx |
| Permissions |
Aprimora a publicação de permissões para incluir as permissões EXECUTE ON EXTERNAL MODEL. |
CLI do SqlPackage; Comparação de esquema/API do DacFx |
| Platform |
Adicionado suporte para .NET 10 à biblioteca DacFx e à CLI do SqlPackage. O SqlPackage dotnet tool está disponível para .NET 8 e .NET 10. |
Plataforma; CLI do SqlPackage; API do DacFx/Comparação de esquema |
| Platform |
Adicionado suporte ao .NET Standard 2.0 à biblioteca DacFx. |
Plataforma; Comparação de esquema/API do DacFx |
| Platform |
Faz referência a Microsoft.Data.SqlClient v6.1.3. |
Platform |
| ScriptDom |
ScriptDom atualizado para a versão 170.157.0. |
Platform |
| Vector |
Estende o suporte a colunas de vetor para permitir a alteração do tipo base. |
CLI do SqlPackage; Projetos MSBuild/SQL; Comparação de esquema/API do DacFx |
Fixes
| Feature |
Details |
Aplica-se a |
| Deployment |
Corrigido um bug com a implantação no banco de dados SQL no Microsoft Fabric quando o banco de dados de destino inclui uma política de segurança. |
CLI do SqlPackage; Comparação de esquema/API do DacFx |
| Export |
Corrigido um problema em que os arquivos exportados falhavam na validação do esquema XSD .dacpac devido a valores de atributos booleanos usando valores True/False em vez de minúsculas true/false.
Problema do GitHub |
SqlPackage CLI |
| Import |
Corrigido um problema em que a importação de uma tabela com caracteres especiais no nome (como /, "ou $) falhava silenciosamente na importação de dados sem avisar o usuário.
Problema do GitHub |
SqlPackage CLI |
| Ledger |
Corrigido um problema em que uma tabela de ledger com uma coluna computada causa um NullReferenceException durante a validação e compilação do modelo.
Problema do GitHub |
Projetos MSBuild/SQL; Comparação de esquema/API do DacFx |
| Projetos SQL |
Correção de um problema em que a criação de um projeto SQL com uma definição de índice columnstore clusterizado embutido em uma tabela falhava com um erro de sintaxe.
Problema do GitHub |
Projetos MSBuild/SQL |
| Projetos SQL |
Corrigido um problema em que um índice columnstore clusterizado em uma tabela com NVARCHAR(MAX) ou outras colunas do tipo LOB incorretamente relata um erro indicando que índices columnstore não têm suporte para colunas de vetor.
Problema do GitHub |
Projetos MSBuild/SQL |
| Vector |
Correção de um problema em que os procedimentos que usavam VECTOR_SEARCH emitem um aviso de validação de que a referência de coluna não podia ser resolvida.
Problema do GitHub |
Projetos MSBuild/SQL; Comparação de esquema/API do DacFx |
170.2.70 SqlPackage
Data de lançamento: 14 de outubro de 2025
dotnet tool install -g microsoft.sqlpackage --version 170.2.70
Features
| Feature |
Details |
Aplica-se a |
| Modelos externos |
Adicionado suporte para modelos externos no Banco de Dados SQL do Azure e no SQL Server 2025 (17.x) para importação, exportação, extração, implantação e build de projeto sql. |
CLI do SqlPackage; Projetos MSBuild/SQL; Comparação de esquema/API do DacFx |
| Modelos externos |
Adicionado suporte para funções AI_GENERATE_CHUNKS e AI_GENERATE_EMBEDDINGS. |
CLI do SqlPackage; Comparação de esquema/API do DacFx |
| JSON |
Adicionado suporte para índices JSON no Banco de Dados SQL do Azure e no SQL Server 2025 (17.x) para importação, exportação, extração, implantação e build de projeto sql. |
CLI do SqlPackage; Projetos MSBuild/SQL; Comparação de esquema/API do DacFx |
| JSON |
Adicionado suporte para funções JSON JSON_ARRAYAGG, JSON_OBJECTAGG e JSON_QUERY. |
CLI do SqlPackage; Projetos MSBuild/SQL; Comparação de esquema/API do DacFx |
| Platform |
O SDK de .NET para build do SqlPackage .zip foi atualizado para 8.0.414 |
Plataforma; SqlPackage CLI |
| Regex |
Adicionado suporte para a REGEXP_LIKE função. |
CLI do SqlPackage; Projetos MSBuild/SQL; Comparação de esquema/API do DacFx |
| ScriptDom |
ScriptDom atualizado para a versão 170.128.0. |
Platform |
| Vector |
Adicionado suporte para os índices de vetor no Azure SQL Database e no SQL Server 2025 (17.x) para importação, exportação, extração, implantação e construção do projeto SQL. |
CLI do SqlPackage; Projetos MSBuild/SQL; Comparação de esquema/API do DacFx |
| Vector |
Expande o suporte ao tipo de dados de vetor para o SQL Server 2025 (17.x) e especifica o tamanho de float de 32 bits. |
CLI do SqlPackage; Projetos MSBuild/SQL; Comparação de esquema/API do DacFx |
| Vector |
Adicionado suporte para a função VECTOR_SEARCHVector. |
CLI do SqlPackage; Projetos MSBuild/SQL; Comparação de esquema/API do DacFx |
Fixes
| Feature |
Details |
Aplica-se a |
| Mascaramento de dados |
Correção de um problema em que as funções de mascaramento de dados datetime não eram reconhecidas durante o build do projeto.
Problema do GitHub |
Projetos MSBuild/SQL |
| Modelos externos |
Corrigido um problema em que dependências de modelo externo em uma credencial com escopo de banco de dados causavam falha na compilação do projeto. |
Projetos MSBuild/SQL |
| JSON |
Correção de um bug ao comparar índices JSON com o caminho JSON padrão. |
Comparação de esquema/API do DacFx; SqlPackage CLI |
| Platform |
Faz referência a Microsoft.Data.SqlClient v5.1.7. |
Platform |
| XML |
Foi corrigido um problema em que o caminho da consulta XML (xQuery) não era tratado como sensível a maiúsculas e minúsculas durante a comparação de modelo. Mesmo em bancos de dados que não diferenciam maiúsculas de minúsculas, o caminho xQuery diferencia maiúsculas de minúsculas.
Problema do GitHub |
Comparação de esquema/API do DacFx; SqlPackage CLI |
170.1.61 SqlPackage
Data de lançamento: 30 de julho de 2025
dotnet tool install -g microsoft.sqlpackage --version 170.1.61
Features
| Feature |
Details |
Aplica-se a |
| Virtualização de dados |
Adicionado suporte para objetos relacionados à virtualização de dados para o Banco de Dados SQL do Azure em operações de importação, exportação, extração e publicação. |
SqlPackage CLI |
| Virtualização de dados |
Adicionou o Azure SQL Database à visualização de pré-lançamento com arquivos parquet, permitindo o uso de Azure Blob Storage e arquivos parquet para importar dados para o banco de dados. A extração de dados para arquivos parquet não está disponível para o Banco de Dados SQL do Azure, pois depende da funcionalidade não disponível no Banco de Dados SQL do Azure. CREATE EXTERNAL TABLE AS SELECT |
SqlPackage CLI |
| Deployment |
Adicionado suporte para propriedades de publicar /p:IgnorePreDeployScript e /p:IgnorePostDeployScript. Essas propriedades são padrão para false e quando habilitadas resultam no plano de implantação omitindo os scripts correspondentes.
Problema do GitHub |
CLI do SqlPackage; Comparação de esquema/API do DacFx |
| Permissions |
Adicionado suporte para a permissão ALTER ANY EXTERNAL MIRROR para o Banco de Dados SQL do Azure e o Banco de Dados SQL no Microsoft Fabric. Essa permissão é necessária para exportar um banco de dados que contenha uma ou mais tabelas espelhadas.
Problema do GitHub |
CLI do SqlPackage; Comparação de esquema/API do DacFx |
| Permissions |
Adicionado suporte para as permissões CREATE ANY EXTERNAL MODEL e ALTER ANY EXTERNAL MODEL para o SQL Server 2025 (17.x). |
CLI do SqlPackage; API do DacFx / Comparação de esquema |
| Permissions |
Adicionado suporte para a permissão ALTER ANY INFORMATION PROTECTION para o SQL Server 2025 (17.x) e o Banco de Dados SQL do Azure. |
CLI do SqlPackage; Comparação de esquema/API do DacFx |
| Platform |
O SDK do SqlPackage .zip para build .NET foi atualizado para 8.0.412. |
Plataforma; SqlPackage CLI |
| ScriptDom |
ScriptDom atualizado para a versão 170.0.64. |
Platform |
| ScriptDom |
Atualiza o Data warehouse na plataforma Fabric para usar o TSqlFabricDWParser ScriptDom. |
Plataforma; Comparação de esquema/API do DacFx |
Fixes
| Feature |
Details |
Aplica-se a |
| Sempre Criptografado |
Correção de um problema em que a opção Interactive para o /AzureKeyVaultAuthMethod parâmetro de publicação não estava funcionando corretamente. |
SqlPackage CLI |
| Deployment |
Correção de um problema em que a DbScopedConfigMaxDOPSecondarypropriedade não estava definida corretamente na implantação.
Problema do GitHub |
CLI do SqlPackage; Comparação de esquema/API do DacFx |
| Deployment |
Correção de um problema em que a publicação de tabelas que contêm restrições de chave estrangeira falhava devido a uma sintaxe não suportada no armazenamento de dados do Microsoft Fabric. |
SqlPackage CLI |
| Deployment |
Correção de um problema em que objetos de servidor eram incluídos durante a implantação no banco de dados SQL no Microsoft Fabric. Não há suporte para objetos de servidor no banco de dados SQL no Microsoft Fabric.
Problema do GitHub |
SqlPackage CLI |
| Deployment |
Correção de um problema em que índices columnstore clusterizados são criados criando primeiro um índice clusterizado, o que aumenta a sobrecarga e o tempo da implantação.
Problema do GitHub |
SqlPackage CLI |
| Extract |
Correção de um problema em que extrair um banco de dados do banco de dados SQL no Microsoft Fabric resulta em scripts de definição de usuário inutilizáveis.
Problema do GitHub |
SqlPackage CLI |
170.0.94 SqlPackage
Data de lançamento: 15 de abril de 2025
dotnet tool install -g microsoft.sqlpackage --version 170.0.94
Features
| Feature |
Details |
Aplica-se a |
| DACPACVerify |
O suporte para verificar o conteúdo de dois .dacpac arquivos é adicionado na ferramenta de visualização Microsoft.DacpacVerify. |
Comparação de esquema/API do DacFx |
| Extract |
Adicionado suporte para desempacotar um .dacpac arquivo em uma pasta. O comando /Action:Extract é usado com os parâmetros /SourceFile: e /TargetFile:. O arquivo de destino deve ser uma pasta e quando um arquivo de origem (.dacpac) é especificado, nenhuma propriedade de conexão de banco de dados é válida. A propriedade /p:ExtractTarget=SchemaObjectType é necessária para extrair de um .dacpac arquivo em vez de um banco de dados de origem. O executável Dacunpack.exe é removido do DacFx.msi instalador. |
CLI do SqlPackage; Comparação de esquema/API do DacFx |
| Parquet |
Adicionado suporte para os tipos de dados timestamp, rowversion, uniqueidentifier, text, ntext, image, json, xml e vector ao usar arquivos Parquet no Armazenamento de Blobs do Azure com operações de extração e publicação do SqlPackage. |
SqlPackage CLI |
| Parquet |
Adicionado suporte para exportar e importar dados de tabela para arquivos BCP quando a tabela contiver um tipo de dados sem suporte ao usar arquivos Parquet no Armazenamento de Blobs do Azure para os dados restantes com operações de extração e publicação do SqlPackage. Um tipo de dados de exemplo é sql_variant. Uma tabela que contém uma coluna desse tipo é gravada no BCP, enquanto as tabelas restantes são gravadas em arquivos Parquet no Armazenamento de Blobs do Azure. |
SqlPackage CLI |
| Platform |
Atualização do SqlPackage para a versão 4.7.2 do .NET Framework. |
Plataforma; SqlPackage CLI |
| Platform |
Suporte removido para .NET 6. |
Plataforma; SqlPackage CLI |
| ScriptDom |
ScriptDom atualizado para a versão 170.18.0. |
Platform |
| Projetos SQL |
O nível de compatibilidade padrão do Banco de Dados SQL do Azure e do Banco de Dados SQL no Microsoft Fabric agora está definido como 170. Para obter mais informações, consulte o nível de compatibilidade do banco de dados 170 no Banco de Dados SQL do Azure e no Banco de Dados SQL no Microsoft Fabric. |
Projetos MSBuild/SQL |
| Vector |
O tipo de dados Vetor agora tem suporte na plataforma de destino Azure SQL Database para importação, exportação, extração, implantação e criação de projetos SQL. |
CLI do SqlPackage; Projetos MSBuild/SQL; Comparação de esquema/API do DacFx |
Fixes
| Feature |
Details |
Aplica-se a |
| Deployment |
Correção de um problema em que a implantação de uma alteração em uma tabela externa fazia com que todas as tabelas externas fossem descartadas e recriadas se a tabela modificada não contivesse valores para REJECT_VALUE ou REJECT_SAMPLE_VALUE. |
CLI do SqlPackage; Comparação de esquema/API do DacFx |
| Deployment |
Correção de um problema em que alterar uma coluna para expandir seu comprimento resulta em um aviso de perda de dados incorreto se a ordenação da coluna for especificada e corresponder à ordenação padrão do banco de dados.
Problema do GitHub |
CLI do SqlPackage; Comparação de esquema/API do DacFx |
| Deployment |
Foi corrigido um problema onde alterações na classificação de sensibilidade em uma tabela causavam a recriação dos índices.
Problema do GitHub |
CLI do SqlPackage; Comparação de esquema/API do DacFx |
| Export |
O uso da estimativa de tamanho da tabela foi otimizado durante as operações de exportação. |
SqlPackage CLI |
| Extract |
Corrigido um problema onde a extração de uma referência de banco de dados .dacpac falhava.
Problema do GitHub |
CLI do SqlPackage; Comparação de esquema/API do DacFx |
| Armazém de Dados do Fabric |
Corrigido um problema em que os procedimentos armazenados do sistema sp_refreshsqlmodule eram chamados durante uma operação de publicação. O Fabric Data Warehouse não dá suporte sp_refreshsqlmodule e isso faz com que a implantação falhe. |
SqlPackage CLI |
| Data Warehouse do Fabric |
Corrigido um problema em que as restrições de tabela são incluídas em um arquivo .dacpac, mas não em arquivos .sql, quando um banco de dados foi extraído de um Fabric Data Warehouse.
Problema do GitHub |
SqlPackage CLI |
| Projetos SQL |
Correção de um problema em que a criação sem SSDT instalada no Visual Studio resulta em um comportamento de build incorreto.
Problema do GitHub |
Projetos MSBuild/SQL |
| Projetos SQL |
Correção de um problema em que os avisos de build são duplicados na saída quando a análise de código está habilitada.
Problema do GitHub |
Projetos MSBuild/SQL |
| Projetos SQL |
Correção de um problema em que os parâmetros do service broker definidos como variáveis resultam em avisos falsos.
Problema do GitHub |
Projetos MSBuild/SQL |
Versões arquivadas (162.x e versões anteriores)
Você pode encontrar notas de versão para a versão 162.x e versões mais antigas no arquivo de notas de versão do SqlPackage.