Cómo instalar sqlcmd en Ubuntu 24.04 y agregarlo a bashrc y zshrc

Si trabajás con Microsoft SQL Server desde Linux, la herramienta oficial de línea de comandos sqlcmd (mssql-tools18) es indispensable para ejecutar consultas, scripts y administrar bases de datos directamente desde la terminal.

En esta guía te muestro cómo instalar sqlcmd en Ubuntu 24.04 LTS (Noble Numbat) y cómo dejar configurado el PATH tanto en Bash como en Zsh para que podás invocar el comando desde cualquier lugar.

Versión rápida (TL;DR)

Si querés ir directo al grano, copiá y ejecutá el siguiente bloque de comandos:

# 1. Importar la clave GPG oficial de Microsoft
curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /usr/share/keyrings/microsoft-prod.gpg

# 2. Registrar el repositorio de Microsoft para Ubuntu 24.04
curl -fsSL https://packages.microsoft.com/config/ubuntu/24.04/prod.list | sudo tee /etc/apt/sources.list.d/mssql-release.list

# 3. Actualizar paquetes e instalar mssql-tools18 y unixodbc-dev (aceptando EULA)
sudo apt-get update
sudo ACCEPT_EULA=Y apt-get install -y mssql-tools18 unixodbc-dev

# 4. Agregar sqlcmd al PATH de Bash
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bashrc
source ~/.bashrc

# 5. Agregar sqlcmd al PATH de Zsh
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.zshrc
source ~/.zshrc

# 6. Comprobar que sqlcmd funciona correctamente
sqlcmd -?

Guía detallada paso a paso

Paso 1: Importar la clave GPG de Microsoft

Lo primero es agregar la clave GPG oficial de Microsoft para validar los paquetes del repositorio:

curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /usr/share/keyrings/microsoft-prod.gpg

Paso 2: Registrar el repositorio de Microsoft para Ubuntu 24.04

Descargamos e incluimos la lista de fuentes oficial correspondiente a Ubuntu 24.04:

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

Paso 3: Instalar `mssql-tools18` y `unixodbc-dev`

Actualizamos el índice de paquetes e instalamos el paquete mssql-tools18 junto con sus dependencias ODBC, aceptando la licencia EULA durante la instalación:

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

Paso 4: Agregar `sqlcmd` al PATH en `~/.bashrc` y `~/.zshrc`

Por defecto, los binarios de Microsoft se instalan en /opt/mssql-tools18/bin. Para no tener que escribir la ruta completa cada vez, agregamos el directorio a las variables de entorno de tu shell.

Para Bash (`~/.bashrc`):

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

Para Zsh (`~/.zshrc`):

Si usás Zsh (por ejemplo con Oh My Zsh), ejecutá:

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

Paso 5: Verificar la instalación

Para comprobar que sqlcmd quedó bien instalado y accesible globalmente, ejecutá:

sqlcmd -?

Si querés probar la conexión a una instancia local o remota de SQL Server:

sqlcmd -S localhost -U sa -P 'TuPassword' -Q "SELECT @@VERSION"

¡Listo! Ya tenés sqlcmd perfectamente integrado en tu terminal Ubuntu 24.04.