Instalación de las herramientas de línea de comandos sqlcmd y bcp de SQL Server en LinuxInstall sqlcmd and bcp the SQL Server command-line tools on Linux

SE APLICA A: síSQL Server (solo en Linux) noAzure SQL Database noAzure SQL Data Warehouse noAlmacenamiento de datos paralelos APPLIES TO: yesSQL Server (Linux only) noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

En los pasos siguientes se instalan las herramientas de línea de comandos, los controladores ODBC de Microsoft y sus dependencias.The following steps install the command-line tools, Microsoft ODBC drivers, and their dependencies. El paquete mssql-tools contiene:The mssql-tools package contains:

  • sqlcmd: utilidad de consulta de línea de comandos.sqlcmd: Command-line query utility.
  • bcp: utilidad de importación y exportación masiva.bcp: Bulk import-export utility.

Instale las herramientas para su plataforma:Install the tools for your platform:

En este artículo se explica cómo instalar las herramientas línea de comandos.This article describes how to install the command-line tools. Si busca ejemplos de cómo usar sqlcmd o bcp, vea los vínculos al final de este tema.If you are looking for examples of how to use sqlcmd or bcp, see the links at the end of this topic.

Instalación de herramientas en RHEL 7Install tools on RHEL 7

Use los pasos siguientes para instalar mssql-tools en Red Hat Enterprise Linux.Use the following steps to install the mssql-tools on Red Hat Enterprise Linux.

  1. Acceda al modo de superusuario.Enter superuser mode.

    sudo su
    
  2. Descargue el archivo de configuración del repositorio de Red Hat de 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. Salga del modo de superusuario.Exit superuser mode.

    exit
    
  4. Si tiene instalada una versión anterior de mssql-tools, quite los paquetes unixODBC anteriores.If you had a previous version of mssql-tools installed, remove any older unixODBC packages.

    sudo yum remove mssql-tools unixODBC-utf16-devel
    
  5. Ejecute los comandos siguientes para instalar mssql-tools con el paquete de desarrollador de unixODBC.Run the following commands to install mssql-tools with the unixODBC developer package.

    sudo yum install mssql-tools unixODBC-devel
    

    Nota

    Para actualizar a la versión más reciente de mssql-tools, ejecute los siguientes 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: agregue /opt/mssql-tools/bin/ a la variable de entorno PATH en un shell de Bash.Optional: Add /opt/mssql-tools/bin/ to your PATH environment variable in a bash shell.

    Para que sqlcmd/bcp sea accesible desde el shell de Bash para inicios de sesión, modifique la variable PATH en el archivo ~/.bash_profile con el comando siguiente: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 que sqlcmd/bcp sea accesible desde el shell de Bash para sesiones interactivas o que no sean de inicio de sesión, modifique la variable PATH en el archivo ~/.bashrc con el comando siguiente: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
    

Instalación de herramientas en Ubuntu 16.04Install tools on Ubuntu 16.04

Siga estos pasos para instalar mssql-tools en Ubuntu.Use the following steps to install the mssql-tools on Ubuntu.

  1. Importe las claves de GPG del repositorio público.Import the public repository GPG keys.

    curl https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add -
    
  2. Registre el repositorio de Ubuntu de Microsoft.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. Actualice la lista de orígenes y ejecute el comando de instalación con el paquete para desarrolladores de 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
    

    Nota

    Para actualizar a la versión más reciente de mssql-tools, ejecute los siguientes 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: agregue /opt/mssql-tools/bin/ a la variable de entorno PATH en un shell de Bash.Optional: Add /opt/mssql-tools/bin/ to your PATH environment variable in a bash shell.

    Para que sqlcmd/bcp sea accesible desde el shell de Bash para inicios de sesión, modifique la variable PATH en el archivo ~/.bash_profile con el comando siguiente: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 que sqlcmd/bcp sea accesible desde el shell de Bash para sesiones interactivas o que no sean de inicio de sesión, modifique la variable PATH en el archivo ~/.bashrc con el comando siguiente: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
    

Instalación de herramientas en SLES 12Install tools on SLES 12

Use los pasos siguientes para instalar mssql-tools en SUSE Linux Enterprise Server.Use the following steps to install the mssql-tools on SUSE Linux Enterprise Server.

  1. Agregue el repositorio de Microsoft SQL Server en 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 mssql-tools con el paquete de desarrollador de unixODBC.Install mssql-tools with the unixODBC developer package.

    sudo zypper install mssql-tools unixODBC-devel
    

    Nota

    Para actualizar a la versión más reciente de mssql-tools, ejecute los siguientes comandos:To update to the latest version of mssql-tools run the following commands:

    sudo zypper refresh
    sudo zypper update mssql-tools
    
  3. Opcional: agregue /opt/mssql-tools/bin/ a la variable de entorno PATH en un shell de Bash.Optional: Add /opt/mssql-tools/bin/ to your PATH environment variable in a bash shell.

    Para que sqlcmd/bcp sea accesible desde el shell de Bash para inicios de sesión, modifique la variable PATH en el archivo ~/.bash_profile con el comando siguiente: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 que sqlcmd/bcp sea accesible desde el shell de Bash para sesiones interactivas o que no sean de inicio de sesión, modifique la variable PATH en el archivo ~/.bashrc con el comando siguiente: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
    

Instalación de herramientas en macOSInstall tools on macOS

Ahora hay disponible una versión preliminar de sqlcmd y bcp en MacOS.A preview of sqlcmd and bcp is now available on macOS. Para obtener más información, consulte el anuncio.For more information, see the announcement.

Instale Homebrew si aún no lo tiene: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 las herramientas para Mac El Capitan y Sierra, use los comandos siguientes: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

Las herramientas de línea de comandos de SQL Server se incluyen en la imagen de Docker.The SQL Server command-line tools are included in the Docker image. Si se asocia a la imagen con un símbolo del sistema interactivo, puede ejecutar las herramientas de forma local.If you attach to the image with an interactive command-prompt, you can run the tools locally.

Instalación sin conexiónOffline installation

Si su equipo Linux no tiene acceso a los repositorios en línea que se usan en las secciones anteriores, puede descargar los archivos de paquete directamente.If your Linux machine does not have access to the online repositories used in the previous sections, you can download the package files directly. Estos paquetes se encuentran en el repositorio de Microsoft, https://packages.microsoft.com.These packages are located in the Microsoft repository, https://packages.microsoft.com.

Sugerencia

Si los ha instalado correctamente mediante los pasos descritos en las secciones anteriores, no tiene que descargar o instalar manualmente los paquetes siguientes.If you successfully installed with the steps in the previous sections, you do not need to download or manually install the package(s) below. Esto es solo para el escenario sin conexión.This is only for the offline scenario.

  1. En primer lugar, busque y copie el paquete mssql-tools para su distribución de Linux:First, locate and copy the mssql-tools package for your Linux distribution:

    Distribución de LinuxLinux distribution Ubicación del paquete 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. Busque y copie también el paquete msodbcsql, que es una dependencia.Also locate and copy the msodbcsql package, which is a dependency. El paquete msodbcsql también depende de unixODBC-devel (Red Hat y SLES) o unixodbc-dev (Ubuntu).The msodbcsql package also has a dependency on either unixODBC-devel (Red Hat and SLES) or unixodbc-dev (Ubuntu). La ubicación de los paquetes msodbcsql se muestra en la tabla siguiente:The location of the msodbcsql packages are listed in the following table:

    Distribución de LinuxLinux distribution Ubicación de paquetes 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. Mueva los paquetes descargados a la máquina Linux.Move the downloaded packages to your Linux machine. Si ha usado otra máquina para descargar los paquetes, una manera de trasladarlos a la máquina Linux es con el 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. Instale los paquetes: Instale los paquetes mssql-toolds y msodbc.Install the and packages: Install the mssql-tools and msodbc packages. Si obtiene algún error de dependencia, ignórelo hasta el siguiente paso.If you get any dependency errors, ignore them until the next step.

    PlataformaPlatform Comandos de instalación de paquetesPackage 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. Resuelva las dependencias que faltan : Es posible que falten dependencias en este punto.Resolve missing dependencies: You might have missing dependencies at this point. Si no es así, puede omitir este paso.If not, you can skip this step. En algunos casos, debe localizar e instalar manualmente estas dependencias.In some cases, you must manually locate and install these dependencies.

    En el caso de paquetes RPM, puede inspeccionar las dependencias necesarias con los siguientes 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
    

    En el caso de paquetes de Debian, si tiene acceso a los repositorios aprobados que contienen dichas dependencias, la solución más sencilla es usar el 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
    

    Nota

    Este comando completa también la instalación de los paquetes de SQL Server.This command completes the installation of the SQL Server packages as well.

    Si esto no funciona con su paquete de Debian, puede inspeccionar las dependencias necesarias con los siguientes 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:"
    

Pasos siguientesNext steps

Para obtener un ejemplo de cómo usar sqlcmd para conectarse a SQL Server y crear una base de datos, consulte una de las siguientes guías de inicio rápido:For an example of how to use sqlcmd to connect to SQL Server and create a database, see one of the following quickstarts:

Para obtener un ejemplo de cómo usar bcp para importar y exportar datos de forma masiva, consulte Copia masiva de datos a SQL Server en Linux.For an example of how to use bcp to bulk import and export data, see Bulk copy data to SQL Server on Linux.