Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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:
- Controlador ODBC de Microsoft 13.1 para SQL Server
- Microsoft ODBC driver 13 para SQL Server
- Microsoft ODBC driver 11 para SQL Server
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.
- Descargue el paquete más reciente
msodbcsqlde https://packages.microsoft.com/rhel/7/prod/. - Instale las dependencias y el controlador.
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:
Confirme que tiene privilegios de root.
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 Cambia al directorio donde descargaste el archivo comprimido. Para extraer el paquete de Red Hat, ejecute:
tar xvzf msodbcsql-11.0.2270.0.tar.gzPara extraer el paquete SUSE, ejecute:
tar xvzf msodbcsql-11.0.2260.0.tar.gzCambia al directorio extraído que coincida con la versión de tu archivo comprimido. Debería ver un archivo denominado
install.sh.Para ver una lista de las opciones de instalación disponibles, ejecute el siguiente comando:
./install.shRealice una copia de seguridad de
odbcinst.ini. La instalación del controlador actualizaodbcinst.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 --odbcinstiniAntes de instalar el controlador, ejecute el siguiente comando:
./install.sh verifyLa salida de
./install.sh verifynotifica si el equipo tiene el software necesario para admitir el controlador ODBC en Linux.Cuando esté listo para instalar el controlador ODBC en Linux, ejecute el comando :
./install.sh installPara establecer directorios binarios o de biblioteca no predeterminados, pase
--bin-dir=<directory>o--lib-dir=<directory>después de la opcióninstall.Después de revisar el contrato de licencia, escriba
YESpara 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:
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 1Para Debian, reemplace
ubuntuy 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 1Compruebe que la descarga es un paquete Debian válido (la salida debe incluir
Debian binary package):file packages-microsoft-prod.debSi la descarga sigue produciendo un error, compruebe la configuración de proxy y la conexión de red, o use
wgeten lugar decurl: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.