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. Ao criar um projeto do Banco de Dados SQL, você cria um .dacpac arquivo. Você pode atualizar bancos de dados novos e existentes para corresponder ao conteúdo do .dacpac publicando o projeto do Banco de Dados SQL com a extensão de Projetos de Banco de Dados SQL 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 e 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 depende do SDK do .NET (obrigatório) e do AutoRest.Sql (opcional).

SDK do .NET

A extensão requer o SDK do .NET para a funcionalidade de build do projeto. Se a extensão não puder detectar uma versão com suporte, ela solicitará que você instale o SDK do .NET. Você pode baixar e instalar o SDK do .NET para Windows, macOS e Linux.

Para 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

  • A falta de nuget.org na lista de fontes pode 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).

    Você pode 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 são instaladas. Para fazer isso, adicione um arquivo global.json à pasta que contém o projeto SQL.

Para obter mais informações sobre como solucionar problemas de build de projetos SQL, consulte Solucionar problemas de build de projeto do SQL.

SQLCLR

O Visual Studio Code não dá suporte a objetos SQLCLR em projetos de banco de dados, pois esses objetos 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. Por padrão, você pode acessar todos os projetos SQL dentro das pastas abertas no workspace atual na exibição Projetos do Banco de Dados SQL .

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