Instalar sqlcmd e bcp, as ferramentas de linha de comando do SQL Server no LinuxInstall sqlcmd and bcp the SQL Server command-line tools on Linux

APLICA-SE A: simSQL Server (somente para o Linux) nãoBanco de Dados SQL do Azure nãoSQL Data Warehouse do Azure nãoParallel Data Warehouse APPLIES TO: yesSQL Server (Linux only) noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

As etapas a seguir instalam as ferramentas de linha de comando, os drivers ODBC da Microsoft e as dependências deles.The following steps install the command-line tools, Microsoft ODBC drivers, and their dependencies. O pacote mssql-tools contém:The mssql-tools package contains:

  • sqlcmd: utilitário de consulta de linha de comando.sqlcmd: Command-line query utility.
  • bcp: utilitário de importação/exportação em massa.bcp: Bulk import-export utility.

Instale as ferramentas para a plataforma:Install the tools for your platform:

Este artigo descreve como instalar as ferramentas de linha de comando.This article describes how to install the command-line tools. Se você estiver procurando exemplos de como usar o sqlcmd ou o bcp, confira os links no final deste tópico.If you are looking for examples of how to use sqlcmd or bcp, see the links at the end of this topic.

Instalar ferramentas no RHEL 7Install tools on RHEL 7

Use as seguintes etapas a seguir para instalar o mssql-tools no Red Hat Enterprise Linux.Use the following steps to install the mssql-tools on Red Hat Enterprise Linux.

  1. Entre no modo de superusuário.Enter superuser mode.

    sudo su
    
  2. Baixe o arquivo de configuração do repositório do Red Hat da Microsoft.Download the Microsoft Red Hat repository configuration file.

    curl https://packages.microsoft.com/config/rhel/7/prod.repo > /etc/yum.repos.d/msprod.repo
    
  3. Saia do modo de superusuário.Exit superuser mode.

    exit
    
  4. Se você tiver uma versão anterior do mssql-tools instalada, remova os pacotes unixODBC mais antigos.If you had a previous version of mssql-tools installed, remove any older unixODBC packages.

    sudo yum remove mssql-tools unixODBC-utf16-devel
    
  5. Execute os seguintes comandos para instalar mssql-tools com o pacote do desenvolvedor do unixODBC.Run the following commands to install mssql-tools with the unixODBC developer package.

    sudo yum install mssql-tools unixODBC-devel
    

    Observação

    Para atualizar para a versão mais recente do mssql-tools, execute os seguintes comandos:To update to the latest version of mssql-tools run the following commands:

    sudo yum check-update
    sudo yum update mssql-tools
    
  6. Opcional: Adicione /opt/mssql-tools/bin/ à sua variável de ambiente PATH em um shell de Bash.Optional: Add /opt/mssql-tools/bin/ to your PATH environment variable in a bash shell.

    Para tornar o sqlcmd/bcp acessível do shell de Bash para sessões de logon, modifique o PATH no arquivo ~/.bash_profile com o seguinte comando:To make sqlcmd/bcp accessible from the bash shell for login sessions, modify your PATH in the ~/.bash_profile file with the following command:

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

    Para tornar o sqlcmd/bcp acessível do shell de Bash para sessões interativas/que não são de logon, modifique o PATH no arquivo ~/.bashrc com o seguinte comando:To make sqlcmd/bcp accessible from the bash shell for interactive/non-login sessions, modify the PATH in the ~/.bashrc file with the following command:

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

Instalar ferramentas no Ubuntu 16.04Install tools on Ubuntu 16.04

Use as etapas a seguir para instalar o mssql-tools no Ubuntu.Use the following steps to install the mssql-tools on Ubuntu.

  1. Importe as chaves GPG do repositório público.Import the public repository GPG keys.

    curl https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add -
    
  2. Registre o repositório do Microsoft Ubuntu.Register the Microsoft Ubuntu repository.

    curl https://packages.microsoft.com/config/ubuntu/16.04/prod.list | sudo tee /etc/apt/sources.list.d/msprod.list
    
  3. Atualize a lista de fontes e execute o comando de instalação com o pacote do desenvolvedor do unixODBC.Update the sources list and run the installation command with the unixODBC developer package.

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

    Observação

    Para atualizar para a versão mais recente do mssql-tools, execute os seguintes comandos:To update to the latest version of mssql-tools run the following commands:

    sudo apt-get update 
    sudo apt-get install mssql-tools 
    
  4. Opcional: Adicione /opt/mssql-tools/bin/ à sua variável de ambiente PATH em um shell de Bash.Optional: Add /opt/mssql-tools/bin/ to your PATH environment variable in a bash shell.

    Para tornar o sqlcmd/bcp acessível do shell de Bash para sessões de logon, modifique o PATH no arquivo ~/.bash_profile com o seguinte comando:To make sqlcmd/bcp accessible from the bash shell for login sessions, modify your PATH in the ~/.bash_profile file with the following command:

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

    Para tornar o sqlcmd/bcp acessível do shell de Bash para sessões interativas/que não são de logon, modifique o PATH no arquivo ~/.bashrc com o seguinte comando:To make sqlcmd/bcp accessible from the bash shell for interactive/non-login sessions, modify the PATH in the ~/.bashrc file with the following command:

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

Instalar ferramentas no SLES 12Install tools on SLES 12

Use as seguintes etapas para instalar o mssql-tools no SUSE Linux Enterprise Server.Use the following steps to install the mssql-tools on SUSE Linux Enterprise Server.

  1. Adicione o repositório do Microsoft SQL Server ao Zypper.Add the Microsoft SQL Server repository to Zypper.

    sudo zypper addrepo -fc https://packages.microsoft.com/config/sles/12/prod.repo 
    sudo zypper --gpg-auto-import-keys refresh
    
  2. Instale o mssql-tools com o pacote do desenvolvedor unixODBC.Install mssql-tools with the unixODBC developer package.

    sudo zypper install mssql-tools unixODBC-devel
    

    Observação

    Para atualizar para a versão mais recente do mssql-tools, execute os seguintes comandos:To update to the latest version of mssql-tools run the following commands:

    sudo zypper refresh
    sudo zypper update mssql-tools
    
  3. Opcional: Adicione /opt/mssql-tools/bin/ à sua variável de ambiente PATH em um shell de Bash.Optional: Add /opt/mssql-tools/bin/ to your PATH environment variable in a bash shell.

    Para tornar o sqlcmd/bcp acessível do shell de Bash para sessões de logon, modifique o PATH no arquivo ~/.bash_profile com o seguinte comando:To make sqlcmd/bcp accessible from the bash shell for login sessions, modify your PATH in the ~/.bash_profile file with the following command:

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

    Para tornar o sqlcmd/bcp acessível do shell de Bash para sessões interativas/que não são de logon, modifique o PATH no arquivo ~/.bashrc com o seguinte comando:To make sqlcmd/bcp accessible from the bash shell for interactive/non-login sessions, modify the PATH in the ~/.bashrc file with the following command:

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

Instalar ferramentas no macOSInstall tools on macOS

Uma versão prévia do sqlcmd e do bcp está agora disponível no macOS.A preview of sqlcmd and bcp is now available on macOS. Para obter mais informações, confira o comunicado.For more information, see the announcement.

Instale o Homebrew se você ainda não o tiver:Install Homebrew if you don't have it already:

    /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Para instalar as ferramentas El Capitan e Sierra para Mac, use os seguintes comandos:To install the tools for Mac El Capitan and Sierra, use the following commands:

# 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-tools
#for silent install: 
#HOMEBREW_NO_ENV_FILTERING=1 ACCEPT_EULA=y brew install mssql-tools

DockerDocker

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.If you run SQL Server in a Docker container, the SQL Server command-line tools are already included in the SQL Server Linux container image. Se você anexar a um contêiner em execução com um shell Bash interativo, poderá executar as ferramentas localmente.If you attach to a running container with an interactive bash shell, you can run the tools locally.

Instalação offlineOffline installation

Se o computador Linux não tiver acesso aos repositórios online usados nas seções anteriores, você poderá baixar os arquivos de pacote diretamente.If your Linux machine does not have access to the online repositories used in the previous sections, you can download the package files directly. Esses pacotes estão localizados no repositório da Microsoft, https://packages.microsoft.com.These packages are located in the Microsoft repository, https://packages.microsoft.com.

Dica

Se você realizou a instalação com êxito seguindo as etapas nas seções anteriores, não será necessário baixar ou instalar manualmente os pacotes a seguir.If you successfully installed with the steps in the previous sections, you do not need to download or manually install the package(s) below. Isso vale apenas para o cenário offline.This is only for the offline scenario.

  1. Primeiro, localize e copie o pacote mssql-tools para sua distribuição do Linux:First, locate and copy the mssql-tools package for your Linux distribution:

    Distribuição do LinuxLinux distribution Localização do pacote mssql-toolsmssql-tools package location
    Red HatRed Hat https://packages.microsoft.com/rhel/7.3/prod
    SLESSLES https://packages.microsoft.com/sles/12/prod
    Ubuntu 16.04Ubuntu 16.04 https://packages.microsoft.com/ubuntu/16.04/prod/pool/main/m/mssql-tools
  2. Além disso, localize e copie o pacote msodbcsql, que é uma dependência.Also locate and copy the msodbcsql package, which is a dependency. O pacote msodbcsql também tem uma dependência em unixODBC-devel (Red Hat e SLES) ou unixodbc-dev (Ubuntu).The msodbcsql package also has a dependency on either unixODBC-devel (Red Hat and SLES) or unixodbc-dev (Ubuntu). A localização dos pacotes msodbcsql está listada na tabela a seguir:The location of the msodbcsql packages are listed in the following table:

    Distribuição do LinuxLinux distribution Localização dos pacotes ODBCODBC packages location
    Red HatRed Hat https://packages.microsoft.com/rhel/7.3/prod
    SLESSLES https://packages.microsoft.com/sles/12/prod
    Ubuntu 16.04Ubuntu 16.04 msodbcsqlmsodbcsql
    unixodbc-devunixodbc-dev
  3. Mova os pacotes baixados para o computador Linux.Move the downloaded packages to your Linux machine. Se você usou um computador diferente para baixar os pacotes, uma maneira de mover os pacotes para o computador Linux é com o comando scp.If you used a different machine to download the packages, one way to move the packages to your Linux machine is with the scp commmand.

  4. Instalar os pacotes mssql-tools e msodbc: Instale os pacotes mssql-tools e msodbc.Install the and packages: Install the mssql-tools and msodbc packages. Se você obtiver erros de dependência, ignore-os até a próxima etapa.If you get any dependency errors, ignore them until the next step.

    PlataformaPlatform Comandos de instalação de pacotePackage install commands
    Red HatRed Hat sudo yum localinstall msodbcsql-<version>.rpm
    sudo yum localinstall mssql-tools-<version>.rpm
    SLESSLES sudo zypper install msodbcsql-<version>.rpm
    sudo zypper install mssql-tools-<version>.rpm
    UbuntuUbuntu sudo dpkg -i msodbcsql_<version>.deb
    sudo dpkg -i mssql-tools_<version>.deb
  5. Resolver dependências ausentes: Você pode ter dependências ausentes neste momento.Resolve missing dependencies: You might have missing dependencies at this point. Caso contrário, você pode ignorar esta etapa.If not, you can skip this step. Em alguns casos, você deve localizar essas dependências manualmente e instalá-las.In some cases, you must manually locate and install these dependencies.

    Para pacotes RPM, você pode inspecionar as dependências necessárias com os seguintes comandos:For RPM packages, you can inspect the required dependencies with the following commands:

    rpm -qpR msodbcsql-<version>.rpm
    rpm -qpR mssql-tools-<version>.rpm
    

    Para pacotes Debian, se você tiver acesso a repositórios aprovados que contenham essas dependências, a solução mais fácil será usar o comando apt-get:For Debian packages, if you have access to approved repositories containing those dependencies, the easiest solution is to use the apt-get command:

    sudo apt-get -f install
    

    Observação

    Esse comando também conclui a instalação dos pacotes do SQL Server.This command completes the installation of the SQL Server packages as well.

    Se isso não funcionar para o pacote do Debian, você poderá inspecionar as dependências necessárias com os seguintes comandos:If this does not work for your Debian package, you can inspect the required dependencies with the following commands:

    dpkg -I msodbcsql_<version>_amd64.deb | grep "Depends:"
    dpkg -I mssql-tools_<version>_amd64.deb | grep "Depends:"
    

Próximas etapasNext steps

Para obter um exemplo de como usar o sqlcmd para se conectar ao SQL Server e criar um banco de dados, confira um dos seguintes inícios rápidos:For an example of how to use sqlcmd to connect to SQL Server and create a database, see one of the following quickstarts:

Para obter um exemplo de como usar o bcp para importar e exportar dados em massa, confira Copiar dados em massa para o SQL Server em Linux.For an example of how to use bcp to bulk import and export data, see Bulk copy data to SQL Server on Linux.