Instalar as ferramentas de linha de comando do SQL Server sqlcmd e bcp no Linux

Aplica-se a: SQL Server – Linux

As etapas a seguir instalam as ferramentas de linha de comando, os drivers ODBC da Microsoft e as dependências deles. O pacote mssql-tools contém:

  • sqlcmd: utilitário de consulta de linha de comando.
  • bcp: utilitário de importação/exportação em massa.

Instale as ferramentas para a plataforma:

Este artigo descreve como instalar as ferramentas de linha de comando. Se você estiver procurando exemplos de como usar sqlcmd ou bcp, consulte Conteúdo relacionado no final deste artigo.

Importante

O sqlcmd e o bcp estão disponíveis nas mssql-tools18 para as arquiteturas x64 e arm64. Para obter uma alternativa moderna no Linux, macOS e Windows, consulte utilitário go-sqlcmd.

Instalar ferramentas no Linux

Estas instruções são para instalar os pacotes do Microsoft ODBC 18. Para obter mais informações, confira Instalar o Microsoft ODBC Driver for SQL Server (Linux).

Use as seguintes etapas a seguir para instalar as mssql-tools18 no Red Hat Enterprise Linux.

  1. Baixe o arquivo de configuração do repositório do Red Hat da Microsoft.

    • Para o Red Hat 9, use o seguinte comando:

      curl https://packages.microsoft.com/config/rhel/9/prod.repo | sudo tee /etc/yum.repos.d/mssql-release.repo
      
    • Para o Red Hat 8, use o seguinte comando:

      curl https://packages.microsoft.com/config/rhel/8/prod.repo | sudo tee /etc/yum.repos.d/mssql-release.repo
      
    • Para o Red Hat 7, use o seguinte comando:

      curl https://packages.microsoft.com/config/rhel/7/prod.repo | sudo tee /etc/yum.repos.d/mssql-release.repo
      
  2. Se você tiver uma versão anterior do mssql-tools instalada, remova os pacotes unixODBC mais antigos.

    sudo yum remove mssql-tools unixODBC-utf16 unixODBC-utf16-devel
    
  3. Execute os seguintes comandos para instalar mssql-tools18 com o pacote do desenvolvedor do unixODBC.

    sudo yum install -y mssql-tools18 unixODBC-devel
    

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

    sudo yum check-update
    sudo yum update mssql-tools18
    
  4. Opcional: Adicione /opt/mssql-tools18/bin/ à sua variável de ambiente PATH em um shell de Bash.

    Para tornar o sqlcmd e o bcp acessível do shell de Bash para sessões de logon, modifique o PATH no arquivo ~/.bash_profile com o seguinte comando:

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

    Para tornar o sqlcmd e o bcp acessíveis do shell bash para sessões interativas/que não são de logon, modifique o PATH no arquivo ~/.bashrc com o seguinte comando:

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

Instalar ferramentas no macOS

Instale o Homebrew se você ainda não o tiver:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Para instalar as ferramentas no macOS El Captain, use os seguintes comandos:

# brew untap microsoft/mssql-preview if you installed the preview version
brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release
brew update
brew install mssql-tools18

Instalar ferramentas no Docker

Se você executar o SQL Server em um contêiner do Docker, as ferramentas de linha de comando do SQL Server já serão incluídas na imagem de contêiner do Linux do SQL Server. Se você anexar a um contêiner em execução com um shell Bash interativo, poderá executar as ferramentas localmente.

Se você estiver criando um contêiner com as ferramentas de linha de comando do SQL Server, é recomendável adicionar ACCEPT_EULA=Y ao comando de instalação para aceitar rapidamente os termos de licença e não interromper a criação da imagem. Um comando final de exemplo como parte da instalação em uma imagem baseada no Ubuntu é:

sudo ACCEPT_EULA=Y apt-get install mssql-tools18 unixodbc-dev

Instalação offline

Se o computador Linux não tiver acesso aos repositórios online usados nas seções anteriores, baixe os arquivos de pacote diretamente. Esses pacotes estão localizados no repositório da Microsoft, em https://packages.microsoft.com.

Gorjeta

Se você realizar a instalação com sucesso com as etapas das seções anteriores, não precisará baixar nem instalar manualmente os pacotes a seguir. Isso vale apenas para o cenário offline.

  1. Primeiro, localize e copie o pacote mssql-tools18 para sua distribuição do Linux. No Red Hat 8.0, esse pacote está localizado em https://packages.microsoft.com/rhel/8/prod.

  2. Além disso, localize e copie o pacote msodbcsql18, que é uma dependência. O pacote msodbcsql18 também tem uma dependência em unixODBC-devel. No Red Hat, o pacote msodbcsql18 está localizado em https://packages.microsoft.com/rhel/8/prod.

  3. Mova os pacotes baixados para o computador Linux. Se você usou um computador diferente para baixar os pacotes, uma maneira de mover os pacotes para o computador Linux é com o comando scp.

  4. Instalar os pacotes: Instale os pacotes mssql-tools18 e msodbc18. Se você obtiver erros de dependência, ignore-os até a próxima etapa. Substitua <version> pela versão correta:

    sudo yum localinstall msodbcsql18-<version>.rpm
    sudo yum localinstall mssql-tools18-<version>.rpm
    
  5. Resolver dependências ausentes: Você pode ter dependências ausentes neste momento. Caso contrário, você pode ignorar esta etapa. Em alguns casos, você deve localizar essas dependências manualmente e instalá-las.

    Você pode inspecionar as dependências necessárias com os comandos a seguir. Substitua <version> pela versão correta:

    rpm -qpR msodbcsql18-<version>.rpm
    rpm -qpR mssql-tools18-<version>.rpm
    

Contribua com a documentação do SQL

Você sabia que pode editar conteúdo do SQL por conta própria? Ao fazer isso, além de melhorar nossa documentação, você também será creditado como um colaborador da página.

Para obter mais informações, confira Como contribuir para a documentação do SQL Server