Diretrizes de instalação do SQL Server no Linux

Aplica-se a:SQL Server em Linux

Este artigo fornece orientações para instalar, atualizar e desinstalar o SQL Server 2017 (14.x), SQL Server 2019 (15.x), SQL Server 2022 (16.x) e SQL Server 2025 (17.x) no Linux.

Para outros cenários de implantação, consulte:

• Mac OS
• Contêineres Linux
• Kubernetes - Clusters de Big Data (somente SQL Server 2019 (15.x))

Este guia aborda vários cenários de implantação. Se precisar apenas de instruções detalhadas de instalação, passe para um dos guias rápidos:

• Guia de início rápido: instale o SQL Server e crie um banco de dados no Red Hat
• Guia de início rápido: instale o SQL Server e crie um banco de dados no SUSE Linux Enterprise Server
• Guia de início rápido: instale o SQL Server e crie um banco de dados no Ubuntu
• Guia de início rápido: executar imagens de contêiner do SQL Server Linux com o Docker

Para obter respostas às perguntas frequentes, consulte o SQL Server on Linux FAQ.

Política de suporte do SQL Server

Período	Definição
Manutenção	A Microsoft lança GDR, hotfixes e correções de segurança dentro do ciclo de vida do produto para distribuições suportadas.
Suporte	A Microsoft oferece suporte a usuários com problemas relacionados a distribuições suportadas.

Política de suporte

O SQL Server tem suporte em distribuições Linux até o primeiro de dois eventos: o fim do ciclo de vida de suporte da distribuição ou o fim do ciclo de vida de suporte do SQL Server.

Política de manutenção

Durante a fase de suporte base do SQL Server, fornecemos atualizações cumulativas (CUs) para todas as distribuições Linux que também estão dentro do período de suporte base. Para distribuições Linux que mudam do suporte Mainstream para o Extended e ainda são reconhecidas como plataformas suportadas, a Microsoft pode lançar CUs e correções de bugs a seu critério.

Depois que o SQL Server passar do suporte base para a fase de suporte estendido, continuaremos a publicar atualizações de segurança e correções de GDR (General Distribution Release). No entanto, essas atualizações não são estendidas para distribuições Linux que concluem seu período de suporte.

Plataformas suportadas

O SQL Server é suportado no Red Hat Enterprise Linux (RHEL), SUSE Linux Enterprise Server (SLES) e Ubuntu. Também é suportado como uma imagem de contêiner, que pode ser executada no Kubernetes, OpenShift e Docker Engine no Linux.

Deve executar cargas de produção em plataformas suportadas como Red Hat Enterprise Linux e Ubuntu Pro, pois recebem atualizações regulares de segurança do sistema operativo e têm opções de cobertura de suporte necessárias para implementações de bases de dados empresariais.

Plataforma	Sistema de ficheiros	Guia de instalação	Obter
Red Hat Enterprise Linux 10.x Server (em pré-visualização) Servidor Red Hat Enterprise Linux 9.x	XFS ou ext4	Guia de instalação	Obtenha RHEL 10 Obtenha RHEL 9
Ubuntu 24.04 (em pré-visualização) Ubuntu 22,04	XFS ou ext4	Guia de instalação	Obtenha o Ubuntu 24.04 Obter Ubuntu 22.04
Docker Engine 1.8+ em Linux 1	N/A	Guia de instalação	Obtenha Docker

¹ As imagens de contêiner do SQL Server são suportadas apenas em hosts Linux executados em CPUs Intel e AMD x86-64. Ambientes de emulação ou tradução (por exemplo, Rosetta 2, Prism ou QEMU) não são testados ou suportados. Se você quiser criar uma solicitação de recurso ou relatar um problema relacionado ao emulador, visite o repositório oficial do GitHub.

Sugestão

Para obter mais informações, consulte os requisitos de sistema para SQL Server no Linux. Para obter a política de suporte mais recente para o SQL Server, consulte a política de suporte técnico para o Microsoft SQL Server.

A Microsoft também oferece suporte à implantação e ao gerenciamento de contêineres do SQL Server usando OpenShift e Kubernetes.

Observação

O SQL Server é testado e tem suporte no Linux para as distribuições listadas anteriormente. Se você optar por instalar o SQL Server em um sistema operacional sem suporte, consulte a seção Política de suporte da política de suporte técnico para Microsoft SQL Server para entender as implicações de suporte.

Requisitos do sistema

O SQL Server tem os seguintes requisitos de sistema para Linux:

	Requisito
Memória	2 GB 1
Sistema de Arquivos	XFS ou ext4 (outros sistemas de arquivos, como BTRFS, não são suportados)
Espaço em disco	6 GB
Velocidade do processador	2 GHz
Núcleos do processador	2 núcleos
Tipo de processador	Apenas compatível com x64

¹ 2 GB é a memória mínima necessária para iniciar o SQL Server no Linux, que acomoda threads do sistema e processos internos. Você deve levar essa quantidade em consideração ao definir max server memory e MemoryLimitMB.

Se você usar compartilhamentos remotos NFS (Network File System) na produção, observe os seguintes requisitos de suporte:

• Use o NFS versão 4.2 ou superior. As versões mais antigas do NFS não suportam os recursos necessários, como a criação de arquivos fallocate e esparsos, comuns aos sistemas de arquivos modernos.
• Localize apenas os diretórios /var/opt/mssql no ponto de montagem NFS. Não há suporte para outros arquivos, como os binários do sistema SQL Server.

Configurar repositórios de origem

Ao instalar ou atualizar o SQL Server, você obtém a versão mais recente do SQL Server do repositório configurado da Microsoft. As quickstarts usam o repositório de Atualização Cumulativa CU para SQL Server. Para mais informações sobre repositórios e como os configurar, consulte Configurar repositórios para instalação e atualização do SQL Server 2025 no Linux.

Instalar o SQL Server

Você pode instalar o SQL Server no Linux a partir da linha de comando. Para obter instruções passo a passo, consulte uma das seguintes introduções rápidas:

Plataforma	Inícios rápidos de instalação
Red Hat Enterprise Linux (RHEL)	2017 | 2019 | 2022 | 2025
Servidor SUSE Linux Enterprise (SLES)	2017 | 2019 | 2022 | 2025
Ubuntu	2017 | 2019 | 2022 | 2025
Docker	2017 | 2019 | 2022 | 2025

Você também pode executar o SQL Server no Linux em uma máquina virtual do Azure. Para obter mais informações, consulte Provisionar uma VM SQL no Azure.

Após a instalação, considere fazer alterações de configuração adicionais para um desempenho ideal. Para obter mais informações, consulte Práticas recomendadas de desempenho e diretrizes de configuração para o SQL Server no Linux.

Atualizar ou fazer upgrade do SQL Server

Para atualizar o mssql-server pacote para a versão mais recente, use um dos seguintes comandos com base na sua plataforma:

Plataforma	Comandos de atualização de pacote
RHEL	sudo yum update mssql-server
SLES	sudo zypper update mssql-server
Ubuntu	sudo apt-get update sudo apt-get install mssql-server

Esses comandos baixam o pacote mais recente e substituem os binários localizados em /opt/mssql/. Os bancos de dados gerados pelo usuário e os bancos de dados do sistema não são afetados por essa operação.

Para atualizar o SQL Server, primeiro altere o repositório configurado para a versão desejada do SQL Server. Em seguida, use o mesmo update comando para atualizar sua versão do SQL Server. Esta etapa só é possível se o caminho de atualização for suportado entre os dois repositórios.

Restaurar o SQL Server

Para reverter ou fazer downgrade do SQL Server para uma versão anterior, use as seguintes etapas:

1. Identifique o número da versão do pacote do SQL Server para o qual você deseja fazer o downgrade. Para obter uma lista de números de pacote, consulte as notas de versão:

   • Notas de versão do SQL Server 2022 para Linux
   • Notas de versão do SQL Server 2019 no Linux
   • Notas de lançamento do SQL Server 2017 no Linux

2. Downgrade para uma versão anterior do SQL Server. Nos comandos a seguir, substitua <version_number> pelo número de versão do SQL Server identificado na etapa 1.

   Plataforma	Comandos de atualização de pacote
   RHEL	sudo yum downgrade mssql-server-<version_number>.x86_64
   SLES	sudo zypper install --oldpackage mssql-server=<version_number>
   Ubuntu	sudo apt-get install mssql-server=<version_number> sudo systemctl start mssql-server

Observação

O único downgrade com suporte é se você fizer o downgrade para uma versão dentro da mesma versão principal, como o SQL Server 2022 (16.x).

Verifique a versão instalada do SQL Server

Para verificar sua versão atual e edição do SQL Server no Linux, use o seguinte procedimento:

1. Se ainda não estiver instalado, consulte Instalar as ferramentas de linha de comando sqlcmd e bcp do SQL Server no Linux.

2. Use sqlcmd para executar um comando Transact-SQL que exibe sua versão e edição do SQL Server.

   sqlcmd -S localhost -U sa -Q 'select @@VERSION'
   

Desinstalar o SQL Server

Para remover o mssql-server pacote no Linux, use um dos seguintes comandos baseados na sua plataforma:

Plataforma	Comandos de remoção de pacotes
RHEL	sudo yum remove mssql-server
SLES	sudo zypper remove mssql-server
Ubuntu	sudo apt-get remove mssql-server

A remoção do pacote não exclui os arquivos de banco de dados gerados. Se desejar excluir os arquivos de banco de dados, use o seguinte comando:

sudo rm -rf /var/opt/mssql/

Instalação não assistida

Você pode executar uma instalação autônoma da seguinte maneira:

• Siga as etapas iniciais nos inícios rápidos para registrar os repositórios e instalar o SQL Server.
• Ao executar mssql-conf setup, defina variáveis de ambiente e use a opção -n (sem prompt).

O exemplo a seguir configura o SQL Server Developer edition com a variável de MSSQL_PID ambiente. Ele também aceita o EULA (ACCEPT_EULA) e define a sa senha (MSSQL_SA_PASSWORD). O -n parâmetro executa uma instalação não solicitada onde os valores de configuração são extraídos das variáveis de ambiente.

sudo MSSQL_PID=Developer ACCEPT_EULA=Y MSSQL_SA_PASSWORD='<password>' /opt/mssql/bin/mssql-conf -n setup

Atenção

A sua palavra-passe deve seguir a política de palavra-passe padrão do SQL Server . Por padrão, a senha deve ter pelo menos oito caracteres e conter caracteres de três dos quatro conjuntos a seguir: letras maiúsculas, letras minúsculas, dígitos de base 10 e símbolos. As palavras-passe podem ter até 128 caracteres. Use senhas tão longas e complexas quanto possível.

Você também pode criar um script que execute outras ações. Por exemplo, você pode instalar outros pacotes do SQL Server.

Para obter um script de exemplo mais detalhado, consulte os seguintes exemplos:

• Exemplo: Script de instalação autônoma do SQL Server para Red Hat Enterprise Linux
• Exemplo: Script de instalação autônoma do SQL Server para SUSE Linux Enterprise Server
• Exemplo: Script de instalação autônoma do SQL Server para Ubuntu

Instalação offline

Se sua máquina Linux não tem acesso aos repositórios on-line usados nos inícios rápidos, você pode baixar os arquivos do pacote diretamente. Esses pacotes estão localizados no repositório da Microsoft, em https://packages.microsoft.com.

Sugestão

Se você instalou com êxito com as etapas nos inícios rápidos, não precisará baixar ou instalar manualmente o(s) pacote(s) do SQL Server. Esta seção é apenas para o cenário offline.

1. Baixe o pacote do mecanismo de banco de dados para sua plataforma. Encontre links de download de pacotes na seção de detalhes do pacote das Notas de versão do SQL Server 2022 no Linux.

2. Mova o pacote baixado para sua máquina Linux. Se você usou uma máquina diferente para baixar os pacotes, uma maneira de mover os pacotes para sua máquina Linux é com o comando scp.

3. Instale o pacote do mecanismo de banco de dados. Use um dos seguintes comandos com base na sua plataforma. Substitua o nome do arquivo do pacote neste exemplo pelo nome exato que você baixou.

   Plataforma	Comando de instalação do pacote
   RHEL	sudo yum localinstall mssql-server_versionnumber.x86_64.rpm
   SLES	sudo zypper install mssql-server_versionnumber.x86_64.rpm
   Ubuntu	sudo dpkg -i mssql-server_versionnumber_amd64.deb

   Observação

   Você também pode instalar os pacotes RPM (RHEL e SLES) com o rpm -ivh comando, mas os comandos na tabela anterior instalam automaticamente dependências se disponíveis a partir de repositórios aprovados.

4. Resolver dependências ausentes: Você pode ter dependências ausentes neste momento. Caso contrário, pode ignorar este passo. No Ubuntu, se você tiver acesso a repositórios aprovados contendo essas dependências, a solução mais fácil é usar o apt-get -f install comando. Este comando também conclui a instalação do SQL Server. Para inspecionar manualmente as dependências, use os seguintes comandos:

   Plataforma	Comando Listar dependências
   RHEL	rpm -qpR mssql-server_versionnumber.x86_64.rpm
   SLES	rpm -qpR mssql-server_versionnumber.x86_64.rpm
   Ubuntu	dpkg -I mssql-server_versionnumber_amd64.deb

   Depois de resolver as dependências ausentes, você pode tentar instalar o mssql-server pacote novamente.

5. Conclua a instalação do SQL Server. Use mssql-conf para concluir a instalação do SQL Server:

   sudo /opt/mssql/bin/mssql-conf setup
   

Licença e preços

O SQL Server é licenciado da mesma forma para Linux e Windows. Para obter mais informações sobre licenciamento e preços do SQL Server, consulte Como licenciar o SQL Server e Recursos e documentos de licenciamento do SQL Server.

Recursos opcionais do SQL Server

Após a instalação, você também pode instalar ou habilitar recursos opcionais do SQL Server.

• Instalar as ferramentas de linha de comando sqlcmd e bcp do SQL Server no Linux
• Instalar o SQL Server Agent no Linux
• Instalar o SQL Server Full-Text Search no Linux
• Instalar os Serviços de Machine Learning do SQL Server 2019 (Python e R) no Linux
• Instalar o SQL Server Integration Services (SSIS) no Linux

Obter ajuda

• Ideias para SQL: Tem sugestões para melhorar o SQL Server?
• Microsoft Q & A (SQL Server)
• DBA Stack Exchange (tag sql-server): Faça perguntas sobre o SQL Server
• Stack Overflow (tag sql-server): Respostas para perguntas de desenvolvimento SQL
• Termos de Licença e Informações do Microsoft SQL Server
• Opções de suporte para utilizadores empresariais
• Ajuda e comentários adicionais do SQL Server

Contribuir para a documentação do SQL

Você sabia que você mesmo pode editar conteúdo SQL? Se o fizer, não só ajudará a melhorar a nossa documentação, como também será creditado como contribuidor da página.

Para obter mais informações, consulte Editar documentação do Microsoft Learn.

Conteúdo relacionado

• Perguntas frequentes (FAQ) do SQL Server no Linux