Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Faça o download da versão mais recente
Este artigo lista os recursos e correções entregues pelas versões lançadas do SqlPackage.
Como ler estas notas de lançamento
A coluna Aplica-se a em cada secção está definida da seguinte forma:
- SqlPackage CLI - ações de linha de comandos (publicar, importar, exportar, extrair, Parquet, diagnóstico, ferramenta dotnet)
-
Projetos MSBuild / SQL - Compilação de projeto SQL (
Microsoft.Build.SqlSDK, integração com SQL Server Data Tools (SSDT)) -
API DacFx / Comparação de esquemas -
Microsoft.SqlServer.DacFxAPIs NuGet, comparação de esquemas - Plataforma - ScriptDom, Microsoft.Data.SqlClient, suporte a .NET, DACPACs do sistema, padrões de compatibilidade
Lançamentos atuais (170.x)
As versões seguintes são as versões atualmente suportadas 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
| Platform | Download |
|---|---|
| Windows .NET 10 | .zip ficheiro |
| Windows | ficheiro .msi |
| macOS .NET 10 | .zip ficheiro |
| Linux .NET 10 | .zip ficheiro |
Features
| Feature | Details | Aplica-se a |
|---|---|---|
| Deployment | Adicionado suporte para opções ACCELERATED_DATABASE_RECOVERY de base de dados e OPTIMIZED_LOCKING. |
SqlPackage CLI; API DacFx / Comparação de esquemas |
| Permissions | Melhora a publicação de permissões para incluir EXECUTE ON EXTERNAL MODEL permissões. |
SqlPackage CLI; API DacFx / Comparação de esquemas |
| Platform | Foi adicionado suporte a .NET 10 à biblioteca DacFx e à CLI SqlPackage. O SqlPackage dotnet tool está disponível tanto para .NET 8 como para .NET 10. |
Plataforma; SqlPackage CLI; API DacFx / Comparação de esquemas |
| Platform | Adicionado suporte para .NET Standard 2.0 à biblioteca DacFx. | Plataforma; API DacFx / Comparação de esquemas |
| Platform | Referências a Microsoft.Data.SqlClient v6.1.3. | Platform |
| ScriptDom | Atualizei o ScriptDom para a versão 170.157.0. | Platform |
| Vector | Estende o suporte a colunas vetoriais para permitir a alteração do tipo base. | SqlPackage CLI; MSBuild / projetos SQL; API DacFx / Comparação de esquemas |
Fixes
| Feature | Details | Aplica-se a |
|---|---|---|
| Deployment | Corrigido um bug ao implementar para uma base de dados SQL no Microsoft Fabric quando a base de dados alvo inclui uma política de segurança. | SqlPackage CLI; API DacFx / Comparação de esquemas |
| Export | Corrigido um problema em que os ficheiros .dacpac exportados falhavam na validação do esquema XSD devido a valores de atributos booleanos utilizarem valores True/False em maiúsculas em vez de em minúsculas true/false.
Problema do GitHub |
SqlPackage CLI |
| Import | Corrigido um problema em que importar uma tabela com caracteres especiais no nome (como /, ", ou $) falha silenciosamente na importação de dados sem avisar o utilizador.
Problema do GitHub |
SqlPackage CLI |
| Ledger | Resolvi um problema em que uma tabela de registo com uma coluna calculada causa um NullReferenceException problema durante a validação e construção do modelo.
Problema do GitHub |
MSBuild / projetos SQL; API DacFx / Comparação de esquemas |
| Projetos SQL | Resolvi um problema em que construir um projeto SQL com uma definição de índice de coluna em cluster inline numa tabela falha devido a um erro de sintaxe. Problema do GitHub | Projetos MSBuild / SQL |
| Projetos SQL | Corrigido um problema em que um índice clusterizado columnstore numa tabela com NVARCHAR(MAX) ou outras colunas do tipo LOB reporta incorretamente um erro, indicando que os índices columnstore não são suportados em colunas do tipo vetorial.
Problema do GitHub |
Projetos MSBuild / SQL |
| Vector | Corrigido um problema em que procedimentos que utilizam VECTOR_SEARCH acionam um aviso de validação indicando que a referência da coluna não pôde ser resolvida.
Problema do GitHub |
MSBuild / projetos SQL; API DacFx / Comparação de esquemas |
170.2.70 SqlPackage
Data de lançamento: Outubro 14, 2025
dotnet tool install -g microsoft.sqlpackage --version 170.2.70
| Platform | Download |
|---|---|
| Windows .NET 8 | .zip ficheiro |
| Windows | ficheiro .msi |
| macOS .NET 8 | .zip ficheiro |
| Linux .NET 8 | .zip ficheiro |
Features
| Feature | Details | Aplica-se a |
|---|---|---|
| Modelos externos | Foi adicionado suporte para modelos externos no Azure SQL Database e SQL Server 2025 (17.x) para importação, exportação, extração, implementação e construção de projetos SQL. | SqlPackage CLI; MSBuild / projetos SQL; API DacFx / Comparação de esquemas |
| Modelos externos | Foi adicionado suporte para funções AI_GENERATE_CHUNKS e AI_GENERATE_EMBEDDINGS. |
SqlPackage CLI; API DacFx / Comparação de esquemas |
| JSON | Foi adicionado suporte para índices JSON no Azure SQL Database e SQL Server 2025 (17.x) para importação, exportação, extração, implementação e construção de projetos SQL. | SqlPackage CLI; MSBuild / projetos SQL; API DacFx / Comparação de esquemas |
| JSON | Acrescentou suporte para funções JSON_ARRAYAGGJSON , JSON_OBJECTAGG, e JSON_QUERY. |
SqlPackage CLI; MSBuild / projetos SQL; API DacFx / Comparação de esquemas |
| Platform | O SDK .NET da compilação SqlPackage .zip está atualizado para a versão 8.0.414 |
Plataforma; SqlPackage CLI |
| Regex | Adicionei suporte para a REGEXP_LIKE função. |
SqlPackage CLI; MSBuild / projetos SQL; API DacFx / Comparação de esquemas |
| ScriptDom | ScriptDom atualizado para a versão 170.128.0. | Platform |
| Vector | Foi adicionado suporte para os índices vetoriais no Azure SQL Database e SQL Server 2025 (17.x) para importação, exportação, extração, implementação e construção de projetos SQL. | SqlPackage CLI; MSBuild / projetos SQL; API DacFx / Comparação de esquemas |
| Vector | Expande o suporte para tipos de dados vetoriais para SQL Server 2025 (17.x) e especifica o tamanho float de 32 bits. | SqlPackage CLI; MSBuild / projetos SQL; API DacFx / Comparação de esquemas |
| Vector | Adicionou suporte para a função VECTOR_SEARCHvetorial . |
SqlPackage CLI; MSBuild / projetos SQL; API DacFx / Comparação de esquemas |
Fixes
| Feature | Details | Aplica-se a |
|---|---|---|
| Mascaramento de dados | Corrigido um problema em que as funções de mascaramento de dados data-hora não eram reconhecidas durante a construção do projeto. Problema do GitHub | Projetos MSBuild / SQL |
| Modelos externos | Corrigido um problema em que dependências externas de modelos numa credencial com âmbito de base de dados fazem com que a build do projeto falhe. | Projetos MSBuild / SQL |
| JSON | Corrigido um bug ao comparar índices JSON com o caminho JSON padrão. | API DacFx / Comparação de esquemas; SqlPackage CLI |
| Platform | Referências : Microsoft.Data.SqlClient v5.1.7. | Platform |
| XML | Corrigido um problema em que o caminho de consulta XML (xQuery) não era tratado como sensível a maiúsculas e minúsculas durante a comparação de modelos. Mesmo em bancos de dados que não diferenciam maiúsculas de minúsculas, o caminho do xQuery diferencia maiúsculas de minúsculas. Problema do GitHub | API DacFx / Comparação de esquemas; SqlPackage CLI |
170.1.61 SqlPackage
Data de lançamento: Julho 30, 2025
dotnet tool install -g microsoft.sqlpackage --version 170.1.61
| Platform | Download |
|---|---|
| Windows .NET 8 | .zip ficheiro |
| Windows | ficheiro .msi |
| macOS .NET 8 | .zip ficheiro |
| Linux .NET 8 | .zip ficheiro |
Features
| Feature | Details | Aplica-se a |
|---|---|---|
| Virtualização de dados | Foi adicionado suporte para objetos relacionados com virtualização de dados para Azure SQL Database em operações de importação, exportação, extração e publicação. | SqlPackage CLI |
| Virtualização de dados | Azure SQL Database foi adicionada à pré-visualização de publicar com ficheiros Parquet, permitindo o uso do Azure Blob Storage e ficheiros Parquet para importar dados para uma base de dados. Extrair dados para ficheiros parquet não está disponível para Azure SQL Database, pois depende de funcionalidade não disponível no Azure SQL Database, CREATE EXTERNAL TABLE AS SELECT. |
SqlPackage CLI |
| Deployment | Foi adicionado suporte para propriedades /p:IgnorePreDeployScript de publicação e /p:IgnorePostDeployScript. Essas propriedades são padrão para false e, quando ativadas, resultam no plano de implantação omitir os scripts correspondentes.
Problema do GitHub |
SqlPackage CLI; API DacFx / Comparação de esquemas |
| Permissions | Foi adicionado suporte para a permissão ALTER ANY EXTERNAL MIRROR para Azure SQL Database e SQL Database no Microsoft Fabric. Essa permissão é necessária para exportar um banco de dados que contenha uma ou mais tabelas espelhadas.
Problema do GitHub |
SqlPackage CLI; API DacFx / Comparação de esquemas |
| Permissions | Adicionei suporte para as permissões CREATE ANY EXTERNAL MODEL e ALTER ANY EXTERNAL MODEL para o SQL Server 2025 (17.x). |
SqlPackage CLI; API DacFx / Comparação de esquemas |
| Permissions | Adicionei suporte para as permissões ALTER ANY INFORMATION PROTECTION do SQL Server 2025 (17.x) e do Azure SQL Database. |
SqlPackage CLI; API DacFx / Comparação de esquemas |
| Platform | O SDK .NET da compilação SqlPackage .zip foi atualizado para a versão 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, utilizando o ScriptDom em TSqlFabricDWParser. |
Plataforma; API DacFx / Comparação de esquemas |
Fixes
| Feature | Details | Aplica-se a |
|---|---|---|
| Sempre criptografado | Corrigi um problema em que a Interactive opção para o /AzureKeyVaultAuthMethod parâmetro de publicação não estava a funcionar corretamente. |
SqlPackage CLI |
| Deployment | Corrigiu um problema em que a DbScopedConfigMaxDOPSecondarypropriedade não estava corretamente definida na implementação.
Problema do GitHub |
SqlPackage CLI; API DacFx / Comparação de esquemas |
| Deployment | Corrigido um problema em que tabelas de publicação contendo restrições de chave estrangeira falha com sintaxe não suportada no Data Warehouse no Microsoft Fabric. | SqlPackage CLI |
| Deployment | Corrigiu um problema em que objetos do servidor eram incluídos ao serem implementados numa base de dados SQL no Microsoft Fabric. Os objetos servidor não são suportados na base de dados SQL no Microsoft Fabric. Problema do GitHub | SqlPackage CLI |
| Deployment | Corrigido um problema em que índices colunares clusterizados são criados primeiro ao criar um índice clusterizado, o que aumenta a sobrecarga e o tempo de implementação. Problema do GitHub | SqlPackage CLI |
| Extract | Corrigi um problema em que extrair uma base de dados de uma base de dados SQL no Microsoft Fabric resulta em scripts de definição de utilizador 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
| Platform | Download |
|---|---|
| Windows .NET 8 | .zip ficheiro |
| Windows | ficheiro .msi |
| macOS .NET 8 | .zip ficheiro |
| Linux .NET 8 | .zip ficheiro |
Features
| Feature | Details | Aplica-se a |
|---|---|---|
| DACPACVerify | Suporte para verificar o conteúdo de dois .dacpac arquivos é adicionado na ferramenta de visualização Microsoft.DacpacVerify. |
API DacFx / Comparação de esquemas |
| Extract | Adicionei suporte para desempacotar um .dacpac ficheiro numa pasta. O /Action:Extract comando é usado com /SourceFile: e /TargetFile: parâmetros. 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. |
SqlPackage CLI; API DacFx / Comparação de esquemas |
| Parquet | Foi adicionado suporte para os tipos de dados timestamp, rowversion, uniqueidentifier, text, ntext, image, json, xml e vector ao usar ficheiros Parquet no Azure Blob Storage com operações de extração e publicação SqlPackage. | SqlPackage CLI |
| Parquet | Foi adicionado suporte para exportar e importar dados de tabelas para ficheiros BCP quando a tabela contém um tipo de dado não suportado, utilizando ficheiros Parquet no Azure Blob Storage para os dados restantes com operações de extração e publicação do SqlPaket. Um tipo de dado de exemplo é sql_variant, e uma tabela contendo uma coluna desse tipo é escrita para BCP .dacpac, enquanto as restantes tabelas são gravadas em ficheiros Parquet no Azure Blob Storage. |
SqlPackage CLI |
| Platform | SqlPackage atualizado para a versão do .NET Framework para o .NET Framework 4.7.2. | Plataforma; SqlPackage CLI |
| Platform | Removido o suporte para .NET 6. | Plataforma; SqlPackage CLI |
| ScriptDom | ScriptDom atualizado para a versão 170.18.0. | Platform |
| Projetos SQL | O nível de compatibilidade predefinido para Azure SQL Database e SQL Database no Microsoft Fabric está agora definido em 170. Para obter mais informações, consulte Nível de compatibilidade de banco de dados 170 no Banco de Dados SQL do Azure e Banco de dados SQL no Microsoft Fabric. | Projetos MSBuild / SQL |
| Vector | O tipo de dados vetoriais agora é suportado na plataforma Azure SQL Database de destino para importação, exportação, extração, implantação e compilação de projeto SQL. |
SqlPackage CLI; MSBuild / projetos SQL; API DacFx / Comparação de esquemas |
Fixes
| Feature | Details | Aplica-se a |
|---|---|---|
| Deployment | Corrigido um problema em que a implementação de uma alteração numa tabela externa faz com que todas as tabelas externas sejam eliminadas e recriadas se a tabela modificada não contiver valores para REJECT_VALUE ou REJECT_SAMPLE_VALUE. |
SqlPackage CLI; API DacFx / Comparação de esquemas |
| Deployment | Foi corrigido um problema em que alterar uma coluna para expandir o seu comprimento resulta num aviso incorreto de perda de dados se a colação da coluna for especificada e corresponder à colação padrão da base de dados. Problema do GitHub | SqlPackage CLI; API DacFx / Comparação de esquemas |
| Deployment | Corrigido um problema em que alterações na classificação de sensibilidade numa tabela fazem com que os índices sejam recriados. Problema do GitHub | SqlPackage CLI; API DacFx / Comparação de esquemas |
| Export | Otimizou a utilização da estimativa do tamanho da tabela durante operações de exportação. | SqlPackage CLI |
| Extract | Corrigido um problema em que ao extrair um .dacpac com referência a uma base de dados, ocorre falha.
Problema do GitHub |
SqlPackage CLI; API DacFx / Comparação de esquemas |
| Armazém de dados de tecido | Corrigido um problema em que o sp_refreshsqlmodule procedimento armazenado do sistema é chamado durante uma operação de publicação. O Fabric Data Warehouse não suporta sp_refreshsqlmodule e isso faz com que a implementação falhe. |
SqlPackage CLI |
| Armazém de dados de tecido | Foi resolvido um problema em que as restrições das tabelas são incluídas em ficheiros .dacpac mas não .sql quando uma base de dados foi extraída de um Fabric Data Warehouse.
Problema do GitHub |
SqlPackage CLI |
| Projetos SQL | Corrigido um problema em que compilar sem SSDT instalado no Visual Studio resulta em comportamentos incorretos. Problema do GitHub | Projetos MSBuild / SQL |
| Projetos SQL | Corrigido um problema em que os avisos de compilação são duplicados na saída quando a análise de código está ativada. Problema do GitHub | Projetos MSBuild / SQL |
| Projetos SQL | Corrigido um problema em que os parâmetros do service broker definidos para variáveis resultam em avisos falsos. Problema do GitHub | Projetos MSBuild / SQL |
Versões arquivadas (162.x e versões anteriores)
Pode encontrar as notas de lançamento da versão 162.x e versões anteriores nas notas de lançamento do SqlPackage (arquivo).