Instalación de las herramientas de línea de comandos sqlcmd y bcp de SQL Server en Linux

Artículo
12/26/2023

Se aplica a:SQL Server: Linux

En los pasos siguientes se instalan las herramientas de línea de comandos, los controladores ODBC de Microsoft y sus dependencias. El paquete mssql-tools contiene:

sqlcmd: utilidad de consulta de línea de comandos.
bcp: utilidad de importación y exportación masiva.

Instale las herramientas para su plataforma:

En este artículo se explica cómo instalar las herramientas línea de comandos. Si busca ejemplos de cómo utilizar sqlcmd o bcp, consulte Contenido relacionado al final de este artículo.

Importante

sqlcmd y bcp están disponibles en mssql-tools18 para x64 y arm64 arquitecturas. Para una alternativa moderna en Linux, macOS y Windows, véase go-sqlcmd utility.

Instalación de herramientas en Linux

Estas instrucciones son para instalar los paquetes ODBC 18 de Microsoft. Para versiones anteriores, consulte Instalar el controlador ODBC de Microsoft para SQL Server (Linux).

Siga estos pasos para instalar mssql-tools18 en Red Hat Enterprise Linux.

Descargue el archivo de configuración del repositorio de Red Hat de Microsoft.

Para Red Hat 9, usa el siguiente comando:

curl https://packages.microsoft.com/config/rhel/9/prod.repo | sudo tee /etc/yum.repos.d/mssql-release.repo

Para Red Hat 8, use el siguiente comando:

curl https://packages.microsoft.com/config/rhel/8/prod.repo | sudo tee /etc/yum.repos.d/mssql-release.repo

Para Red Hat 7, use el siguiente comando:

curl https://packages.microsoft.com/config/rhel/7/prod.repo | sudo tee /etc/yum.repos.d/mssql-release.repo

Si tiene instalada una versión anterior de mssql-tools, quite los paquetes unixODBC anteriores.
```
sudo yum remove mssql-tools unixODBC-utf16 unixODBC-utf16-devel
```
Ejecute los comandos siguientes para instalar mssql-tools18 con el paquete de desarrollador de unixODBC.
```
sudo yum install -y mssql-tools18 unixODBC-devel
```
Nota:

Para actualizar a la versión más reciente de mssql-tools, ejecute los siguientes comandos:
```
sudo yum check-update
sudo yum update mssql-tools18
```
Opcional: agregue /opt/mssql-tools18/bin/ a la variable de entorno PATH en un shell de Bash.

Para que sqlcmd y bcp sean accesibles desde el shell de Bash para inicios de sesión, modifique la variable PATH en el archivo ~/.bash_profile con el comando siguiente:
```
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bash_profile
```
Para que sqlcmd y bcp sean accesibles desde el intérprete de comandos bash para sesiones interactivas/no de inicio de sesión, modifica el PATH en el archivo ~/.bashrc con el siguiente comando:
```
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bashrc
source ~/.bashrc
```

Siga estos pasos para instalar mssql-tools18 en SUSE Linux Enterprise Server.

Importe la clave de firma de paquetes de Microsoft.

curl -O https://packages.microsoft.com/keys/microsoft.asc
sudo rpm --import microsoft.asc

Agregue el repositorio de SQL Server en Zypper.

Para SLES 15, utilice el siguiente comando:

sudo zypper ar https://packages.microsoft.com/config/sles/15/prod.repo

Para SLES 12, utilice el siguiente comando:

sudo zypper ar https://packages.microsoft.com/config/sles/12/prod.repo

Instale mssql-tools18 con el paquete de desarrollo unixODBC.
- Para SLES 15, utilice el siguiente comando:
```
sudo zypper install -y mssql-tools18 unixODBC-devel glibc-locale-base
```
- Para SLES 12, utilice el siguiente comando:
```
sudo zypper install -y mssql-tools18 unixODBC-devel
```
Nota:

Para actualizar a la última versión de mssql-tools18, ejecute los siguientes comandos:
```
sudo zypper refresh
sudo zypper update mssql-tools18
```
Opcional: agregue /opt/mssql-tools18/bin/ a la variable de entorno PATH en un shell de Bash.

Para que sqlcmd y bcp sean accesibles desde el intérprete de comandos bash para las sesiones de inicio de sesión, modifique su PATH en el archivo ~/.bash_profile con el siguiente comando:
```
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bash_profile
```
Para que sqlcmd o bcp sea accesible desde el shell de Bash para sesiones interactivas o que no sean de inicio de sesión, modifique PATH en el archivo ~/.bashrc con el comando siguiente:
```
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bashrc
source ~/.bashrc
```

Siga estos pasos para instalar mssql-tools18 en Ubuntu.

Nota:

Ubuntu 18.04 se admite a partir de SQL Server 2019 (15.x) CU 3.
Ubuntu 20.04 se admite a partir de SQL Server 2019(15.x) CU 10.

Importe las claves de GPG del repositorio público.

curl https://packages.microsoft.com/keys/microsoft.asc | sudo tee /etc/apt/trusted.gpg.d/microsoft.asc

Registre el repositorio de Ubuntu de Microsoft.

Para Ubuntu 22.04, utilice el siguiente comando:

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

Para Ubuntu 20.04, utilice el siguiente comando:

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

Para Ubuntu 18.04, utilice el siguiente comando:

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

Para Ubuntu 16.04, utilice el siguiente comando:

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

Actualice la lista de orígenes y ejecute el comando de instalación con el paquete para desarrolladores de unixODBC.
```
sudo apt-get update
sudo apt-get install mssql-tools18 unixodbc-dev
```
Nota:

Para actualizar a la versión más reciente de mssql-tools, ejecute los siguientes comandos:
```
sudo apt-get update  
sudo apt-get install mssql-tools18
```
Opcional: agregue /opt/mssql-tools18/bin/ a la variable de entorno PATH en un shell de Bash.

Para que sqlcmd y bcp sean accesibles desde el shell de Bash para inicios de sesión, modifique la variable PATH en el archivo ~/.bash_profile con el comando siguiente:
```
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bash_profile
```
Para que sqlcmd y bcp sean accesibles desde el intérprete de comandos bash para sesiones interactivas/no de inicio de sesión, modifica el PATH en el archivo ~/.bashrc con el siguiente comando:
```
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bashrc
source ~/.bashrc
```

Instalación de herramientas en macOS

Instale Homebrew si aún no lo tiene:

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

Para instalar las herramientas para macOS El Capitan y versiones posteriores, utilice los siguientes 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

Instalación de herramientas en Docker

Si ejecuta SQL Server en un contenedor de Docker, las herramientas de línea de comandos de SQL Server ya están incluidas en la imagen de contenedor de SQL Server para Linux. Si adjunta un contenedor en ejecución con un shell de Bash interactivo, puede ejecutar las herramientas de forma local.

Si está creando un contenedor con las herramientas de línea de comandos de SQL Server, debe añadir ACCEPT_EULA=Y al comando de instalación para aceptar silenciosamente el CLUF y no interrumpir la creación de la imagen. Un comando final de ejemplo como parte de la instalación en una imagen basada en Ubuntu es el siguiente:

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

Instalación sin conexión

Si su máquina Linux no tiene acceso a los repositorios en línea que se usan en las secciones anteriores, puede descargar los archivos de paquete directamente. Estos paquetes se encuentran en el repositorio de Microsoft, 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 siguientes paquetes. Esto es solo para el escenario sin conexión.

En primer lugar, busque y copie el paquete mssql-tools18 de su distribución de Linux. Para Red Hat 8.0, se encuentra en https://packages.microsoft.com/rhel/8/prod.
También busque y copie el paquete msodbcsql18, que es una dependencia. El paquete msodbcsql18 también depende de unixODBC-devel. Para Red Hat, el paquete msodbcsql18 se encuentra en https://packages.microsoft.com/rhel/8/prod.
Mueva los paquetes descargados a la máquina Linux. Si ha usado otro equipo para descargar los paquetes, una manera de trasladarlos al equipo Linux es con el comando scp.
Instale los paquetes y: Instale los paquetes mssql-tools18 y msodbc18. Si obtiene algún error de dependencia, ignórelo hasta el siguiente paso. Reemplace <version> por la versión correcta:
```
sudo yum localinstall msodbcsql18-<version>.rpm
sudo yum localinstall mssql-tools18-<version>.rpm
```
Resuelva las dependencias que faltan: Es posible que falten dependencias en este punto. Si no es así, puede omitir este paso. En algunos casos, debe localizar e instalar manualmente estas dependencias.

Puede inspeccionar las dependencias necesarias con los siguientes comandos. Reemplace <version> por la versión correcta:
```
rpm -qpR msodbcsql18-<version>.rpm
rpm -qpR mssql-tools18-<version>.rpm
```

En primer lugar, busque y copie el paquete mssql-tools18 de su distribución de Linux. Para SLES 15, se encuentra en https://packages.microsoft.com/sles/15/prod.
También busque y copie el paquete msodbcsql18, que es una dependencia. El paquete msodbcsql18 también depende de unixODBC-devel. Para SLES, el paquete msodbcsql18 se encuentra en https://packages.microsoft.com/sles/15/prod.
Mueva los paquetes descargados a la máquina Linux. Si ha usado otro equipo para descargar los paquetes, una manera de trasladarlos al equipo Linux es con el comando scp.
Instale los paquetes y: Instale los paquetes mssql-tools18 y msodbc18. Si obtiene algún error de dependencia, ignórelo hasta el siguiente paso. Reemplace <version> por la versión correcta:
```
sudo zypper install msodbcsql18-<version>.rpm
sudo zypper install mssql-tools18-<version>.rpm
```
Resuelva las dependencias que faltan: Es posible que falten dependencias en este punto. Si no es así, puede omitir este paso. En algunos casos, debe localizar e instalar manualmente estas dependencias.

Puede inspeccionar las dependencias necesarias con los siguientes comandos. Reemplace <version> por la versión correcta:
```
rpm -qpR msodbcsql18-<version>.rpm
rpm -qpR mssql-tools18-<version>.rpm
```

En primer lugar, busque y copie el paquete mssql-tools18 de su distribución de Linux. Para Ubuntu 20.04, se encuentra en https://packages.microsoft.com/ubuntu/20.04/prod/pool/main/m/mssql-tools
También busque y copie el paquete msodbcsql18, que es una dependencia. El paquete msodbcsql18 también depende de unixodbc-dev. En Ubuntu, los paquetes msodbcsql18 se encuentran en msodbcsql18, y unixodbc-dev.
Mueva los paquetes descargados a la máquina Linux. Si ha usado otro equipo para descargar los paquetes, una manera de trasladarlos al equipo Linux es con el comando scp.
Instale los paquetes y: Instale los paquetes mssql-tools18 y msodbc18. Si obtiene algún error de dependencia, ignórelo hasta el siguiente paso. Reemplace <version> por la versión correcta:
```
sudo dpkg -i msodbcsql18_<version>.deb
sudo dpkg -i mssql-tools18_<version>.deb
```
Resuelva las dependencias que faltan: Es posible que falten dependencias en este punto. Si no es así, puede omitir este paso. En algunos casos, debe localizar e instalar manualmente estas dependencias.

Si tiene acceso a los repositorios aprobados que contienen esas dependencias, la solución más sencilla es usar el comando apt-get:
```
sudo apt-get -f install
```
Nota:

Este comando completa también la instalación de los paquetes de SQL Server.

Si esto no funciona con su paquete de Debian, puede inspeccionar las dependencias necesarias con los siguientes comandos:
```
dpkg -I msodbcsql18_<version>_amd64.deb | grep "Depends:"
dpkg -I mssql-tools18_<version>_amd64.deb | grep "Depends:"
```

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:

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.

Contribuya a la documentación de SQL

¿Sabía que puede editar el contenido de SQL usted mismo? Si lo hace, no solo contribuirá a mejorar la documentación, sino que también se le reconocerá como colaborador de la página.

Para más información, vea Cómo colaborar en la documentación de SQL Server.