Configurar repositórios para instalação e atualização do SQL Server em Linux

Aplica-se a: SQL Server no Linux

Este artigo descreve como configurar o repositório correto para instalar e atualizar o SQL Server 2022 (16.x) e versões anteriores no Red Hat Enterprise Linux (RHEL), SUSE Linux Enterprise Server (SLES) e Ubuntu.

Para instruções sobre como configurar repositórios para SQL Server 2025 (17.x) e versões posteriores, veja Configurar repositórios para instalação e atualização do SQL Server 2025 no Linux.

Repositórios

Ao instalar o SQL Server em Linux, é necessário configurar um repositório da Microsoft. Este repositório é usado para adquirir o pacote do motor de banco de dados, mssql-server, e pacotes SQL Server relacionados. Atualmente, há três repositórios principais:

Repositório	Nome	Description
2022	`mssql-server-2022`	Repositório do SQL Server 2022 (16.x).
2019 CU	`mssql-server-2019`	Repositório de Atualização Cumulativa (CU) do SQL Server 2019 (15.x).
2017 CU	`mssql-server-2017`	Repositório de Atualização Cumulativa (CU) do SQL Server 2017 (14.x).

O repositório contém pacotes para a versão base do SQL Server, além de quaisquer correções de bugs ou melhorias desde esse lançamento. As atualizações cumulativas são específicas para uma versão de lançamento, como o SQL Server 2022 (16.x). Eles são liberados em uma cadência regular. Atualizações de lançamento de distribuição geral (GDR) são lançadas no mesmo repositório.

Cada versão contém o pacote completo do SQL Server e todas as atualizações anteriores para esse repositório. Você também pode fazer um downgrade para qualquer versão na versão principal (por exemplo, 2022).

Configurar repositórios

Use as etapas nas seções a seguir para configurar repositórios na distribuição do Linux.

Verifique repositórios configurados

Primeiro, verifique se você já registrou um repositório do SQL Server.

Exiba os arquivos no diretório /etc/yum.repos.d com o seguinte comando:
```
sudo ls /etc/yum.repos.d
```
Procure por um arquivo que configure o repositório do SQL Server, como mssql-server.repo.

Exiba o conteúdo do arquivo usando cat.

sudo cat /etc/yum.repos.d/mssql-server.repo

O nome do repositório na baseurl propriedade, como mssql-server-2022, é o repositório configurado. Você pode identificá-lo com a tabela na seção Repositórios deste artigo.

Utilize zypper info para obter informações sobre o repositório configurado.
```
sudo zypper info mssql-server
```
A propriedade Repository é o repositório configurado. Você pode identificá-lo com a tabela na seção Repositórios deste artigo.

Encontre os arquivos no /etc/apt/sources.list.d diretório que configuram um repositório SQL Server usando o seguinte comando:
```
grep -rl mssql-server /etc/apt/sources.list.d
```

Exiba o conteúdo de cada arquivo usando cat.

cat /etc/apt/sources.list.d/mssql-server.list

O nome do repositório na URL do pacote, como mssql-server-2022, é o repositório configurado. Você pode identificá-lo com a tabela na seção Repositórios deste artigo.

Remover o repositório antigo

Se necessário, remova o repositório antigo com o comando a seguir.

sudo rm -rf /etc/yum.repos.d/mssql-server.repo

Esse comando pressupõe que o arquivo identificado na seção anterior seja chamado mssql-server.repo.

Use um dos seguintes comandos com base no tipo de repositório configurado.

Repositório	Comando para remoção
2022	`sudo zypper removerepo 'packages-microsoft-com-mssql-server-2022'`
2019 CU	`sudo zypper removerepo 'packages-microsoft-com-mssql-server-2019'`
2017 CU	`sudo zypper removerepo 'packages-microsoft-com-mssql-server-2017'`

sudo rm /etc/apt/sources.list.d/mssql-server.list

Esse comando pressupõe que o arquivo identificado na seção anterior seja chamado mssql-server.list.

Configurar o novo repositório

Configure o novo repositório a ser usado para instalações e atualizações do SQL Server. Use um dos comandos a seguir para configurar o repositório de sua escolha.

RHEL 9 é suportado a partir do SQL Server 2022 (16.x) CU 10.
RHEL 8 é suportado a partir do SQL Server 2017 (14.x) CU 20.

Os comandos a seguir para o SQL Server 2019 (15.x) apontam para o repositório RHEL 8. RHEL 8 não vem com python2 pré-instalado, que é necessário para o SQL Server. Para obter mais informações, confira Instalar o Microsoft SQL Server no Red Hat Enterprise Linux 8 Beta.

Dependendo da versão do RHEL usada, verifique se os caminhos correspondem /rhel/8, /rhel/9ou /rhel/10. Nossos pacotes são independentes para versões secundárias do RHEL. Isso significa que, se você usar o RHEL 8.7, precisará usar o caminho /rhel/8 para configurar o repositório.

Repositório	Versão	Release	Command
2022	2022	RHEL 9	`sudo curl -fsSL -o /etc/yum.repos.d/mssql-server.repo https://packages.microsoft.com/config/rhel/9/mssql-server-2022.repo`
2019 CU	2019	RHEL 8	`sudo curl -fsSL -o /etc/yum.repos.d/mssql-server.repo https://packages.microsoft.com/config/rhel/8/mssql-server-2019.repo`
2017 CU	2017	RHEL 8	`sudo curl -fsSL -o /etc/yum.repos.d/mssql-server.repo https://packages.microsoft.com/config/rhel/8/mssql-server-2017.repo`

Configure o novo repositório a ser usado para instalações e atualizações do SQL Server. Use um dos comandos a seguir para configurar o repositório de sua escolha.

Repositório	Versão	Command
2022	2022	`sudo zypper addrepo -fc https://packages.microsoft.com/config/sles/15/mssql-server-2022.repo`
2019 CU	2019	`sudo zypper addrepo -fc https://packages.microsoft.com/config/sles/15/mssql-server-2019.repo`
2017 CU	2017	`sudo zypper addrepo -fc https://packages.microsoft.com/config/sles/12/mssql-server-2017.repo`

Configure o novo repositório a ser usado para instalações e atualizações do SQL Server.

O Ubuntu 22.04 é suportado a partir do SQL Server 2022 (16.x) CU 10.
Ubuntu 20.04 tem suporte a partir do SQL Server 2019 (15.x) CU 10.
Ubuntu 18.04 é suportado a partir do SQL Server 2017 (14.x) CU 20 e SQL Server 2019 (15.x) CU 3.

Os comandos a seguir apontam para o repositório mais recente para uma distribuição específica. Se você usar uma distribuição anterior onde essa versão do SQL Server ainda é suportada, mude o caminho de acordo.

Importe as chaves GPG do repositório público.

curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | sudo tee /etc/apt/trusted.gpg.d/microsoft.asc

Use um dos seguintes comandos para baixar e registrar o repositório de sua escolha.

Repositório	Versão	Release	Command
2022	2022	Ubuntu 22.04	`sudo curl -fsSL -o /etc/apt/sources.list.d/mssql-server.list https://packages.microsoft.com/config/ubuntu/22.04/mssql-server-2022.list`
2019 CU	2019	Ubuntu 20.04	`sudo curl -fsSL -o /etc/apt/sources.list.d/mssql-server.list https://packages.microsoft.com/config/ubuntu/20.04/mssql-server-2019.list`
2017 CU	2017	Ubuntu 18.04	`sudo curl -fsSL -o /etc/apt/sources.list.d/mssql-server.list https://packages.microsoft.com/config/ubuntu/18.04/mssql-server-2017.list`

Execute apt-get update.
```
sudo apt-get update
```

Se você optar por usar um artigo de início rápido, lembre-se de que já configurou o repositório de destino. Não repita essa etapa no tutorial.

Comentários

Esta página foi útil?

Última atualização em 2026-10-08