Contêiner local do SQL Server

O recurso de contêiner local do SQL Server na extensão MSSQL para Visual Studio Code simplifica o desenvolvimento local, permitindo que os desenvolvedores criem contêineres do SQL Server totalmente configurados sem escrever um único comando do Docker. Você pode implantar e gerenciar contêineres diretamente do modo de exibição Conexões. Essa nova funcionalidade é perfeita para protótipos, desenvolvimento ou teste de cargas de trabalho usando o mesmo mecanismo de banco de dados disponível em ambientes de produção.

Por padrão, o assistente de contêiner usa o SQL Server 2025 (17.x), que inclui recursos prontos para IA, como tipos de dados de vetor e funções JSON. Você também pode escolher entre o SQL Server 2022 (16.x), o SQL Server 2019 (15.x) ou o SQL Server 2017 (14.x), dependendo das suas necessidades de teste.

Características

O contêiner local do SQL Server na extensão MSSQL fornece os seguintes recursos:

• Crie um contêiner do SQL Server local sem gravar comandos do Docker.
• Escolha entre várias versões do SQL Server (SQL Server 2025 (17.x) (padrão), SQL Server 2022 (16.x), SQL Server 2019 (15.x) e SQL Server 2017 (14.x)).
• Personalize o nome do contêiner, o nome do host e a porta.
• Verifique automaticamente a instalação do Docker e o status de execução antes da implantação.
• Atribua automaticamente uma porta disponível se 1433 já estiver em uso.
• Interconecte automaticamente e persista as configurações de conexão entre reinicializações de contêiner.
• Gerencie o ciclo de vida do contêiner (iniciar, parar, excluir) no menu de contexto no modo de exibição Conexões.
• Use com todos os principais recursos de extensão do MSSQL, incluindo Pesquisador de Objetos, Designer de Tabela, Designer de Esquema, Editor de Consultas e GitHub Copilot.

Criar um contêiner local

Para criar um contêiner local do SQL Server:

1. Na visão Conexões, selecione a opção Criar Contêiner SQL local no menu.

   

2. Examine a tela Visão geral, que realça o que você pode esperar da experiência de contêiner local do SQL Server.

   Quando estiver pronto, selecione Introdução para continuar.

   

3. A extensão MSSQL verifica automaticamente o Docker antes da implantação:

   • Se o Docker não estiver instalado, uma mensagem com um link de instalação será exibida. Você deve instalá-lo antes de continuar.
   • Se o Docker estiver instalado, mas não estiver em execução, você será solicitado a iniciá-lo. Se o Docker inicial falhar, tente novamente ou cancele.

   Depois que todos os pré-requisitos forem atendidos, selecione Avançar para continuar com a implantação.

   

4. No painel de configurações de implantação :

   1. Selecione a versão do SQL Server (o SQL Server 2025 (17.x) está selecionado por padrão).
   2. Insira uma senha para a sa conta.
   3. Insira um nome para o perfil de conexão (opcional).
   4. Opcionalmente, conclua as opções avançadas:
      • Nome do contêiner
      • Porto
      • Nome do host
   5. Aceite os termos de licença.
   6. Selecione Criar Contêiner.

   

Como funciona a implantação de contêiner do SQL

Depois de selecionar Criar Contêiner, a extensão manipula tudo para você:

• Efetua pull da imagem do SQL Server selecionada (se ainda não estiver armazenada em cache)
• Cria um contêiner do SQL Server com as configurações escolhidas
• Monitora os logs para verificar se todos os bancos de dados estão totalmente recuperados e prontos
• Cria um perfil de conexão e se conecta ao seu contêiner

Após a conclusão da implantação, o contêiner é iniciado e a extensão MSSQL se conecta automaticamente ao novo banco de dados.

Gerenciar seu contêiner

Para gerenciar o contêiner, clique com o botão direito do mouse no nome do perfil de conexão na exibição Conexões . No menu de contexto, você pode:

Iniciar um contêiner parado

A extensão verifica se o Docker está em execução antes de iniciar o contêiner. Se o Docker não estiver em execução, você será solicitado a iniciá-lo.

Parar a execução de um contêiner

Essa opção desliga o contêiner preservando o estado do banco de dados. Você pode reiniciá-lo a qualquer momento no mesmo menu.

Excluir o contêiner

Essa opção remove permanentemente o contêiner e seus dados. Você será solicitado a confirmar antes de prosseguir.

Experiência de reconexão automática

Se o contêiner ou o Docker não estiver em execução quando você se reconectar, a extensão solicitará que você os inicie. Não é necessário solucionar problemas manualmente.

Cenários com suporte

Você pode usar o contêiner local do SQL Server com todos os principais recursos da extensão MSSQL:

• Editor de Consultas e IntelliSense
• Designer de Tabela e Designer de Esquema
• GitHub Copilot
• Gerenciamento de conexões e Pesquisador de Objetos

Esse recurso torna o contêiner local do SQL Server ideal para:

• Prototipagem de novos recursos
• Testar alterações de esquema
• Executando testes automatizados em ambientes isolados
• Experimentar recursos do SQL Server 2025 (17.x)

Limitações

• Requer que o Docker Desktop (ou equivalente) esteja instalado e em execução.
• Há suporte apenas para contêineres do SQL Server baseados em Linux (SQL Server 2017 (14.x) e versões posteriores).
• Não há suporte para o Podman.
• Não há suporte para backup/restauração, clustering, inicialização de script e Docker Compose por meio do assistente interno, mas você pode executar essas tarefas manualmente usando comandos ou ferramentas externas.
• Projetado estritamente para desenvolvimento local, não para uso em produção.
• Problemas com a instalação, configuração ou runtime do Docker devem ser resolvidos pelo usuário.
• Verifique se o computador tem recursos suficientes ou ajuste a alocação de memória do Docker e os limites de recursos do contêiner por meio das configurações do Docker para garantir o desempenho estável.
• Requisitos de memória:
  • O SQL Server precisa de pelo menos 2 GB de memória para iniciar um contêiner baseado em Linux.
  • Por padrão, o SQL Server no Linux usa aproximadamente 80% da memória disponível para o contêiner.

Conteúdo relacionado

• Início Rápido: conectar e consultar um banco de dados com a extensão MSSQL para Visual Studio Code
• Extensão do GitHub Copilot para MSSQL para Visual Studio Code
• Designer de Esquema
• Comparação de esquema
• Saiba mais sobre o Visual Studio Code
• Repositório GitHub da extensão MSSQL