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

  • Artigo

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. O recurso 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 a CLI 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 é baseado nos novos projetos no estilo SDK (Microsoft.Build.Sql) e é o formato usado pela extensão de Projetos do Banco de Dados SQL para Azure Data Studio e VS 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 arquivos .sql no projeto

O novo trabalho de desenvolvimento deve considerar o uso do formato de projeto no estilo SDK, pois é o formato que terá suporte no futuro. Os projetos no estilo SDK têm um superconjunto de funcionalidades de projetos SQL originais e os projetos SQL existentes podem ser convertidos em projetos no estilo SDK por meio da modificação do arquivo de projeto. A exceção à cobertura de funcionalidade é o suporte para objetos SQLCLR, que exigem .NET Framework e não têm suporte em projetos no estilo SDK.

Mais documentação sobre os projetos SQL está disponível no tópico Projetos de banco de dados SQL. O SDK do Microsoft.Build.Sql está disponível no GitHub e no NuGet.org.

Instalar

Aviso

O recurso de projetos SQL no estilo SDK está em versão prévia e não há suporte para a instalação lado a lado com os projetos SQL originais. É recomendável instalar os projetos SQL no estilo SDK em uma instância autônoma do Visual Studio.

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

  1. Baixe e instale a versão prévia do Visual Studio 2022 (17.12 versão prévia 2 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. Continue a instalação sem selecionar cargas de trabalho ou recursos extras.

Captura de tela da guia aberta, Componentes individuais do Instalador do Visual Studio.

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 pode ocorrer se os projetos SQL no estilo SDK forem instalados lado a lado com os projetos SQL originais e a instalação do SQL Server Data Tools no estilo SDK for recomendada 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
  • 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 de instruções Converter projeto SQL original.

Conteúdo relacionado