Partilhar via

Extensão de projetos do Banco de Dados SQL

Importante

O Azure Data Studio será desativado em 28 de fevereiro de 2026. Recomendamos que você use 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. Bases de dados compatíveis incluem SQL Server, Azure SQL Database, Azure SQL Managed Instance, Warehouse no Fabric e base de dados SQL no Fabric. Um projeto SQL é uma representação local de objetos SQL que compõem o esquema para 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 do 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 de Resumo de projetos de banco de dados SQL contendo scripts de pré e pós-implantação, bem como objetos de banco de dados.

Para obter mais informações sobre conceitos de projetos SQL, consulte O que são projetos de 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.
  • Organize arquivos/scripts em pastas.
  • Adicione referências a bases de dados do sistema ou a um dacpac de utilizador.
  • Crie um único projeto.
  • Implante um único projeto.
  • Carregue detalhes de conexão (autenticação SQL Windows) e variáveis SQLCMD do perfil de implantação.

Install

Você pode instalar a extensão de 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 depende do SDK do .NET (obrigatório) e do AutoRest.Sql (opcional).

SDK para .NET

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

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

dotnet --list-sdks

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

Problemas comuns

Nuget.org ausentes da lista de fontes podem resultar em mensagens de erro, tais 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 fonte, execute dotnet nuget list source a partir da linha de comando e revise os resultados de um [Enabled] item referenciando nuget.org. Se nuget.org não estiver registrado como fonte, execute dotnet nuget add source https://api.nuget.org/v3/index.json -n nuget.org.

Versões não suportadas 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]_ (onde o ficheiro inexistente vinculado tem um colchete de fechamento não correspondente).

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 deglobal.json à pasta que contém o projeto SQL.

Mais informações sobre como solucionar problemas de compilação de projetos SQL podem ser encontradas em Solucionar problemas de compilação de projetos 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 SQL Database Projects usa o .NET para criar projetos.

Espaço de trabalho

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

Você pode adicionar e remover projetos manualmente de um espaço de trabalho por meio da interface no painel Projetos . As configurações de um espaço de trabalho 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 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