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.
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
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
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
Opcional: Adicione
/opt/mssql-tools18/bin/
à sua variável de ambientePATH
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.
Dica
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.
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.
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.
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.
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
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
Conteúdo relacionado
- Início Rápido: Instalar o SQL Server e criar um banco de dados no Red Hat
- Início Rápido: instalar o SQL Server e criar um banco de dados no SUSE Linux Enterprise Server
- Início Rápido: Instalar o SQL Server e criar um banco de dados no Ubuntu
- Início Rápido: Executar imagens de contêiner do SQL Server Linux com o Docker
- Copiar dados em massa com bcp para o SQL Server em Linux
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
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários