Partilhar via

Notas de versão do SqlPackage

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.Sql SDK, integração com SQL Server Data Tools (SSDT))
  • API DacFx / Comparação de esquemas - Microsoft.SqlServer.DacFx APIs 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).

  • Last updated on