Instalación de Microsoft ODBC Driver for SQL Server (Linux)

En este artículo se explica cómo instalar Microsoft ODBC Driver for SQL Server en Linux. También se incluyen instrucciones para las herramientas de línea de comandos opcionales para SQL Server (bcp y sqlcmd), y los encabezados de desarrollo de unixODBC.

En este artículo se proporcionan comandos para instalar el controlador ODBC desde el shell de Bash. Si desea descargar los paquetes directamente, consulte Descargar ODBC Driver for SQL Server.

Elige una versión del controlador

Utilice el controlador 18 para nuevas aplicaciones. El controlador 17 sigue siendo compatible con aplicaciones que requieren comportamiento de versión 17. Antes de actualizar una aplicación del controlador 17 al controlador 18, revise las principales diferencias de versión, incluido el cambio a los valores predeterminados de cifrado. Para conocer las fechas de soporte, consulte el ciclo de vida del soporte.

La siguiente tabla muestra los paquetes de controladores y herramientas de línea de comandos:

Versión Paquete de controladores Paquete de herramientas opcional Ruta de herramientas
18 msodbcsql18 mssql-tools18 /opt/mssql-tools18/bin
17 msodbcsql17 mssql-tools /opt/mssql-tools/bin

Microsoft ODBC 18

En las secciones siguientes se explica cómo instalar Microsoft ODBC Driver 18 desde el shell de Bash para diferentes distribuciones de Linux. Las distribuciones admitidas son Alpine Linux, Debian, Red Hat Enterprise Linux (RHEL), Oracle Linux, SUSE Linux Enterprise Server (SLES), Ubuntu y Azure Linux. A partir de la versión 18.4, para aceptar automáticamente el Acuerdo de Licencia End-User (EULA) al instalar el controlador no Alpine Linux (.deb o .rpm), puede crear el archivo /opt/microsoft/msodbcsql18/ACCEPT_EULA.

set -euo pipefail

case $(uname -m) in
    x86_64) architecture="amd64" ;;
    aarch64|arm64) architecture="arm64" ;;
    *) architecture="unsupported" ;;
esac
if [[ "unsupported" == "$architecture" ]];
then
    echo "Alpine architecture $(uname -m) is not currently supported."
    exit 1
fi

if ! command -v gpg >/dev/null 2>&1; then
    echo "Install gnupg before running this block."
    exit 1
fi

driver_package="msodbcsql18_18.7.1.1-1_${architecture}.apk"
tools_package="mssql-tools18_18.7.1.1-1_${architecture}.apk"
driver_signature="${driver_package%.apk}.sig"
tools_signature="${tools_package%.apk}.sig"

# Download the packages and signatures.
curl -fSLO "https://download.microsoft.com/download/ade174b7-8cea-4543-91a6-c33ae320c2f0/$driver_package"
curl -fSLO "https://download.microsoft.com/download/a5dcc5e7-6124-49d3-8df4-48d738a0e784/$tools_package"
curl -fSLO "https://download.microsoft.com/download/ade174b7-8cea-4543-91a6-c33ae320c2f0/$driver_signature"
curl -fSLO "https://download.microsoft.com/download/a5dcc5e7-6124-49d3-8df4-48d738a0e784/$tools_signature"
curl -fSL https://packages.microsoft.com/keys/microsoft.asc -o microsoft.asc

# Verify the package signatures before installation.
gpg --import microsoft.asc
gpg --verify "$driver_signature" "$driver_package"
gpg --verify "$tools_signature" "$tools_package"

# Install the packages.
sudo apk add --allow-untrusted "$driver_package"
sudo apk add --allow-untrusted "$tools_package"

Nota

El controlador 17.5 y versiones posteriores soportan Alpine.

Microsoft ODBC 17

En las secciones siguientes se explica cómo instalar el controlador ODBC 17 de Microsoft desde el shell de Bash para diferentes distribuciones de Linux.

Importante

Si instaló el paquete v17 msodbcsql que estaba disponible brevemente, quítelo antes de instalar el paquete msodbcsql17 para evitar conflictos. Puede instalar el msodbcsql17 paquete en paralelo con el msodbcsql paquete v13.

set -euo pipefail

if [[ "$(uname -m)" != "x86_64" ]]; then
    echo "Driver 17 Alpine packages are available only for x86_64." >&2
    exit 1
fi

if ! command -v gpg >/dev/null 2>&1; then
    echo "Install gnupg before running this block."
    exit 1
fi

driver_package="msodbcsql17_17.11.1.1-1_amd64.apk"
tools_package="mssql-tools_17.11.1.1-1_amd64.apk"
driver_signature="${driver_package%.apk}.sig"
tools_signature="${tools_package%.apk}.sig"

# Download the packages and signatures.
curl -fSLO "https://download.microsoft.com/download/607ebe2c-e17c-4c34-b367-10a75b83bef9/$driver_package"
curl -fSLO "https://download.microsoft.com/download/aca0282f-6a67-49c0-ae08-887d59d16d1a/$tools_package"
curl -fSLO "https://download.microsoft.com/download/607ebe2c-e17c-4c34-b367-10a75b83bef9/$driver_signature"
curl -fSLO "https://download.microsoft.com/download/aca0282f-6a67-49c0-ae08-887d59d16d1a/$tools_signature"
curl -fSL https://packages.microsoft.com/keys/microsoft.asc -o microsoft.asc

# Verify the package signatures before installation.
gpg --import microsoft.asc
gpg --verify "$driver_signature" "$driver_package"
gpg --verify "$tools_signature" "$tools_package"

# Install the packages.
sudo apk add --allow-untrusted "$driver_package"
sudo apk add --allow-untrusted "$tools_package"

Nota

El controlador 17.5 y versiones posteriores soportan Alpine.

Actualizar o verificar la instalación de un controlador

Para actualizar un controlador que instalaste desde un repositorio de paquetes de Linux, actualice los metadatos del paquete y actualice el paquete para la misma versión principal. Para distribuciones con instrucciones de instalación del controlador 17 en este artículo, sustituye msodbcsql18 por msodbcsql17 para actualizar el controlador 17. Los comandos de Azure Linux se aplican al controlador 18. Para moverse entre versiones principales, instale el otro paquete y configure su aplicación para solicitar el nombre del controlador.

Distribución Comando de Actualización
Debian o Ubuntu sudo apt-get update && sudo ACCEPT_EULA=Y apt-get install --only-upgrade -y msodbcsql18
Red Hat Enterprise Linux o Oracle Linux sudo ACCEPT_EULA=Y yum update -y msodbcsql18
SUSE Linux Enterprise Server sudo zypper refresh && sudo ACCEPT_EULA=Y zypper update -y msodbcsql18
Azure Linux sudo ACCEPT_EULA=Y tdnf upgrade -y msodbcsql18

Para Alpine, descarga e instala el APK actualizado para la versión principal instalada y la arquitectura del sistema. El controlador 18 soporta los paquetes amd64 y arm64 mostrados en las instrucciones de instalación. El controlador 17 utiliza el amd64 paquete:

Los comandos de actualización requieren curl y gpg. Si falta alguna, instálalas con sudo apk add curl gnupg.

set -e
case "$(uname -m)" in
    x86_64) architecture="amd64" ;;
    aarch64|arm64) architecture="arm64" ;;
    *) echo "Unsupported Alpine architecture: $(uname -m)" >&2; exit 1 ;;
esac

driver_apk="msodbcsql18_18.7.1.1-1_${architecture}.apk"
curl -fSL -O "https://download.microsoft.com/download/ade174b7-8cea-4543-91a6-c33ae320c2f0/$driver_apk"
curl -fSL -o "$driver_apk.sig" "https://download.microsoft.com/download/ade174b7-8cea-4543-91a6-c33ae320c2f0/${driver_apk%.apk}.sig"
curl -fSL https://packages.microsoft.com/keys/microsoft.asc -o microsoft.asc
gpg --import microsoft.asc
gpg --verify "$driver_apk.sig" "$driver_apk"
sudo apk add --allow-untrusted "$driver_apk"
rm "$driver_apk" "$driver_apk.sig" microsoft.asc

Para el controlador 17, descargue e instale el amd64 paquete:

set -e
if [[ "$(uname -m)" != "x86_64" ]]; then
    echo "Driver 17 Alpine packages are available only for x86_64." >&2
    exit 1
fi

driver_apk="msodbcsql17_17.11.1.1-1_amd64.apk"
curl -fSL -O "https://download.microsoft.com/download/607ebe2c-e17c-4c34-b367-10a75b83bef9/$driver_apk"
curl -fSL -o "$driver_apk.sig" "https://download.microsoft.com/download/607ebe2c-e17c-4c34-b367-10a75b83bef9/${driver_apk%.apk}.sig"
curl -fSL https://packages.microsoft.com/keys/microsoft.asc -o microsoft.asc
gpg --import microsoft.asc
gpg --verify "$driver_apk.sig" "$driver_apk"
sudo apk add --allow-untrusted "$driver_apk"
rm "$driver_apk" "$driver_apk.sig" microsoft.asc

Después de instalar o actualizar un controlador, establece driver_version en 17 o 18, y luego comprueba su registro en unixODBC y su arquitectura del sistema:

Versión del controlador driver_package driver_name
18 msodbcsql18 ODBC Driver 18 for SQL Server
17 msodbcsql17 ODBC Driver 17 for SQL Server
set -e
driver_version=18
driver_package="msodbcsql${driver_version}"
driver_name="ODBC Driver ${driver_version} for SQL Server"

odbcinst -q -d -n "$driver_name"
uname -m

La consulta de registro imprime el nombre del controlador entre corchetes. uname -m Informa de la arquitectura del sistema. Utilice la consulta de paquete de su distribución para comprobar la versión y arquitectura del paquete instalado:

Distribución Consulta de paquetes
Debian o Ubuntu dpkg-query -W -f='${Package} ${Version} ${Architecture}\n' "$driver_package"
Red Hat Enterprise Linux, Oracle Linux, SUSE Linux Enterprise Server o Azure Linux rpm -q --qf '%{NAME} %{VERSION}-%{RELEASE} %{ARCH}\n' "$driver_package"
Alpine awk -v package="$driver_package" 'index($0, "P:") == 1 { name = substr($0, 3) } name == package && index($0, "V:") == 1 { version = substr($0, 3) } name == package && index($0, "A:") == 1 { printf "%s %s %s\n", name, version, substr($0, 3); found = 1 } END { if (!found) exit 1 }' /lib/apk/db/installed

La consulta del paquete devuelve el nombre del paquete, la versión instalada y la arquitectura del paquete. Estos comandos no se conectan a una base de datos.

Quite o vuelva a instalar Driver 17 o Driver 18

Cierre las aplicaciones que usen el controlador antes de eliminarlo. Para distribuciones con instrucciones de instalación del controlador 17 en este artículo, sustituye msodbcsql18 por msodbcsql17 para eliminar el controlador 17. El comando Azure Linux se aplica al controlador 18.

Distribución Comando de eliminación
Debian o Ubuntu sudo apt-get remove msodbcsql18
Red Hat Enterprise Linux o Oracle Linux sudo yum remove msodbcsql18
SUSE Linux Enterprise Server sudo zypper remove msodbcsql18
Azure Linux sudo tdnf remove msodbcsql18
Alpine sudo apk add unixodbc && sudo apk del msodbcsql18

También se podrían eliminar aplicaciones o herramientas dependientes. Si tu gestor de paquetes te pide confirmación, revisa las eliminaciones propuestas antes de aceptarlas. En las versiones de Red Hat Enterprise Linux y Oracle Linux donde yum se usa DNF, añade --setopt=clean_requirements_on_remove=0 al comando de eliminación para conservar unixODBC en la comprobación de registro. Para el controlador 17, sustituya msodbcsql18 por msodbcsql17.

En Alpine, instala unixODBC explícitamente antes de eliminar el controlador para que odbcinst permanezca disponible para la comprobación de registro. apk del Conserva el controlador si las herramientas instaladas aún dependen de él. Si instalaste las herramientas opcionales, sustituye el comando Alpine en la tabla anterior por:

sudo apk add unixodbc
sudo apk del mssql-tools18 msodbcsql18

Para el controlador 17, use sudo apk add unixodbc seguido de sudo apk del mssql-tools msodbcsql17. Revise las aplicaciones dependientes antes de eliminar estos paquetes y, a continuación, repita la consulta de registro.

Tras retirarla, ejecuta odbcinst -q -d. Si muestra nombres de controladores, confirma que el nombre del controlador eliminado no aparezca en la lista. Si informa SQLGetPrivateProfileString failed, ejecuta odbcinst -j y comprueba la ruta DRIVERS que informa. Si el archivo de configuración de controladores existe, es legible y no contiene registros de controladores, no quedan controladores registrados. Si el archivo falta, es ilegible o aún contiene la entrada del controlador eliminado, resuelve ese problema de configuración antes de considerar la eliminación como completada. Para reinstalar, repita los comandos de instalación para la misma distribución y versión principal, luego repita la verificación.

Eliminar un controlador puede impedir que las aplicaciones que solicitan su nombre de controlador se conecten. No elimine archivos de controladores ni el archivo de configuración del administrador de controladores. Si un registro obsoleto bloquea la instalación, consulte Conflicto de versión anterior del controlador para los pasos de recuperación específicos.

Versiones anteriores

Las siguientes secciones proporcionan instrucciones de instalación para versiones anteriores del controlador ODBC de Microsoft:

ODBC 13.1

En las secciones siguientes se explica cómo instalar Microsoft ODBC Driver 13.1 desde el shell de Bash para diferentes distribuciones de Linux.

debian_version=$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)
case "$debian_version" in
    8) ;;
    *) echo "Debian $debian_version is not currently supported." >&2; exit 1 ;;
esac

# Download the package to configure the Microsoft repo
curl -fsSLO "https://packages.microsoft.com/config/debian/$debian_version/packages-microsoft-prod.deb" || exit 1
# Install the package
sudo dpkg -i packages-microsoft-prod.deb
# Delete the file
rm packages-microsoft-prod.deb

sudo apt-get update
sudo ACCEPT_EULA=Y apt-get install msodbcsql
# optional: for bcp and sqlcmd
sudo ACCEPT_EULA=Y apt-get install mssql-tools
echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
source ~/.bashrc
# optional: for unixODBC development headers
sudo apt-get install unixodbc-dev

ODBC 13

En las secciones siguientes se explica cómo instalar Microsoft ODBC Driver 13 desde el shell de Bash para diferentes distribuciones de Linux.

rhel_version=$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)
case "$rhel_version" in
    6|7) ;;
    *) echo "RHEL $rhel_version is not currently supported." >&2; exit 1 ;;
esac

# Download the package to configure the Microsoft repo
curl -fsSLO "https://packages.microsoft.com/config/rhel/$rhel_version/packages-microsoft-prod.rpm" || exit 1
# Install the package
sudo yum install packages-microsoft-prod.rpm
# Delete the file
rm packages-microsoft-prod.rpm

sudo yum update
sudo yum remove unixODBC #to avoid conflicts
sudo ACCEPT_EULA=Y yum install msodbcsql-13.0.1.0-1 mssql-tools-14.0.2.0-1
sudo yum install unixODBC-utf16-devel #this step is optional but recommended*
#Create symlinks for tools
sudo ln -sfn /opt/mssql-tools/bin/sqlcmd-13.0.1.0 /usr/bin/sqlcmd
sudo ln -sfn /opt/mssql-tools/bin/bcp-13.0.1.0 /usr/bin/bcp

Instalación sin conexión para ODBC 13

Para instalar el controlador ODBC 13 de Microsoft sin conexión a Internet, resuelva manualmente estas dependencias directas de paquetes:

  • Ubuntu: libc6 (>= 2.21), libstdc++6 (>= 4.9), libkrb5-3, libcurl3, openssldebconf (>= 0.5), unixODBC (>= 2.3.1-1)
  • Red Hat: glibc, e2fsprogs, krb5-libs, , openssl, unixODBC
  • SUSE: glibc, libuuid1, krb5, openssl, unixODBC

Cada paquete tiene sus propias dependencias. Para orientación sobre el gestor de paquetes, consulta la documentación de Red Hat, Ubuntu y SUSE.

Puede descargar manualmente todos los paquetes dependientes y colocarlos juntos en el equipo de instalación. A continuación, instale manualmente cada paquete a su vez, terminando con el paquete Microsoft ODBC Driver 13.

sudo yum install glibc e2fsprogs krb5-libs openssl unixODBC unixODBC-devel #install dependencies
sudo rpm -i  msodbcsql-13.1.X.X-X.x86_64.rpm #install the Driver

ODBC 11

En las secciones siguientes se explica cómo instalar Microsoft ODBC Driver 11 en Linux. Para poder utilizar el controlador, instale el Administrador de controladores unixODBC. Para obtener más información, consulte Instalación del Administrador de controladores.

Instalar Driver 11

Importante

Usa el archivo que coincida con tu distribución: Red Hat Linux usa msodbcsql-11.0.2270.0.tar.gz, y SUSE Linux usa msodbcsql-11.0.2260.0.tar.gz.

Para instalar el controlador, haga lo siguiente:

  1. Confirme que tiene privilegios de root.

  2. Descargue el controlador.

    Distribución Driver Hash de SHA256
    Red Hat 5 msodbcsql-11.0.2270.0.tar.gz 178280daf01a49b8322cd902b6440979adacd594c01cd2a1f081dda23dbfb343
    Red Hat 6 msodbcsql-11.0.2270.0.tar.gz e9b6bd33d174c7753b3a3f2d541713fbc156b46254484a169caa3f459dd828f7
    SUSE Linux msodbcsql-11.0.2260.0.tar.gz 86d1c5842be4f0095234a9455e18a04fdf4cc7960ec0255b37258112e2391ef5
  3. Cambia al directorio donde descargaste el archivo comprimido. Para extraer el paquete de Red Hat, ejecute:

    tar xvzf msodbcsql-11.0.2270.0.tar.gz
    

    Para extraer el paquete SUSE, ejecute:

    tar xvzf msodbcsql-11.0.2260.0.tar.gz
    
  4. Cambia al directorio extraído que coincida con la versión de tu archivo comprimido. Debería ver un archivo denominado install.sh.

  5. Para ver una lista de las opciones de instalación disponibles, ejecute el siguiente comando:

    ./install.sh
    
  6. Realice una copia de seguridad de odbcinst.ini. La instalación del controlador actualiza odbcinst.ini. odbcinst.ini contiene la lista de controladores que están registrados en el Administrador de controladores unixODBC. Para detectar la ubicación de odbcinst.ini en el equipo, ejecute el siguiente comando:

    odbc_config --odbcinstini
    
  7. Antes de instalar el controlador, ejecute el siguiente comando:

    ./install.sh verify
    

    La salida de ./install.sh verify notifica si el equipo tiene el software necesario para admitir el controlador ODBC en Linux.

  8. Cuando esté listo para instalar el controlador ODBC en Linux, ejecute el comando :

    ./install.sh install
    

    Para establecer directorios binarios o de biblioteca no predeterminados, pase --bin-dir=<directory> o --lib-dir=<directory> después de la opción install.

  9. Después de revisar el contrato de licencia, escriba YES para continuar con la instalación.

La biblioteca de controladores está instalada en /opt/microsoft/msodbcsql/lib64. Red Hat instala la versión 11.0.2270.0 y SUSE instala la versión 11.0.2260.0. Los archivos de soporte de cada versión se instalan en su directorio correspondiente bajo /opt/microsoft/msodbcsql. El paquete también instala las utilidades versionadas sqlcmd y bcp en /opt/microsoft/msodbcsql/bin y crea enlaces en /usr/bin de forma predeterminada. Si utilizaste la --lib-dir opción o --bin-dir , sustituye los caminos que especificaste.

Para comprobar que el controlador ODBC de Microsoft en Linux se registró correctamente, ejecute el siguiente comando:

odbcinst -q -d -n "ODBC Driver 11 for SQL Server"

Desinstalación

Desinstale el controlador ODBC 11 en Linux mediante la ejecución de los siguientes comandos:

Caution

Estos comandos eliminan las bibliotecas, utilidades y archivos de soporte del controlador 11 para las dos versiones de paquete listadas. Revisa los caminos antes de ejecutarlos. Si utilizaste la opción --lib-dir o --bin-dir, sustituye las rutas que especificaste.

set -e
odbcinst -u -d -n "ODBC Driver 11 for SQL Server"
for tool in bcp sqlcmd; do
    link="/usr/bin/$tool"
    if [ -L "$link" ]; then
        target=$(readlink "$link")
        case "$target" in
            "/opt/microsoft/msodbcsql/bin/$tool-11.0.2270.0"|"/opt/microsoft/msodbcsql/bin/$tool-11.0.2260.0")
                rm "$link"
                ;;
        esac
    fi
done
rm -f /opt/microsoft/msodbcsql/lib64/libmsodbcsql-11.0.so.2270.0 \
    /opt/microsoft/msodbcsql/lib64/libmsodbcsql-11.0.so.2260.0 \
    /opt/microsoft/msodbcsql/bin/bcp-11.0.2270.0 \
    /opt/microsoft/msodbcsql/bin/bcp-11.0.2260.0 \
    /opt/microsoft/msodbcsql/bin/sqlcmd-11.0.2270.0 \
    /opt/microsoft/msodbcsql/bin/sqlcmd-11.0.2260.0
rm -rf /opt/microsoft/msodbcsql/11.0.2270.0 \
    /opt/microsoft/msodbcsql/11.0.2260.0

Archivos de controlador

Los archivos clave de controladores ODBC en Linux incluyen:

Componente Descripción
libmsodbcsql-18.X.so.X.X, libmsodbcsql-17.X.so.X.X, o libmsodbcsql-13.X.so.X.X La biblioteca principal de objetos compartidos (so) para el controlador. La ruta de instalación es /opt/microsoft/msodbcsql18/lib64/ para el controlador 18, /opt/microsoft/msodbcsql17/lib64/ para el controlador 17 y /opt/microsoft/msodbcsql/lib64/ para el controlador 13.
msodbcsqlr18.rll, msodbcsqlr17.rll, o msodbcsqlr13.rll Archivo de recursos que acompaña a la biblioteca de controladores. La ruta de instalación es [driver .so directory]../share/resources/en_US/.
msodbcsql.h El archivo de encabezado que contiene todas las definiciones nuevas necesarias para utilizar el controlador.

Nota: No puedes hacer referencia a msodbcsql.h y odbcss.h en el mismo programa.

La ruta de instalación es /opt/microsoft/msodbcsql18/include/ para el controlador 18, /opt/microsoft/msodbcsql17/include/ para el controlador 17 y /opt/microsoft/msodbcsql/include/ para el controlador 13.
LICENSE.txt El archivo de texto que contiene los términos del Contrato de licencia del usuario final. La ruta de instalación es /usr/share/doc/msodbcsql18/ para el controlador 18, /usr/share/doc/msodbcsql17/ para el controlador 17 y /usr/share/doc/msodbcsql/ para el controlador 13.
RELEASE_NOTES El archivo de texto que contiene las notas de la versión. La ruta de instalación es /usr/share/doc/msodbcsql18/ para el controlador 18, /usr/share/doc/msodbcsql17/ para el controlador 17 y /usr/share/doc/msodbcsql/ para el controlador 13.

Cargar el archivo de recursos

El controlador debe cargar el archivo de recursos para funcionar. Este archivo se denomina msodbcsqlr18.rll, msodbcsqlr17.rll o msodbcsqlr13.rll según la versión del controlador. La ubicación del .rll archivo es relativa a la ubicación del propio controlador (so o dylib), como se describe en la tabla anterior. A partir de la versión 17.1, si el controlador no puede cargar el .rll archivo desde la ruta de acceso relativa, también intenta cargar el .rll archivo desde el directorio predeterminado. La ruta predeterminada del archivo de recursos en Linux es /opt/microsoft/msodbcsql18/share/resources/en_US/ para el controlador 18 y /opt/microsoft/msodbcsql17/share/resources/en_US/ para el controlador 17.

Solución de problemas

Conflicto de versión del controlador anterior

Si previamente instalaste y registraste una versión del controlador con unixODBC, la instalación podría fallar con un error como:

Installation failed, ODBC Driver $1 for SQL Server detected!

Para resolver el problema, anule el registro de esa versión del controlador con odbcinst. Sustituye <version> por el número del mensaje de error:

odbcinst -u -d -n "ODBC Driver <version> for SQL Server"

Si odbcinst no puede dar de baja el controlador, haz una copia de seguridad de odbcinst.ini y elimina solo la sección correspondiente al controlador en conflicto. No borres el archivo ni las secciones de otros controladores. Ejecuta odbcinst -j para encontrar la ubicación del archivo.

Errores de descarga de paquetes en Debian y Ubuntu

En las distribuciones basadas en Debian, es posible que vea el siguiente error al instalar el packages-microsoft-prod.deb paquete:

dpkg-deb: error: 'packages-microsoft-prod.deb' is not a Debian format archive

Una interrupción de red o un problema con el proxy podría dejar el archivo descargado dañado o incompleto, causando este error. Para resolver el problema:

  1. Elimine el archivo dañado y descárguelo de nuevo. Para Ubuntu:

    rm packages-microsoft-prod.deb
    curl -fsSLO "https://packages.microsoft.com/config/ubuntu/$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2)/packages-microsoft-prod.deb" || exit 1
    

    Para Debian, reemplace ubuntu y use solo el número de versión principal:

    rm packages-microsoft-prod.deb
    curl -fsSLO "https://packages.microsoft.com/config/debian/$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)/packages-microsoft-prod.deb" || exit 1
    
  2. Compruebe que la descarga es un paquete Debian válido (la salida debe incluir Debian binary package):

    file packages-microsoft-prod.deb
    
  3. Si la descarga sigue produciendo un error, compruebe la configuración de proxy y la conexión de red, o use wget en lugar de curl:

    wget https://packages.microsoft.com/config/ubuntu/$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2)/packages-microsoft-prod.deb
    

Problemas de conexión

Para más información sobre problemas de conexión, consulte el artículo sobre problemas conocidos sobre la resolución de problemas de conexión.