Compartilhar via

Extensão de Projetos de Banco de Dados SQL

Importante

O Azure Data Studio será desativado em 28 de fevereiro de 2026. Recomendamos que você use o Visual Studio Code . Para obter mais informações sobre como migrar para o Visual Studio Code, visite O que está acontecendo com o Azure Data Studio?

A extensão Projetos do Banco de Dados SQL é uma extensão do Visual Studio Code para desenvolver bancos de dados SQL em um ambiente de desenvolvimento baseado em projeto. Os bancos de dados compatíveis incluem SQL Server, Banco de Dados SQL do Azure, Instância Gerenciada de SQL do Azure, Warehouse in Fabric e Banco de Dados SQL no Fabric. Um projeto SQL é uma representação local de objetos SQL que compõem o esquema de um único banco de dados, como tabelas, procedimentos armazenados ou funções. Quando um projeto do Banco de Dados SQL é criado, o artefato de saída é um .dacpac arquivo. Bancos de dados novos e existentes podem ser atualizados para corresponder ao conteúdo do .dacpac publicando o projeto SQL Database com a extensão Projetos do SQL Database ou publicando o .dacpac com a interface de linha de comando SqlPackage.

Captura de tela do resumo dos projetos do banco de dados SQL que contêm scripts de pré-implantação e pós-implantação, bem como objetos de banco de dados.

Para obter mais informações sobre os conceitos de projetos SQL, consulte o que são projetos do banco de dados SQL?

Recursos de extensão

A extensão Projetos do Banco de Dados SQL fornece os seguintes recursos:

  • Crie um novo projeto Microsoft.Build.Sql em branco.
  • Crie um novo projeto a partir de um banco de dados conectado.
  • Abra um projeto criado anteriormente no Visual Studio Code ou no SQL Server Data Tools.
  • Edite um projeto adicionando ou removendo objetos (tabelas, exibições, procedimentos armazenados) ou scripts personalizados no projeto.
  • Organizar arquivos/scripts em pastas.
  • Adicione referências a bancos de dados do sistema ou a um "dacpac" de usuário.
  • Crie um único projeto.
  • Implantar um único projeto.
  • Carregue os detalhes da conexão (autenticação do SQL Windows) e as variáveis SQLCMD do perfil de implantação.

Install

Você pode instalar a extensão projeto do Banco de Dados SQL no Visual Studio Code.

A extensão Projetos do Banco de Dados SQL é instalada com a extensão mssql para Visual Studio Code.

Dependências

A extensão Projetos do Banco de Dados SQL tem uma dependência do SDK do .NET (obrigatório) e do AutoRest.Sql (opcional).

SDK do .NET

O SDK do .NET é necessário para a funcionalidade de build do projeto e você será solicitado a instalar o SDK do .NET se uma versão com suporte não puder ser detectada pela extensão. O SDK do .NET pode ser baixado e instalado para Windows, macOS e Linux.

Se você quiser verificar as versões instaladas no momento do SDK do dotnet, abra um terminal e execute o seguinte comando:

dotnet --list-sdks

Depois de instalar o SDK do .NET, seu ambiente estará pronto para usar a extensão projetos do Banco de Dados SQL.

Problemas comuns

Nuget.org ausentes na lista de fontes podem resultar em mensagens de erro como:

  • error MSB4236: The SDK 'Microsoft.Build.Sql/0.1.9-preview' specified could not be found.
  • Unable to find package Microsoft.Build.Sql. No packages exist with this id in source(s): Microsoft Visual Studio Offline Packages

Para verificar se nuget.org está registrado como uma origem, execute dotnet nuget list source na linha de comando e examine os resultados de um [Enabled] item referenciando nuget.org. Se nuget.org não estiver registrado como uma origem, execute dotnet nuget add source https://api.nuget.org/v3/index.json -n nuget.org.

Versões sem suporte do SDK do .NET podem resultar em mensagens de erro como:

  • error MSB4018: The "SqlBuildTask" task failed unexpectedly.
  • error MSB4018: System.TypeInitializationException: The type initializer for 'SqlSchemaModelStaticState' threw an exception. ---> System.IO.FileNotFoundException: Could not load file or assembly 'System.Runtime, Version=4.2.2.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a'. The system cannot find the file specified. [c:\Users\ .sqlproj]_ (em que o arquivo inexistente vinculado tem um colchete de fechamento incompatível).

Para forçar a extensão projetos do Banco de Dados SQL a usar a versão v6.x do SDK do .NET quando várias versões forem instaladas, adicione um arquivo global.json à pasta que contém o projeto SQL.

Mais informações sobre como solucionar problemas de build de projetos SQL podem ser encontradas na solução de problemas de build de projeto do SQL.

SQLCLR

Não há suporte para objetos SQLCLR em projetos de banco de dados no Visual Studio Code porque eles dependem do .NET Framework e a extensão Projetos do Banco de Dados SQL usa o .NET para criar projetos.

Workspace

Os projetos do banco de dados SQL estão contidos em um workspace lógico (pasta) no Visual Studio Code. Todos os projetos SQL dentro das pastas abertas no workspace atual estão disponíveis na exibição Projetos do Banco de Dados SQL por padrão.

Você pode adicionar e remover projetos manualmente de um workspace por meio da interface no painel Projetos . As configurações de um workspace podem ser editadas manualmente no .code-workspace arquivo, se necessário.

No arquivo de exemplo .code-workspace a seguir, a folders matriz lista todas as pastas incluídas no painel Do Explorer e a dataworkspace.excludedProjects matriz dentro settings lista todos os projetos SQL excluídos do painel Projetos .

{
  "folders": [
    {
      "path": "."
    },
    {
      "name": "WideWorldImportersDW",
      "path": "..\\WideWorldImportersDW"
    }
  ],
  "settings": {
    "dataworkspace.excludedProjects": [
      "AdventureWorksLT.sqlproj"
    ]
  }
}

Conteúdo relacionado

  • Last updated on