SQL Server Data Tools, estilo SDK (versão prévia)

O SQL Server Data Tools (SSDT) é um conjunto de ferramentas de desenvolvimento no Visual Studio com foco na criação de bancos de dados SQL Server e bancos de dados SQL do Azure. Os projetos SQL no estilo SDK no Visual Studio habilitam a próxima geração de projetos SQL como parte do recurso SQL Server Data Tools, estilo SDK (versão prévia) disponível para Visual Studio 2022. A funcionalidade de projetos SQL se estende a pipelines de CI/CD, permitindo que você automatize a compilação e a implantação de seus projetos de banco de dados com o SqlPackage.

Visão geral

O formato original do projeto SQL é baseado no MSBuild (.NET Framework) e é o formato usado pelo SQL Server Data Tools no Visual Studio. O formato de projeto no estilo SDK baseia-se nos novos projetos no estilo SDK (Microsoft.Build.Sql) e é o formato usado pela extensão projetos do Banco de Dados SQL para Visual Studio Code. O SDK do projeto Microsoft.Build.Sql é mais flexível do que os projetos SQL originais e contém novos recursos:

• Suporte ao .NET 8 (multiplataforma)
• Referências de pacote NuGet para referências de banco de dados
• Padrão de globbing padrão para .sql arquivos no projeto

O Visual Studio 2026 não dá suporte a projetos SQL no estilo SDK e os projetos SQL originais são o único formato de projeto SQL disponível nessa versão do Visual Studio. O Visual Studio 2022 é a única versão do Visual Studio que contém projetos SQL no estilo SDK no componente SQL Server Data Tools, estilo SDK (versão prévia ).

Para obter mais informações sobre projetos SQL, consulte o que são projetos de banco de dados SQL?. O SDK do Microsoft.Build.Sql está disponível no GitHub e no NuGet.org.

Instalar

Para instalar os projetos SQL no estilo SDK no Visual Studio 2022, siga estas etapas:

1. Baixe e instale o Visual Studio 2022 (17.12 ou posterior) na página de download do Visual Studio.

2. Durante a instalação, selecione a guia Componentes individuais e procure por "SQL" para localizar e selecionar "SQL Server Data Tools SDK-style (Versão prévia)". A seleção desse item seleciona automaticamente as dependências necessárias.

3. Pesquise "SDK do .NET" na guia Componentes individuais e selecione o componente "SDK do .NET". Selecionar este item automaticamente seleciona as dependências necessárias, incluindo os runtimes compatíveis do .NET. O componente do SDK do .NET permite suporte para versões adicionais do SDK do Microsoft.Build.Sql no Visual Studio, que estão disponíveis por meio de NuGet.org.

   

4. Continue a instalação sem selecionar cargas de trabalho ou recursos extras.

A documentação do Visual Studio fornece informações adicionais sobre como modificar instalações do Visual Studio para selecionar componentes individuais.

Um comportamento inesperado poderá ocorrer se os projetos SQL no estilo SDK forem instalados lado a lado com os projetos originais do SQL e a instalação das Ferramentas de Dados do SQL Server no estilo SDK for aconselhada como um componente autônomo. Para verificar quais componentes fazem parte de uma instalação do Visual Studio, use o menu Ajuda no Visual Studio e selecione Sobre o Microsoft Visual Studio. Algumas abordagens estão disponíveis para utilizar várias instâncias do Visual Studio em um único computador:

• Instale diferentes canais de lançamento do Visual Studio, como o Visual Studio 2022 e a versão prévia do Visual Studio 2022.

• Instale diferentes edições do Visual Studio, como Visual Studio Community e Visual Studio Enterprise.

• Instale em um diretório específico para separar uma instância do Visual Studio de uma versão instalada anteriormente.

Limitações

Uma comparação completa da funcionalidade entre as ferramentas de projetos SQL está disponível em Ferramentas de projetos SQL. O recurso de projetos SQL no estilo SDK no Visual Studio apresenta as seguintes limitações:

• Não há suporte para a instalação lado a lado com projetos SQL originais

• O arquivo de projeto SQL usa a extensão .sqlprojx em vez de .sqlproj no Visual Studio 17.12 versão prévia 2. No Visual Studio 17.12 versão prévia 3 e posterior, a extensão é .sqlproj.

• Não há suporte para objetos SQLCLR

• A interface de comparação de esquemas não está habilitada

• A interface do designer de tabela não está habilitada

• A interface de comparação de dados não está habilitada

• O teste de unidade de banco de dados não está habilitado

O suporte para projetos SQL no estilo SDK no Visual Studio está em versão prévia e a instalação com base na versão prévia mais recente do Visual Studio 2022 é recomendada. O recurso de projetos SQL no Visual Studio está em desenvolvimento ativo e os comentários são bem-vindos por meio da Developer Community.

Converter projetos existentes

Os projetos SQL no estilo SDK do Microsoft.Build.Sql podem ser criados do zero ou convertidos de projetos SQL existentes. A conversão de um projeto SQL original em um projeto Microsoft.Build.Sql pode ser feita no local, mas é recomendável criar um backup do projeto antes da conversão. Para converter um projeto SQL existente em um projeto no estilo SDK, siga as etapas no guia como converter um projeto SQL original em um guia de instruções de projeto no estilo SDK .

Conteúdo relacionado

• O que são projetos do banco de dados SQL?
• Notas sobre a versão prévia do Visual Studio 2022
• Projetos SQL no Visual Studio Code