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 girem contêineres do SQL Server totalmente configurados sem escrever um único comando do Docker. Você pode implantar e gerenciar contêineres diretamente da visualização Conexões. Esse novo recurso é perfeito para prototipar, desenvolver ou testar cargas de trabalho usando o mesmo mecanismo de banco de dados disponível em ambientes de produção.

Por defeito, o assistente de contentores utiliza o SQL Server 2025 (17.x), que inclui capacidades preparadas para IA, como tipos de dados vetoriais e funções JSON. Você também pode escolher entre SQL Server 2022 (16.x), SQL Server 2019 (15.x) ou SQL Server 2017 (14.x), dependendo de suas necessidades de teste.

Caraterísticas

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

• Crie um contêiner local do SQL Server sem escrever comandos do Docker.
• Escolha entre várias versões do SQL Server (SQL Server 2025 (17.x) (predefinido), 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 o status de instalação e execução do Docker antes da implantação.
• Atribua automaticamente uma porta disponível se a 1433 já estiver em uso.
• Conecte automaticamente e persista as configurações de conexão nas reinicializações do contêiner.
• Gerencie o ciclo de vida do contêiner (iniciar, parar, excluir) no menu de contexto na visualização Conexões.
• Use com todos os principais recursos de extensão MSSQL, incluindo Pesquisador de Objetos, Designer de Tabela, Designer de Esquema, Editor de Consultas e Copiloto do GitHub.

Criar um contêiner local

Para criar um contêiner local do SQL Server:

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

   

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

   Quando estiver pronto, selecione Começar para continuar.

   

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

   • Se o Docker não estiver instalado, será exibida uma mensagem com um link de instalação. Você deve instalá-lo antes de continuar.
   • Se o Docker estiver instalado, mas não em execução, você será solicitado a iniciá-lo. Se a inicialização do Docker 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 Configurações de implantação :

   1. Selecione a versão do SQL Server (SQL Server 2025 (17.x) está selecionada por defeito).
   2. Introduza uma palavra-passe para a sa conta.
   3. Introduza um nome para o seu perfil de ligação (opcional).
   4. Opcionalmente, preencha as opções avançadas:
      • Nome do contêiner
      • Porto
      • Hostname (Nome do anfitrião)
   5. Aceite os termos da licença.
   6. Selecione Criar contêiner.

   

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

Depois de selecionar Criar contêiner, a extensão lida com tudo para você:

• Extrai a imagem selecionada do SQL Server (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.

Gerencie seu contêiner

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

Iniciar um contentor 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 um contentor em funcionamento

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

Excluir o contêiner

Esta opção remove permanentemente o contêiner e seus dados. É-lhe pedido que confirme antes de prosseguir.

Experiência de reconexão automática

Se o contêiner ou o Docker não estiverem em execução quando você se reconectar, a extensão solicitará que você os inicie. Não há necessidade de solucionar problemas manualmente.

Cenários suportados

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

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

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

• Prototipagem de novos recursos
• Testando alterações de esquema
• Execução de testes automatizados em ambientes isolados
• Experimentar com funcionalidades do SQL Server 2025 (17.x)

Limitações

• Requer que o Docker Desktop (ou equivalente) esteja instalado e em execução.
• Somente contêineres do SQL Server baseados em Linux são suportados (SQL Server 2017 (14.x) e versões posteriores).
• Sem suporte para Podman.
• Backup/restauração, clustering, inicialização de script e Docker Compose não são suportados por meio do assistente interno, mas você pode executar essas tarefas manualmente usando ferramentas ou comandos externos.
• Projetado estritamente para o desenvolvimento local, não para uso em produção.
• Problemas com a instalação, configuração ou tempo de execução 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 um 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

• Guia de início rápido: conectar-se e consultar um banco de dados com a extensão MSSQL para Visual Studio Code
• Extensão GitHub Copilot for MSSQL para Visual Studio Code
• Designer de esquema
• Comparação de esquema
• Saiba mais sobre o Visual Studio Code
• Extensão MSSQL repositório GitHub