Installare il driver ODBC di Microsoft per SQL Server (macOS)

Questo articolo illustra come installare Microsoft ODBC Driver for SQL Server in macOS. 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 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 le formule del driver e degli strumenti da riga di comando utilizzate nei comandi di questo articolo:

Version Formula driver Formula per gli strumenti opzionali
18 msodbcsql18 mssql-tools18
17 msodbcsql17 mssql-tools

Nota

Le versioni dei driver fino alla 17.7 su macOS sono solo x64. A partire dal Driver 17.8, i pacchetti macOS supportano sia x64 che Apple ARM64. La formula Homebrew rileva l'architettura e installa il pacchetto corrispondente. Se il prompt dei comandi è in esecuzione in modalità emulazione x64 su ARM64, Homebrew installa il pacchetto x64.

Usa unixODBC nelle installazioni con Homebrew. Le formule per Driver 17 e Driver 18 installano unixODBC come dipendenza. Se un'altra configurazione utilizza iODBC, assicurati che la libreria di driver e il driver manager puntino alla stessa architettura. Un disallineamento di architettura può produrre un errore come incompatible architecture (have 'arm64', need 'x86_64').

Prepara Homebrew

Se Homebrew non è installato, segui le istruzioni di installazione di Homebrew. Dopo l'installazione, segui le istruzioni di configurazione della shell stampate dall'installatore, quindi esegui brew --version per confermare che brew è disponibile. Il prefisso predefinito di Homebrew sul silicio Apple è /opt/homebrew.

Microsoft ODBC 18

Per installare il Microsoft ODBC Server 18 for SQL Server in macOS, eseguire i comandi seguenti:

brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release
brew update
HOMEBREW_ACCEPT_EULA=Y brew install msodbcsql18 mssql-tools18

Se Homebrew si rifiuta di caricare una formula da un tap non affidabile, verifica il nome canonico della formula e il tap prima di concedere fiducia. Per fidarsi solo delle formule del Driver 18, esegui:

brew trust --formula microsoft/mssql-release/msodbcsql18
brew trust --formula microsoft/mssql-release/mssql-tools18

Ripetere quindi l'installazione.

Aggiorna o verifica l'installazione di un driver

Per aggiornare un driver, aggiorna Homebrew e aggiorna la formula per la stessa versione principale. Sostituisci msodbcsql18 con msodbcsql17 per aggiornare il Driver 17. Per passare tra versioni major, installa l'altra formula e configura l'applicazione affinché richieda il nome del driver. Entrambe le formule possono essere installate contemporaneamente.

brew update && HOMEBREW_ACCEPT_EULA=Y brew upgrade msodbcsql18

Imposta driver_version su 17 oppure 18, quindi verifica la versione della formula installata, la registrazione unixODBC, l'architettura macOS e l'architettura della libreria driver:

Versione del driver driver_formula driver_name Libreria dei piloti
18 msodbcsql18 ODBC Driver 18 for SQL Server libmsodbcsql.18.dylib
17 msodbcsql17 ODBC Driver 17 for SQL Server libmsodbcsql.17.dylib
set -e
driver_version=18
driver_formula="msodbcsql${driver_version}"
driver_name="ODBC Driver ${driver_version} for SQL Server"
driver_library="$(brew --prefix "$driver_formula")/lib/libmsodbcsql.${driver_version}.dylib"

brew list --versions "$driver_formula"
odbcinst -q -d -n "$driver_name"
uname -m
file "$driver_library"

I comandi riportano la versione della formula installata, il nome del driver registrato, l'architettura macOS e l'architettura della libreria driver. Per impostazione predefinita, la formula Homebrew registra il driver. Se hai installato la formula con l'opzione --without-registration , la query di registrazione fallisce e il blocco si ferma prima che l'architettura effettui i controlli.

Rimuovere o reinstallare il Driver 17 o il Driver 18

Chiudi le applicazioni che utilizzano il driver prima di rimuoverlo. Se hai installato gli strumenti opzionali, disinstallali prima. Per il Driver 17, sostituisci mssql-tools18 con mssql-tools:

HOMEBREW_NO_AUTOREMOVE=1 brew uninstall mssql-tools18

Homebrew può rimuovere automaticamente le dipendenze inutilizzate durante brew uninstall. Imposta HOMEBREW_NO_AUTOREMOVE=1 per entrambi i comandi di disinstallazione, in modo da mantenere unixODBC disponibile fino a quando non annulli la registrazione e verifichi il driver. Se esegui brew autoremove, aspetta fino a dopo quella verifica.

Poi disinstalla il driver. Sostituisci msodbcsql18 con msodbcsql17 per rimuovere il Driver 17:

HOMEBREW_NO_AUTOREMOVE=1 brew uninstall msodbcsql18

Se Homebrew segnala che un'altra formula dipende dal driver, verifica quella dipendenza prima di procedere. Non forzare la rimozione di un driver necessario per gli strumenti installati.

Dopo aver disinstallato una formula che registrava il driver, rimuovine la registrazione. Per il Driver 17, sostituisci 18 con 17:

odbcinst -u -d -n "ODBC Driver 18 for SQL Server"

Dopo aver rimosso la registrazione, 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 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 manualmente le librerie di driver o i file di configurazione del driver manager.

Microsoft ODBC 17

Per installare Microsoft ODBC Driver 17 for SQL Server in macOS, eseguire i comandi seguenti:

brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release
brew update
HOMEBREW_ACCEPT_EULA=Y brew install msodbcsql17 mssql-tools

Se Homebrew si rifiuta di caricare una formula da un tap non affidabile, verifica il nome canonico della formula e il tap prima di concedere fiducia. Per fidarsi solo delle formule del Driver 17, esegui:

brew trust --formula microsoft/mssql-release/msodbcsql17
brew trust --formula microsoft/mssql-release/mssql-tools

Ripetere quindi l'installazione.

Puoi installare le formule driver msodbcsql17 e msodbcsql18 fianco a fianco. Le formule mssql-tools e mssql-tools18 forniscono entrambe sqlcmd e bcp, quindi Homebrew non può collegarle entrambe. Se mssql-tools18 è installato, il comando precedente installa mssql-tools ma segnala che il passaggio brew link non è stato completato, e bcp e sqlcmd continuano a eseguire gli strumenti versione 18. Per aggiungere il Driver 17 mentre gli strumenti del Driver 18 sono installati, installa solo il driver:

HOMEBREW_ACCEPT_EULA=Y brew install msodbcsql17

Importante

Se hai installato il pacchetto v17 msodbcsql disponibile brevemente, rimuovilo prima di installare msodbcsql17 per evitare conflitti. Puoi installare msodbcsql17 fianco a fianco con il pacchetto v13 msodbcsql .

Versioni precedenti

La sezione seguente fornisce le istruzioni di installazione per il Driver 13.1.

ODBC 13.1

Questi comandi documentano il percorso storico del Driver 13.1 per OS X 10.11 (El Capitan) e macOS 10.12 (Sierra). Gli attuali requisiti di installazione supportata di Homebrew elencano macOS Sequoia (15) o versioni successive; non includono questi sistemi più vecchi.

brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release
brew update
brew install msodbcsql@13.1.9.2 mssql-tools@14.0.6.0

File dei driver

I file chiave dei driver ODBC su macOS includono:

Componente Descrizione
libmsodbcsql.18.dylib, libmsodbcsql.17.dylib, oppure libmsodbcsql.13.dylib La libreria principale del driver. La libreria Driver 18 è sotto $(brew --prefix msodbcsql18)/lib/; la libreria Driver 17 è sotto $(brew --prefix msodbcsql17)/lib/. La biblioteca storica del Driver 13.1 è sotto /usr/local/lib/.
msodbcsqlr18.rll, msodbcsqlr17.rll, oppure msodbcsqlr13.rll Il file di risorse per la libreria dei driver. Per il Driver 18, è sotto $(brew --prefix msodbcsql18)/share/msodbcsql18/resources/en_US/; per il Driver 17, è sotto $(brew --prefix msodbcsql17)/share/msodbcsql17/resources/en_US/. Il file storico Driver 13.1 si trova sotto /usr/local/share/msodbcsql/resources/en_US/.
msodbcsql.h Il file di intestazione che contiene le definizioni del driver. Non puoi fare riferimento a msodbcsql.h e odbcss.h nello stesso programma. L'intestazione Driver 18 è sotto $(brew --prefix msodbcsql18)/include/msodbcsql18/; l'header Driver 17 è sotto $(brew --prefix msodbcsql17)/include/msodbcsql17/. L'intestazione storica Driver 13.1 è sotto /usr/local/include/msodbcsql/.
LICENSE.txt Il contratto di licenza con l'utente finale. È sotto $(brew --prefix msodbcsql18)/share/doc/msodbcsql18/ per Driver 18 e $(brew --prefix msodbcsql17)/share/doc/msodbcsql17/ per Driver 17. Il file storico Driver 13.1 si trova sotto /usr/local/share/doc/msodbcsql/.
RELEASE_NOTES Le note di rilascio. Sono in $(brew --prefix msodbcsql18)/share/doc/msodbcsql18/ per Driver 18 e $(brew --prefix msodbcsql17)/share/doc/msodbcsql17/ per Driver 17. Il file storico Driver 13.1 si trova sotto /usr/local/share/doc/msodbcsql/.

Carica il file delle risorse

Il driver ha bisogno del file di risorse per funzionare. La sua posizione è relativa alla libreria del driver, come mostrato nella tabella precedente. A partire dalla versione 17.1, il driver controlla anche la propria directory di risorse predefinita se la ricerca relativa fallisce.

Risoluzione dei problemi

Se una connessione non riesce con un errore Can't open lib, verifica quali file di configurazione unixODBC legge:

odbcinst -j

Se la directory segnalata non è la directory di configurazione Homebrew, imposta ODBCSYSINI per la shell che avvia la tua applicazione, quindi controlla nuovamente i percorsi:

export ODBCSYSINI="$(brew --prefix)/etc"
odbcinst -j

Per maggiori informazioni sui problemi di connessione, consulta l'articolo sui problemi noti risoluzione dei problemi di connessione.

Se Homebrew non riesce a trovare le formule, aggiungi il tap Microsoft:

brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release