Compartilhar via


Introdução à extensão 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?

Este artigo descreve três maneiras de começar a usar a extensão projetos do Banco de Dados SQL:

  1. Crie um novo projeto de banco de dados acessando a exibição Projetos de Banco de Dados ou pesquisando projetos de banco de dados: Novo na paleta de comandos.

  2. Projetos de banco de dados existentes podem ser abertos por meio de Projetos de Banco de Dados: Abrir existente na paleta de comandos.

  3. Comece a partir de um banco de dados existente usando Projetos de Banco de Dados: Crie o Project a partir do Banco de Dados na paleta de comandos ou selecionando Criar Projeto do Banco de Dados no modo de exibição Conexões .

    Captura de tela do novo modo de exibição.

Depois de criar ou abrir um projeto SQL, você estará pronto para começar a desenvolver com projetos SQL. Algumas ações que você pode executar são:

  • editar uma tabela ou outros objetos de banco de dados
  • compilando e publicando o projeto
  • usando a comparação de esquema para visualizar alterações
  • atualizando o projeto a partir das alterações feitas em um banco de dados

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

Criar um projeto de banco de dados vazio

Na exibição Projetos de Banco de Dados , selecione o botão Novo Projeto e insira um nome de projeto na entrada de texto exibida. Na caixa de diálogo "Selecionar uma Pasta" exibida, selecione um diretório onde a pasta do projeto, o arquivo .sqlproj e outros conteúdos residirão. O projeto vazio é aberto e visível no modo de exibição Projetos de Banco de Dados para edição.

Abrir um projeto existente

No modo de exibição Projetos de Banco de Dados , selecione o botão Abrir Projeto e abra um arquivo existente .sqlproj no seletor de arquivos exibido. Os projetos existentes podem ser originados do Azure Data Studio, do Visual Studio Code ou do Visual Studio SQL Server Data Tools.

O projeto existente é aberto e seu conteúdo fica visível no modo de exibição Projetos de Banco de Dados para edição.

Criar um projeto de banco de dados a partir de um banco de dados existente

Em vez de começar de um projeto vazio, você pode preencher rapidamente um Projeto de Banco de Dados SQL com os objetos existentes de um banco de dados.

No Pesquisador de Objetos

No modo de exibição Conexões , conecte-se à instância do SQL que contém o banco de dados a ser extraído. Clique com o botão direito do mouse no banco de dados e selecione Criar Projeto no Banco de Dados no menu de contexto.

Captura de tela da caixa de diálogo Criar Projeto do Banco de Dados.

A configuração da estrutura de pastas é definida como Tipo de Objeto/Esquema por padrão e oferece diferentes maneiras de organizar automaticamente os objetos existentes quando eles são descartados por script. As opções para a configuração da estrutura de pastas são:

  • Arquivo: um único arquivo é criado para todos os objetos
  • Simples: uma única pasta é criada para todos os objetos em arquivos individuais
  • Tipo de objeto: uma pasta é criada por tipo de objeto e cada objeto é roteado para um arquivo
  • Esquema: uma pasta é criada para cada esquema e cada objeto é escrito em script para um arquivo
  • Tipo de esquema/objeto: uma pasta é criada por esquema e dentro da pasta uma pasta é criada por tipo de objeto e cada objeto é roteado para um arquivo

No modo de exibição Projetos de Banco de Dados

Na visualização Projeto, selecione o botão Importar Projeto do Banco de Dados e conecte-se a uma instância SQL. Depois que a conexão for estabelecida, selecione um banco de dados na lista de bancos de dados disponíveis e defina o nome do projeto.

Por fim, selecione uma estrutura de pastas da extração. O novo projeto é aberto e contém scripts SQL para o conteúdo do banco de dados selecionado.

Outras ações

Compilar e publicar

A implantação do projeto de banco de dados é realizada na extensão Projetos do Banco de Dados SQL compilando o projeto como um arquivo de aplicativo de camada de dados (dacpac) e publicando em uma plataforma com suporte. No modo de exibição Projetos de Banco de Dados , clique com o botão direito do mouse em um projeto e selecione Compilar para criar um arquivo dacpac e validar o projeto SQL. Quando estiver pronto para implantar seu projeto em um banco de dados, clique com o botão direito do mouse no projeto novamente e selecione Publicar para publicar o dacpac em um banco de dados.

Para obter mais informações sobre esse processo, consulte o tutorial sobre como criar e implantar um projeto SQL.

Comparação de esquema

A extensão Projetos do Banco de Dados SQL interage com a Comparação de Esquemas, permitindo que você compare o conteúdo de um projeto com um dacpac, banco de dados existente ou outro projeto. A comparação de esquema resultante pode ser usada para exibir e aplicar as diferenças de origem para destino.

Captura de tela da caixa de diálogo comparação de esquema comparando um projeto SQL com um banco de dados.

Saiba mais sobre a comparação de esquemas e projetos SQL no artigo Comparação de Esquema para projetos SQL .

Atualizar projeto do banco de dados

Se forem feitas alterações em um banco de dados que ainda não foram feitas no projeto SQL, o projeto SQL poderá ser atualizado do estado de um banco de dados. Essa atualização é feita selecionando Atualizar Projeto do Banco de Dados no menu de contexto de um banco de dados no modo de exibição Conexões ou no menu de contexto de um projeto SQL na exibição Projetos de Banco de Dados . Manter um projeto SQL atualizado com alterações em um banco de dados é um método de controle do código-fonte para alterações de banco de dados.

Captura de tela da caixa de diálogo Atualizar Projeto do Banco de Dados.