Partilhar via

Contêiner local do SQL Server

Com a funcionalidade de container local SQL Server na extensão MSSQL para Visual Studio Code, pode criar e gerir containers SQL Server sem executar manualmente comandos Docker. Os contentores podem ser implementados, iniciados, parados e removidos diretamente da vista de Conexões , proporcionando uma forma direta de prototipar, desenvolver e testar cargas de trabalho usando o mesmo motor de base de dados disponível em ambientes de produção.

Captura de tela mostrando a animação do assistente de Contêiner Local parte um.

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.

Captura de tela mostrando a animação do assistente de Contêiner Local parte dois.

Observação

A experiência de contêiner local do SQL Server funciona no macOS, Windows e Linux, desde que o Docker Desktop (ou equivalente) esteja em execução no modo de contêiner Linux.

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.

Importante

Os contêineres locais destinam-se apenas ao desenvolvimento. Não há suporte para implantações de produção.

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.

    Captura de tela mostrando como criar a opção de contêiner local do SQL Server na extensão MSSQL.

  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.

    Captura de tela da tela de visão geral da implantação de contêiner local do SQL Server com links úteis e botão Introdução.

  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.

    Captura de ecrã da verificação de pré-requisitos da extensão MSSQL do Docker.

  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.

    Captura de tela do formulário de configuração de configuração do 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ê:

  • Puxa a imagem selecionada do SQL Server (se ainda não estiver em cache).
  • Cria um contentor SQL Server com as definições escolhidas.
  • Monitoriza os registos para verificar se todas as bases de dados estão totalmente recuperadas e prontas.
  • Cria um perfil de ligação e liga-se ao seu contentor.

Quando a implementação termina, o contentor inicia-se e a extensão MSSQL liga-se automaticamente à nova base 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.

Captura de tela mostrando como gerenciar o ciclo de vida do contêiner na extensão MSSQL.

Importante

A exclusão de um contêiner também remove seu perfil de conexão associado.

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 precisas de resolver o problema manualmente.

Cenários suportados

Pode usar um contentor SQL Server local com todas as funcionalidades 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

Esta funcionalidade torna um contentor SQL Server local 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.
  • Só suporta contentores SQL Server baseados em Linux (SQL Server 2017 (14.x) e versões posteriores).
  • Sem suporte para Podman.
  • O assistente incorporado não suporta backup e restauro, clusterização, inicialização de script ou Docker Compose. Pode realizar estas tarefas manualmente usando ferramentas ou comandos externos.
  • Concebido estritamente para o desenvolvimento local. Não se destina a utilização em produção.
  • Deve resolver quaisquer problemas relacionados com a instalação, configuração ou tempo de execução do Docker.
  • Certifique-se de que o seu computador tem recursos suficientes, ou ajuste a alocação de memória do Docker e os limites de recursos do container através das definiçõ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

  • Last updated on