Guia de início rápido: instale o SQL Server e crie um banco de dados no Ubuntu

Aplica-se a:SQL Server em Linux

Neste início rápido, você instala o SQL Server 2017 (14.x) no Ubuntu 18.04. Depois podes ligar-te a sqlcmd para criar a tua primeira base de dados e fazer consultas.

Neste início rápido, você instala o SQL Server 2019 (15.x) no Ubuntu 20.04. Depois podes ligar-te a sqlcmd para criar a tua primeira base de dados e fazer consultas.

Neste quickstart, instala o SQL Server 2022 (16.x) no Ubuntu 22.04. Depois podes ligar-te a sqlcmd para criar a tua primeira base de dados e fazer consultas.

Neste quickstart, instala o SQL Server 2025 (17.x) no Ubuntu 24.04. Depois podes ligar-te a sqlcmd para criar a tua primeira base de dados e fazer consultas.

Para mais informações sobre plataformas suportadas, consulte Informações de lançamento para SQL Server no Linux.

Tip

Este tutorial requer a entrada do usuário e uma conexão com a Internet. Se estiver interessado nos procedimentos de instalação não assistida ou offline, consulte Diretrizes de instalação do SQL Server no Linux.

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.

Pré-requisitos

Precisas de uma máquina Ubuntu 18.04 com pelo menos 2 GB de memória.

Para instalar o Ubuntu 18.04 em sua própria máquina, vá para https://releases.ubuntu.com/18.04/.

Precisas de uma máquina Ubuntu 20.04 com pelo menos 2 GB de memória.

Para instalar o Ubuntu 20.04 em sua própria máquina, vá para https://releases.ubuntu.com/20.04/.

Precisas de uma máquina Ubuntu 22.04 com pelo menos 2 GB de memória.

Para instalar o Ubuntu 22.04 em sua própria máquina, vá para https://releases.ubuntu.com/22.04/.

Precisas de uma máquina Ubuntu 24.04 com pelo menos 2 GB de memória.

Para instalar o Ubuntu 24.04 na sua própria máquina, vá a https://releases.ubuntu.com/24.04/.

Também pode criar máquinas virtuais Ubuntu ou Ubuntu Pro no Azure. Consulte Tutorial: Criar e gerenciar VMs Linux com a CLI do Azure.

Se você instalou anteriormente uma versão de visualização do SQL Server, você deve primeiro remover o repositório antigo antes de seguir estas etapas. Para obter mais informações, consulte Configurar repositórios para instalar e atualizar o SQL Server no Linux.

Se você instalou anteriormente uma versão de visualização do SQL Server, você deve primeiro remover o repositório antigo antes de seguir estas etapas. Para mais informações, consulte Configurar repositórios para instalação e atualização do SQL Server 2025 no Linux.

Note

O SQL Server no Subsistema Windows para Linux (WSL) é suportado apenas para fins de desenvolvimento. Para instruções sobre como instalar o SQL Server no WSL, consulte Início Rápido: Instalar o SQL Server e criar uma base de dados no Subsistema Windows para Linux (WSL 2).

Para obter outros requisitos do sistema, consulte Requisitos do sistema para o SQL Server no Linux.

Tip

Para ambientes de produção que requerem conformidade com FIPS ou cobertura de Manutenção de Segurança Expandida (ESM) para pacotes do Universo Ubuntu, use o Ubuntu Pro. Pode ativar o Ubuntu Pro na sua instância existente, ou selecionar uma imagem pré-configurada do Ubuntu Pro ao provisionar a sua máquina virtual no Azure.

Instalar o SQL Server

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

Aplica-se a: SQL Server 2025 (17.x) CU 1 e versões posteriores.

Descarregue a chave pública, converta-a de ASCII para formato GPG e escreva-a no local desejado:

curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --batch --yes --dearmor -o /usr/share/keyrings/microsoft-prod.gpg

Para configurar o SQL Server no Ubuntu, execute os seguintes comandos num terminal para instalar o mssql-server pacote.

Registre o repositório do SQL Server Ubuntu:

curl -fsSL https://packages.microsoft.com/config/ubuntu/18.04/mssql-server-2017.list | sudo tee /etc/apt/sources.list.d/mssql-server.list

Registre o repositório do SQL Server Ubuntu:

curl -fsSL https://packages.microsoft.com/config/ubuntu/20.04/mssql-server-2019.list | sudo tee /etc/apt/sources.list.d/mssql-server.list

Registre o repositório do SQL Server Ubuntu:

curl -fsSL https://packages.microsoft.com/config/ubuntu/22.04/mssql-server-2022.list | sudo tee /etc/apt/sources.list.d/mssql-server.list

Registre o repositório do SQL Server Ubuntu:

curl -fsSL https://packages.microsoft.com/config/ubuntu/24.04/mssql-server-2025.list | sudo tee /etc/apt/sources.list.d/mssql-server-2025.list

Tip

Para instalar uma versão diferente do SQL Server, consulte as versões deste artigo do SQL Server 2025, SQL Server 2022, SQL Server 2019 ou SQL Server 2017.

  1. Instalar SQL Server:

    sudo apt-get update
    sudo apt-get install -y mssql-server
    
  2. Após a conclusão da instalação do pacote, execute mssql-conf setup e siga as instruções para definir a senha do sa e escolher sua edição. As seguintes edições do SQL Server são licenciadas livremente: Evaluation, Developer e Express. (SQL Server 2025 (17.x) oferece edições Enterprise Developer e Standard Developer.)

    sudo /opt/mssql/bin/mssql-conf 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.

  3. Quando a configuração estiver concluída, verifique se o serviço está a funcionar:

    systemctl status mssql-server --no-pager
    
  4. Se você planeja se conectar remotamente, talvez também seja necessário abrir a porta TCP do SQL Server (padrão 1433) no firewall.

Neste ponto, o SQL Server está sendo executado em sua máquina Ubuntu e está pronto para uso.

Desativar a conta sa como prática recomendada

Quando você se conecta à sua instância do SQL Server usando a conta de administrador do sistema (sa) pela primeira vez após a instalação, é importante seguir estas etapas e, em seguida, desativar imediatamente a conta sa como uma prática recomendada de segurança.

  1. Crie um novo login e torne-o membro da função de servidor sysadmin.

  2. Conecte-se à instância do SQL Server usando o novo logon que você criou.

  3. Desative a conta sa, conforme recomendado para as práticas recomendadas de segurança.

Instalar as ferramentas de linha de comando do SQL Server

Para criar um banco de dados, você precisa se conectar a uma ferramenta que possa executar instruções Transact-SQL no SQL Server. As etapas a seguir instalam as ferramentas de linha de comando do SQL Server: utilitário sqlcmd e utilitário bcp.

Siga os passos seguintes para instalar o mssql-tools18 no Ubuntu.

  • Ubuntu 24.04 é suportado a partir do SQL Server 2025 (17.x) CU 1.
  • O Ubuntu 22.04 é suportado a partir do SQL Server 2022 (16.x) CU 10.
  • Ubuntu 20.04 é suportado a partir do SQL Server 2019 (15.x) CU 10.
  • O Ubuntu 18.04 é suportado a partir do SQL Server 2017 (14.x) CU 20 e do SQL Server 2019 (15.x) CU 3.

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

Registre o repositório do Microsoft Ubuntu.

curl -fsSL https://packages.microsoft.com/config/ubuntu/18.04/prod.list | sudo tee /etc/apt/sources.list.d/mssql-release.list

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

Registre o repositório do Microsoft Ubuntu.

curl -fsSL https://packages.microsoft.com/config/ubuntu/20.04/prod.list | sudo tee /etc/apt/sources.list.d/mssql-release.list

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

Registre o repositório do Microsoft Ubuntu.

curl -fsSL https://packages.microsoft.com/config/ubuntu/22.04/prod.list | sudo tee /etc/apt/sources.list.d/mssql-release.list

Descarregue a chave pública, converta-a de ASCII para formato GPG e escreva-a no local necessário.

curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --batch --yes --dearmor -o /usr/share/keyrings/microsoft-prod.gpg

Registre o repositório do Microsoft Ubuntu.

curl -fsSL https://packages.microsoft.com/config/ubuntu/24.04/prod.list | sudo tee /etc/apt/sources.list.d/mssql-release.list
  1. Atualize a lista de fontes e execute o comando de instalação com o pacote do desenvolvedor unixODBC.

    sudo apt-get update
    sudo apt-get install mssql-tools18 unixodbc-dev
    

    Para atualizar para a versão mais recente do mssql-tools18, execute os seguintes comandos:

    sudo apt-get update
    sudo apt-get install mssql-tools18
    
  2. Opcional: Adiciona /opt/mssql-tools18/bin/ à tua PATH variável de ambiente num shell Bash.

    Para tornar sqlcmd e bcp acessíveis a partir do shell Bash para sessões de login, modifique o seu PATH no ficheiro ~/.bash_profile com o seguinte comando:

    echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bash_profile
    source ~/.bash_profile
    

    Para tornar sqlcmd e bcp acessíveis a partir do shell Bash para sessões interativas e não interativas de login, modifique o PATH no ficheiro ~/.bashrc com o seguinte comando:

    echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bashrc
    source ~/.bashrc
    

Conecte-se localmente

Os passos seguintes utilizam a utilidade sqlcmd para se ligar localmente à sua nova instância SQL Server. Descarregue e instale a utilidade sqlcmd para Windows, Linux e macOS.

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.

  1. Execute sqlcmd com parâmetros para o seu nome de SQL Server (-S), o nome de utilizador (-U) e a palavra-passe (-P). Neste tutorial, você se conecta localmente, portanto, o nome do servidor é localhost. O nome de usuário é sa e a senha é a que você forneceu para a conta sa durante a configuração.

    sqlcmd -S localhost -U sa -P '<password>'
    

    Note

    As versões mais recentes de sqlcmd são seguras por padrão. Para mais informações sobre encriptação de ligações, consulte a utilidade sqlcmd para Windows, Linux e macOS. Se a ligação não resultar, podes adicionar a -No opção para sqlcmd especificar que a encriptação é opcional, não obrigatória.

    Você pode omitir a senha na linha de comando e será pedido para inseri-la.

    Se, mais tarde, decidir ligar remotamente, especifique o nome da máquina ou o endereço IP para o parâmetro -S e certifique-se de que a porta 1433 está aberta na firewall.

  2. Se for bem-sucedido, deverá chegar ao sqlcmd prompt de comandos: 1>.

  3. Se você receber uma falha de conexão, primeiro tente diagnosticar o problema a partir da mensagem de erro. Em seguida, revise as recomendações de solução de problemas de conexão .

Criar e consultar dados

As secções seguintes irão guiá-lo para utilizar sqlcmd criar uma nova base de dados, adicionar dados e executar uma consulta básica.

Para mais informações sobre como escrever instruções e consultas Transact-SQL (T-SQL), veja Tutorial: Escrever instruções Transact-SQL.

Criar uma nova base de dados

As etapas a seguir criam um novo banco de dados chamado TestDB.

  1. A partir do sqlcmd prompt de comandos, cole o seguinte comando T-SQL para criar uma base de dados de teste:

    CREATE DATABASE TestDB;
    
  2. Na próxima linha, escreva uma consulta para retornar o nome de todos os bancos de dados no servidor:

    SELECT Name
    FROM sys.databases;
    
  3. Os dois comandos anteriores não são executados imediatamente. Você deve digitar GO em uma nova linha para executar os comandos anteriores:

    GO
    

Inserir dados

Em seguida, crie uma nova tabela, dbo.Inventorye insira duas novas linhas.

  1. A partir do prompt de comando sqlcmd, altere o contexto para a nova base de dados TestDB:

    USE TestDB;
    
  2. Crie uma nova tabela com o nome dbo.Inventory:

    CREATE TABLE dbo.Inventory
    (
        id INT,
        name NVARCHAR (50),
        quantity INT,
        PRIMARY KEY (id)
    );
    
  3. Insira dados na nova tabela:

    INSERT INTO dbo.Inventory
    VALUES (1, 'banana', 150);
    
    INSERT INTO dbo.Inventory
    VALUES (2, 'orange', 154);
    
  4. Digite GO para executar os comandos anteriores:

    GO
    

Selecionar dados

Agora, execute uma consulta para retornar dados da tabela dbo.Inventory.

  1. No prompt de comandos sqlcmd, introduza uma query que devolva linhas na tabela dbo.Inventory onde a quantidade é superior a 152.

    SELECT *
    FROM dbo.Inventory
    WHERE quantity > 152;
    
  2. Execute o comando:

    GO
    

Saia do prompt de comando do sqlcmd

Para terminar a sua sqlcmd sessão, escreva QUIT:

QUIT

Práticas recomendadas de desempenho

Depois de instalar o SQL Server no Linux, revise as práticas recomendadas para configurar o Linux e o SQL Server para melhorar o desempenho em cenários de produção. Para obter mais informações, consulte:

Ferramentas de dados multiplataforma

Para além do sqlcmd, pode usar as seguintes ferramentas multiplataforma para gerir SQL Server:

Tool Description
Código do Visual Studio Um editor de código GUI multiplataforma que executa instruções T-SQL com a extensão MSSQL.
PowerShell Uma ferramenta de automação e configuração multiplataforma baseada em cmdlets.

Ligar a partir do Windows

As ferramentas do SQL Server no Windows se conectam a instâncias do SQL Server no Linux da mesma forma que se conectariam a qualquer instância remota do SQL Server.

Se tiver uma máquina Windows que se possa ligar à sua máquina Linux, tente os mesmos passos deste artigo a partir de um prompt de comandos do Windows em execução sqlcmd. Você deve usar o nome da máquina Linux de destino ou o endereço IP em vez de localhoste certificar-se de que a porta TCP 1433 está aberta na máquina do SQL Server. Se tiver problemas de ligação a partir do Windows, consulte recomendações de resolução de problemas de ligação.

Para outras ferramentas que são executadas no Windows, mas se conectam ao SQL Server no Linux, consulte:

Outros cenários de implantação

Para outros cenários de instalação, consulte os seguintes recursos:

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

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 a documentação do Microsoft Learn.