Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Questo articolo illustra come installare Microsoft ODBC Driver for SQL Server in Linux. Sono inoltre incluse le istruzioni per gli strumenti della riga di comando facoltativi per SQL Server (bcp e sqlcmd) e le intestazioni di sviluppo unixODBC.
Questo articolo fornisce i comandi per l'installazione del driver ODBC dalla shell Bash. Se si vogliono scaricare direttamente i pacchetti, vedere Scaricare ODBC Driver for SQL Server.
Scegli una versione del driver
Usa il Driver 18 per le nuove applicazioni. Il driver 17 rimane supportato per applicazioni che richiedono il comportamento della versione 17. Prima di aggiornare un'applicazione dal Driver 17 al Driver 18, esamina le principali differenze di versione, incluso il cambiamento ai valori predefiniti di crittografia. Per le date di supporto, consulta il ciclo di vita del supporto.
La tabella seguente mostra i pacchetti driver e strumenti da riga di comando:
| Version | Pacchetto driver | Pacchetto strumenti opzionali | Percorso degli strumenti |
|---|---|---|---|
| 18 | msodbcsql18 |
mssql-tools18 |
/opt/mssql-tools18/bin |
| 17 | msodbcsql17 |
mssql-tools |
/opt/mssql-tools/bin |
Microsoft ODBC 18
Le sezioni seguenti illustrano come installare Microsoft ODBC Driver 18 dalla shell Bash per diverse distribuzioni Linux. Le distribuzioni supportate sono Alpine Linux, Debian, Red Hat Enterprise Linux (RHEL), Oracle Linux, SUSE Linux Enterprise Server (SLES), Ubuntu e Azure Linux. A partire dalla versione 18.4, per accettare automaticamente il End-User License Agreement (EULA) durante l'installazione del driver non-Alpine Linux (.deb o .rpm), puoi creare il file /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
Il driver 17.5 e versioni successive supportano Alpine.
Microsoft ODBC 17
Le sezioni seguenti illustrano come installare Microsoft ODBC Driver 17 dalla shell Bash per diverse distribuzioni Linux.
Importante
Se è stato installato il pacchetto v17 msodbcsql disponibile brevemente, rimuoverlo prima di installare il msodbcsql17 pacchetto per evitare conflitti. È possibile installare il msodbcsql17 pacchetto affiancato al msodbcsql pacchetto 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
Il driver 17.5 e le versioni successive supportano Alpine.
Aggiorna o verifica l'installazione di un driver
Per aggiornare un driver che hai installato da un repository di pacchetti Linux, aggiorna i metadati del pacchetto e aggiorna il pacchetto per la stessa versione principale. Per le distribuzioni con istruzioni di installazione del Driver 17 in questo articolo, sostituisci msodbcsql18 con msodbcsql17 per aggiornare il Driver 17. I comandi Azure Linux si applicano al Driver 18. Per passare tra le versioni principali, installa l'altro pacchetto e configura la tua applicazione per richiedere il nome del driver.
| Distribuzione | Comando Aggiornamento |
|---|---|
| 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 |
Per Alpine, scarica e installa l'APK aggiornato per la versione principale installata e l'architettura di sistema. Il driver 18 supporta i pacchetti amd64 e arm64 mostrati nelle istruzioni di installazione. Il driver 17 utilizza il amd64 pacchetto:
I comandi di aggiornamento richiedono curl e gpg. Se manca uno dei due, installali 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
Per il driver 17, scarica e installa il amd64 pacchetto:
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
Dopo aver installato o aggiornato un driver, imposta driver_version su 17 op, 18e poi verifica la sua registrazione unixODBC e l'architettura di sistema:
| Versione del driver | 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 query di registrazione stampa il nome del driver tra parentesi.
uname -m Riporta l'architettura del sistema. Utilizza il comando di interrogazione dei pacchetti per la tua distribuzione per verificare la versione e l'architettura del pacchetto installato:
| Distribuzione | Interrogazione del pacchetto |
|---|---|
| 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 query del pacchetto restituisce il nome del pacchetto, la versione installata e l'architettura del pacchetto. Questi comandi non si collegano a un database.
Rimuovere o reinstallare il Driver 17 o il Driver 18
Chiudi le applicazioni che utilizzano il driver prima di rimuoverlo. Per le distribuzioni con istruzioni di installazione del Driver 17 in questo articolo, sostituisci msodbcsql18 con msodbcsql17 per rimuovere il Driver 17. Il comando Azure Linux si applica al Driver 18.
| Distribuzione | Comando di rimozione |
|---|---|
| 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 |
Anche applicazioni o strumenti dipendenti potrebbero essere rimossi. Se il tuo gestore di pacchetto chiede conferma, esamina le rimozioni proposte prima di accettare. Sulle versioni Red Hat Enterprise Linux e Oracle Linux che yum utilizzano DNF, aggiungi --setopt=clean_requirements_on_remove=0 al comando di rimozione per mantenere unixODBC per il controllo di registrazione. Per il Driver 17, sostituisci msodbcsql18 con msodbcsql17.
Su Alpine, installa unixODBC esplicitamente prima di rimuovere il driver in modo che odbcinst rimanga disponibile per il controllo di registrazione.
apk del Conserva il driver se gli strumenti installati dipendono ancora da esso. Se hai installato gli strumenti opzionali, sostituisci il comando Alpine nella tabella precedente con:
sudo apk add unixodbc
sudo apk del mssql-tools18 msodbcsql18
Per il Driver 17, usa sudo apk add unixodbc seguito da sudo apk del mssql-tools msodbcsql17. Esamina le applicazioni dipendenti prima di rimuovere questi pacchetti, quindi ripeti la query di registrazione.
Dopo la rimozione, esegui odbcinst -q -d. Se elenca i nomi dei driver, conferma che il nome driver rimosso non sia elencato. Se segnala SQLGetPrivateProfileString failed, esegui odbcinst -j e controlla il percorso DRIVERS che segnala. Se il file di configurazione dei driver esiste, è leggibile e non contiene registrazioni dei driver, nessun driver rimane registrato. Se il file manca, non leggibile o contiene ancora la voce del driver rimosso, risolvi il problema di configurazione prima di considerare la rimozione completa. Per reinstallare, ripeti i comandi di installazione per la stessa distribuzione e versione principale, quindi ripeti la verifica.
La rimozione di un driver può impedire che le applicazioni che richiedono il nome del driver si connettano. Non eliminare i file dei driver né il file di configurazione del driver manager. Se una registrazione obsoleta blocca l'installazione, vedi Conflitto di versione del driver precedente per i passaggi di ripristino mirati.
Versioni precedenti
Le seguenti sezioni forniscono le istruzioni di installazione per le versioni precedenti del driver Microsoft ODBC:
- Microsoft ODBC driver 13.1 for SQL Server
- Driver Microsoft ODBC 13 per SQL Server
- Microsoft ODBC driver 11 per SQL Server
ODBC 13.1
Le sezioni seguenti illustrano come installare Microsoft ODBC Driver 13.1 dalla shell Bash per diverse distribuzioni 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
Le sezioni seguenti illustrano come installare Microsoft ODBC Driver 13 dalla shell Bash per diverse distribuzioni 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
Installazione offline per ODBC 13
Per installare il driver Microsoft ODBC 13 senza connessione Internet, risolvi manualmente queste dipendenze dirette dai pacchetti:
- Ubuntu:
libc6(>= 2.21),libstdc++6(>= 4.9),libkrb5-3,libcurl3,openssl(debconf>= 0.5),unixODBC(>= 2.3.1-1) - Red Hat:
glibc,e2fsprogs,krb5-libs,openssl,unixODBC - SUSE:
glibc,libuuid1,krb5,openssl,unixODBC
Ogni pacchetto ha le proprie dipendenze. Per indicazioni sul gestore di pacchetti, consulta la documentazione di Red Hat, Ubuntu e SUSE.
È possibile scaricare manualmente tutti i pacchetti dipendenti e inserirli insieme nel computer di installazione. Quindi, installare manualmente ogni pacchetto a sua volta, terminando con il pacchetto Microsoft ODBC Driver 13.
- Scaricare il pacchetto più recente
msodbcsqlda https://packages.microsoft.com/rhel/7/prod/. - Installare le dipendenze e il driver.
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
Le sezioni seguenti illustrano come installare Microsoft ODBC Driver 11 in Linux. Prima di poter usare il driver, installare il gestore di driver unixODBC. Per altre informazioni, vedere Installazione di Gestione dei driver.
Installa il Driver 11
Importante
Usa l'archivio che corrisponde alla tua distribuzione: Red Hat Linux usa msodbcsql-11.0.2270.0.tar.gz, e SUSE Linux usa msodbcsql-11.0.2260.0.tar.gz.
Per installare il driver:
Conferma di disporre dei permessi di root.
Scaricare il driver.
Distribuzione Pilota Hash 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 Passa alla directory in cui hai scaricato l'archivio. Per estrarre il pacchetto Red Hat, esegui:
tar xvzf msodbcsql-11.0.2270.0.tar.gzPer estrarre il pacchetto SUSE, esegui:
tar xvzf msodbcsql-11.0.2260.0.tar.gzCambia alla directory estratta che corrisponde alla versione dell'archivio. Verrà visualizzato un file denominato
install.sh.Per visualizzare un elenco delle opzioni di installazione disponibili, eseguire il comando seguente:
./install.shEseguire un backup di
odbcinst.ini. L'installazione del driver aggiornaodbcinst.ini. odbcinst.ini contiene l'elenco dei driver registrati in Gestione driver unixODBC. Per individuare il percorso di odbcinst.ini nel computer, eseguire il comando seguente:odbc_config --odbcinstiniPrima di installare il driver, eseguire il comando seguente:
./install.sh verifyL'output di
./install.sh verifysegnala se il computer dispone del software necessario per supportare il driver ODBC in Linux.Quando si è pronti per installare il driver ODBC in Linux, eseguire il comando :
./install.sh installPer impostare directory binarie o di libreria non predefinite, passa
--bin-dir=<directory>o--lib-dir=<directory>dopo l'opzioneinstall.Dopo aver esaminato il contratto di licenza, digitare
YESper continuare con l'installazione.
La libreria driver è installata in /opt/microsoft/msodbcsql/lib64. Red Hat installa la versione 11.0.2270.0 e SUSE installa la versione 11.0.2260.0. I file di supporto di ciascuna versione sono installati nella corrispondente cartella sotto /opt/microsoft/msodbcsql. Il pacchetto installa inoltre le utility con versione bcp e sqlcmd sotto /opt/microsoft/msodbcsql/bin e crea collegamenti in /usr/bin per impostazione predefinita. Se hai usato l'opzione --lib-dir oppure --bin-dir , sostituisci i percorsi specificati.
Per verificare che il driver ODBC Microsoft in Linux sia stato registrato correttamente, eseguire il comando seguente:
odbcinst -q -d -n "ODBC Driver 11 for SQL Server"
Disinstalla
Disinstallare il driver ODBC 11 in Linux eseguendo i comandi seguenti:
Caution
Questi comandi rimuovono le librerie, le utility e i file di supporto del Driver 11 per le due versioni dei pacchetti elencate. Controlla i percorsi prima di eseguirli. Se hai usato l'opzione --lib-dir oppure --bin-dir , sostituisci i percorsi specificati.
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
File dei driver
I file chiave del driver ODBC su Linux includono:
| Componente | Descrizione |
|---|---|
libmsodbcsql-18.X.so.X.X, libmsodbcsql-17.X.so.X.X, oppure libmsodbcsql-13.X.so.X.X |
La principale libreria di oggetti condivisi (so) per il driver. Il percorso di installazione è /opt/microsoft/msodbcsql18/lib64/ per il Driver 18, /opt/microsoft/msodbcsql17/lib64/ per il Driver 17 e /opt/microsoft/msodbcsql/lib64/ per il Driver 13. |
msodbcsqlr18.rll, msodbcsqlr17.rll, oppure msodbcsqlr13.rll |
File di risorse che accompagna la libreria driver. Il percorso di installazione è [driver .so directory]../share/resources/en_US/. |
msodbcsql.h |
File di intestazione che contiene tutte le nuove definizioni necessarie per usare il driver. Nota: Non puoi fare riferimento a msodbcsql.h e odbcss.h nello stesso programma.Il percorso di installazione è /opt/microsoft/msodbcsql18/include/ per il Driver 18, /opt/microsoft/msodbcsql17/include/ per il Driver 17 e /opt/microsoft/msodbcsql/include/ per il Driver 13. |
LICENSE.txt |
File di testo che contiene i termini del contratto di licenza con l'utente finale. Il percorso di installazione è /usr/share/doc/msodbcsql18/ per il Driver 18, /usr/share/doc/msodbcsql17/ per il Driver 17 e /usr/share/doc/msodbcsql/ per il Driver 13. |
RELEASE_NOTES |
Il file di testo che contiene le note di rilascio. Il percorso di installazione è /usr/share/doc/msodbcsql18/ per il Driver 18, /usr/share/doc/msodbcsql17/ per il Driver 17 e /usr/share/doc/msodbcsql/ per il Driver 13. |
Carica il file delle risorse
Perché possa funzionare, il driver deve caricare il file di risorse. Questo file è denominato msodbcsqlr18.rll, msodbcsqlr17.rll o msodbcsqlr13.rll a seconda della versione del driver. Il percorso del .rll file è relativo al percorso del driver stesso (so o dylib), come descritto nella tabella precedente. A partire dalla versione 17.1, se il driver non riesce a caricare il .rll file dal percorso relativo, prova anche a caricare il .rll file dalla directory predefinita. Il percorso predefinito del file di risorsa su Linux è /opt/microsoft/msodbcsql18/share/resources/en_US/ per il Driver 18 e /opt/microsoft/msodbcsql17/share/resources/en_US/ per il Driver 17.
Risoluzione dei problemi
Conflitto di versione del driver precedente
Se in precedenza hai installato e registrato una versione del driver con unixODBC, l'installazione potrebbe fallire con un errore come:
Installation failed, ODBC Driver $1 for SQL Server detected!
Per risolvere il problema, annulla la registrazione della versione del driver con odbcinst. Sostituisci <version> con il numero nel messaggio di errore:
odbcinst -u -d -n "ODBC Driver <version> for SQL Server"
Se odbcinst non può annullare la registrazione del driver, esegui un backup di odbcinst.ini e rimuovi solo la sezione del driver in conflitto. Non eliminare il file o altre sezioni del driver. Esegui odbcinst -j per trovare la posizione del file.
Errori di download dei pacchetti in Debian e Ubuntu
Nelle distribuzioni basate su Debian è possibile che venga visualizzato l'errore seguente quando si installa il packages-microsoft-prod.deb pacchetto:
dpkg-deb: error: 'packages-microsoft-prod.deb' is not a Debian format archive
Un'interruzione di rete o un problema di proxy potrebbe lasciare il file scaricato corrotto o incompleto, causando questo errore. Per risolvere il problema:
Eliminare il file danneggiato e scaricarlo di nuovo. Per 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 1Per Debian, sostituire
ubuntue usare solo il numero di versione principale: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 1Verificare che il download sia un pacchetto Debian valido (l'output deve includere
Debian binary package):file packages-microsoft-prod.debSe il download continua a non riuscire, controllare le impostazioni di connessione di rete e proxy oppure usare
wgetinvece dicurl:wget https://packages.microsoft.com/config/ubuntu/$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2)/packages-microsoft-prod.deb
Problemi di connessione
Per maggiori informazioni sui problemi di connessione, consulta l'articolo sulla risoluzione dei problemi di connessione.