Partilhar via

Ferramentas de dados do SQL Server, estilo SDK (visualização)

SSDT (SQL Server Data Tools) é um conjunto de ferramentas de desenvolvimento no Visual Studio focado na criação de bancos de dados SQL Server e Azure SQL. 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 (visualização) disponível para o Visual Studio 2022. A funcionalidade de projetos SQL estende-se a pipelines de CI/CD, permitindo que você automatize a compilação e a implantação dos seus projetos de banco de dados com o SqlPackage.

Visão geral

O formato de projeto SQL original é 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 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 a .NET 8 (multiplataforma)
  • Referências de pacote do 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 suporta projetos SQL ao 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 com estilo SDK no componente SQL Server Data Tools, estilo SDK (prévia).

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

Instalar

Advertência

O recurso de projetos SQL no estilo SDK está em visualização e a instalação lado a lado com os projetos SQL originais não é suportada. É aconselhá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 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 (Preview)". A seleção deste item seleciona automaticamente as dependências necessárias.

  3. Procure por ".NET SDK" na guia Componentes individuais e selecione o componente ".NET SDK". A seleção deste item seleciona automaticamente as dependências necessárias, incluindo tempos de execução .NET suportados. O componente SDK do .NET habilita o suporte para versões adicionais do SDK Microsoft.Build.Sql no Visual Studio, que estão disponíveis por meio do NuGet.org.

    Captura de tela do instalador do Visual Studio com a guia de componentes individuais aberta.

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

A documentação do Visual Studio fornece informações adicionais sobre a modificação de 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 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. Várias abordagens estão disponíveis para utilizar várias instâncias do Visual Studio em uma única máquina:

  • Instale diferentes canais de lançamento do Visual Studio, como Visual Studio 2022 e Visual Studio 2022 preview.

  • Instale edições diferentes 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 tem as seguintes limitações:

  • Não há suporte para 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 preview 2. No Visual Studio 17.12 preview 3 e posterior, a extensão é .sqlproj.

  • Não há suporte para objetos SQLCLR

  • A interface de comparação de esquema não está ativada

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

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

  • 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 visualização e a instalação a partir da versão de visualização mais recente do Visual Studio 2022 é recomendada. O recurso de projetos SQL no Visual Studio está em desenvolvimento ativo e comentários são bem-vindos por meio do Developer Community.

Converter projetos existentes

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

Conteúdo relacionado

  • Last updated on