Installation von Microsoft ODBC Driver for SQL Server (macOS)

In diesem Artikel wird die Installation von Microsoft ODBC Driver for SQL Server unter macOS erläutert. Er enthält außerdem Anweisungen für die optionalen Befehlszeilentools für SQL Server (bcp und sqlcmd) und die unixODBC-Entwicklungsheader.

In diesem Artikel finden Sie Befehle zum Installieren des ODBC-Treibers über die Bash-Shell. Informationen zum direkten Herunterladen der Pakete finden Sie unter Herunterladen von ODBC Driver for SQL Server.

Hinweis

Der Microsoft ODBC-Treiber für SQL Server unter macOS wird nur auf der x64-Architektur über Version 17.7 unterstützt. Apple ARM64 wird ab Version 17.8 unterstützt. Die Architektur wird erkannt, und das richtige Paket wird automatisch von der Homebrew-Formel installiert. Wenn Ihre Eingabeaufforderung im x64-Emulationsmodus auf ARM64 ausgeführt wird, wird das x64-Paket installiert. Wenn sie nicht im Emulationsmodus an der Eingabeaufforderung ausgeführt wird, wird das ARM64-Paket installiert. Darüber hinaus wurde das Homebrew-Standardverzeichnis mit der ARM64-Architektur in /opt/homebrew geändert. Die Pfade im Abschnitt Treiberdateien verwenden die x64-Homebrew-Pfade, die standardmäßig /usr/local lauten, sodass Ihre Dateipfade entsprechend abweichen.

Microsoft ODBC 18

Führen Sie die folgenden Befehle aus, um Microsoft ODBC Driver 18 for SQL Server unter macOS zu installieren:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release
brew update
HOMEBREW_ACCEPT_EULA=Y brew install msodbcsql18 mssql-tools18

Vorgängerversionen

In den folgenden Abschnitten finden Sie Anweisungen zum Installieren vorheriger Versionen von Microsoft ODBC Driver unter macOS.

Microsoft ODBC 17

Führen Sie die folgenden Befehle aus, um Microsoft ODBC Driver 17 for SQL Server unter macOS zu installieren:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release
brew update
HOMEBREW_ACCEPT_EULA=Y brew install msodbcsql17 mssql-tools

Wichtig

Wenn Sie das msodbcsql-Paket der Version 17 installiert haben, das kurz verfügbar war, sollten Sie es entfernen, bevor Sie das msodbcsql17-Paket installieren. Dadurch werden Konflikte vermieden. Das msodbcsql17-Paket und das msodbcsql-Paket der Version 13 können nebeneinander installiert werden.

ODBC 13.1

Verwenden Sie die folgenden Befehle, um Microsoft ODBC Driver 13.1 for SQL Server unter OS X 10.11 (El Capitan) und macOS 10.12 (Sierra):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
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

Treiberdateien

Der ODBC-Treiber unter macOS besteht aus den folgenden Komponenten:

Komponente	BESCHREIBUNG
libmsodbcsql.18.dylib oder libmsodbcsql.17.dylib oder libmsodbcsql.13.dylib	Die Datei (dylib) der dynamischen Bibliothek, die die gesamte Funktionalität des Treibers enthält. Diese Datei wird in /usr/local/lib/ installiert.
msodbcsqlr18.rll oder msodbcsqlr17.rll oder msodbcsqlr13.rll	Die begleitende Ressourcendatei für die Treiberbibliothek. Diese Datei wird in [driver .dylib directory]../share/msodbcsql18/resources/en_US/ für Treiber 18, in [driver .dylib directory]../share/msodbcsql17/resources/en_US/ für Treiber 17 und in [driver .dylib directory]../share/msodbcsql/resources/en_US/ für Treiber 13 installiert.
msodbcsql.h	Die Headerdatei, die alle erforderlichen neuen Definitionen für die Verwendung des Treibers enthält. Hinweis: Sie können nicht im selben Programm auf „msodbcsql.h“ und „odbcss.h“ verweisen. „msodbcsql.h“ wird in /usr/local/include/msodbcsql18/ für Treiber 18, in /usr/local/include/msodbcsql17/ für Treiber 17 und in /usr/local/include/msodbcsql/ für Treiber 13 installiert.
LICENSE.txt	Die Textdatei, die die Bestimmungen des Endbenutzer-Lizenzvertrags enthält. Diese Datei wird in /usr/local/share/doc/msodbcsql18/ für Treiber 18, in /usr/local/share/doc/msodbcsql17/ für Treiber 17 und in /usr/local/share/doc/msodbcsql/ für Treiber 13 abgelegt.
RELEASE_NOTES	Die Textdatei, die die Versionshinweise enthält. Diese Datei wird in /usr/local/share/doc/msodbcsql18/ für Treiber 18, in /usr/local/share/doc/msodbcsql17/ für Treiber 17 und in /usr/local/share/doc/msodbcsql/ für Treiber 13 abgelegt.

Laden der Ressourcendatei

Der Treiber muss die Ressourcendatei laden, um zu funktionieren. Diese Datei heißt msodbcsqlr18.rll, msodbcsqlr17.rll oder msodbcsqlr13.rll, je nach Treiberversion. Wie in der Komponententabelle aufgeführt, ist der Speicherort der .rll-Datei relativ zum Speicherort des Treibers selbst (so oder dylib). Ab Version 17.1 versucht der Treiber auch, die .rll-Datei aus dem Standardverzeichnis zu laden, wenn das Laden aus dem relativen Pfad fehlschlägt. Der Standardressourcendatei-Pfad unter macOS lautet /usr/local/share/msodbcsql18/resources/en_US/.

Problembehandlung

Bei einigen Benutzern tritt ein Problem mit einer Fehlermeldung wie "[01000] [unixODBC][Driver Manager]Can't open lib 'ODBC Driver 18 for SQL Server' : file not found (0) (SQLDriverConnect)" auf, wenn sie versuchen, eine Verbindung herzustellen, nachdem der ODBC-Treiber installiert wurde. In diesem Fall ist es möglich, dass unixODBC nicht ordnungsgemäß für die Ermittlung registrierter Treiber konfiguriert ist. In diesen Fällen lässt sich das Problem durch das Erstellen von symbolischen Verknüpfungen lösen.

sudo ln -s /usr/local/etc/odbcinst.ini /etc/odbcinst.ini
sudo ln -s /usr/local/etc/odbc.ini /etc/odbc.ini

Wenn Sie aus anderen Gründen mit dem ODBC-Treiber keine Verbindung mit SQL Server herstellen können, finden Sie im Artikel zu bekannten Problemen unter Beheben von Verbindungsproblemen weitere Informationen.

Falls die Formeln von Brew nicht gefunden werden können, vergewissern Sie sich, dass Sie den Installationsschritt nicht übersprungen haben: brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release

Nächste Schritte

Nachdem Sie den Treiber installiert haben, können Sie die C++-ODBC-Beispielanwendung testen. Weitere Informationen zum Entwickeln von ODBC-Anwendungen finden Sie unter Entwickeln von Anwendungen.

Weitere Informationen zum ODBC-Treiber finden Sie in den Versionshinweisen und den Systemanforderungen.