Installieren von Microsoft ODBC Driver for SQL Server unter Linux und macOSInstalling the Microsoft ODBC Driver for SQL Server on Linux and macOS

HerunterladenODBC-Treiber herunterladenDownloadDownload ODBC Driver

In diesem Artikel wird erläutert, wie der MicrosoftMicrosoft ODBC-Treiber für SQL ServerSQL Server unter Linux und macOS sowie die optionalen Befehlszeilentools für SQL Server (bcp und sqlcmd) und die unixODBC-Entwicklungsheader installiert werden.This article explains how to install the MicrosoftMicrosoft ODBC Driver for SQL ServerSQL Server on Linux and macOS, as well as the optional Command-Line Tools for SQL Server (bcp and sqlcmd) and the unixODBC Development Headers.

Microsoft ODBC Driver 17 for SQL ServerMicrosoft ODBC Driver 17 for SQL Server

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.If you installed the v17 msodbcsql package that was briefly available, you should remove it before installing the msodbcsql17 package. Dadurch werden Konflikte vermieden.This will avoid conflicts. Das msodbcsql17-Paket und das msodbcsql-Paket der Version 13 können nebeneinander installiert werden.The msodbcsql17 package can be installed side by side with the msodbcsql v13 package.

DebianDebian

sudo su 
curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add -

#Download appropriate package for the OS version
#Choose only ONE of the following, corresponding to your OS version

#Debian 8
curl https://packages.microsoft.com/config/debian/8/prod.list > /etc/apt/sources.list.d/mssql-release.list

#Debian 9
curl https://packages.microsoft.com/config/debian/9/prod.list > /etc/apt/sources.list.d/mssql-release.list

#Debian 10
curl https://packages.microsoft.com/config/debian/10/prod.list > /etc/apt/sources.list.d/mssql-release.list

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

Red Hat Enterprise ServerRedHat Enterprise Server

sudo su

#Download appropriate package for the OS version
#Choose only ONE of the following, corresponding to your OS version

#RedHat Enterprise Server 6
curl https://packages.microsoft.com/config/rhel/6/prod.repo > /etc/yum.repos.d/mssql-release.repo

#RedHat Enterprise Server 7
curl https://packages.microsoft.com/config/rhel/7/prod.repo > /etc/yum.repos.d/mssql-release.repo

#RedHat Enterprise Server 8
curl https://packages.microsoft.com/config/rhel/8/prod.repo > /etc/yum.repos.d/mssql-release.repo

exit
sudo yum remove unixODBC-utf16 unixODBC-utf16-devel #to avoid conflicts
sudo ACCEPT_EULA=Y yum install msodbcsql17
# optional: for bcp and sqlcmd
sudo ACCEPT_EULA=Y yum install mssql-tools
echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bash_profile
echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
source ~/.bashrc
# optional: for unixODBC development headers
sudo yum install unixODBC-devel

SUSE Linux Enterprise ServerSUSE Linux Enterprise Server

sudo su

#Download appropriate package for the OS version
#Choose only ONE of the following, corresponding to your OS version

#SUSE Linux Enterprise Server 11 SP4
#Ensure SUSE Linux Enterprise 11 Security Module has been installed 
zypper ar https://packages.microsoft.com/config/sles/11/prod.repo

#SUSE Linux Enterprise Server 12
zypper ar https://packages.microsoft.com/config/sles/12/prod.repo

#SUSE Linux Enterprise Server 15
zypper ar https://packages.microsoft.com/config/sles/15/prod.repo
#(Only for driver 17.3 and below)
SUSEConnect -p sle-module-legacy/15/x86_64

exit
sudo ACCEPT_EULA=Y zypper install msodbcsql17
# optional: for bcp and sqlcmd
sudo ACCEPT_EULA=Y zypper install mssql-tools
echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bash_profile
echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
source ~/.bashrc
# optional: for unixODBC development headers
sudo zypper install unixODBC-devel

UbuntuUbuntu

sudo su 
curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add -

#Download appropriate package for the OS version
#Choose only ONE of the following, corresponding to your OS version

#Ubuntu 14.04
curl https://packages.microsoft.com/config/ubuntu/14.04/prod.list > /etc/apt/sources.list.d/mssql-release.list

#Ubuntu 16.04
curl https://packages.microsoft.com/config/ubuntu/16.04/prod.list > /etc/apt/sources.list.d/mssql-release.list

#Ubuntu 18.04
curl https://packages.microsoft.com/config/ubuntu/18.04/prod.list > /etc/apt/sources.list.d/mssql-release.list

#Ubuntu 18.10
curl https://packages.microsoft.com/config/ubuntu/18.10/prod.list > /etc/apt/sources.list.d/mssql-release.list

#Ubuntu 19.04
curl https://packages.microsoft.com/config/ubuntu/19.04/prod.list > /etc/apt/sources.list.d/mssql-release.list

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

Hinweis

  • Die Treiberversion 17.2 oder höher ist für die Unterstützung von Ubuntu 18.04 erforderlich.Driver version 17.2 or higher is required for Ubuntu 18.04 support.
  • Die Treiberversion 17.3 oder höher ist für die Unterstützung von Ubuntu 18.10 erforderlich.Driver version 17.3 or higher is required for Ubuntu 18.10 support.

macOSMacOS

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release
brew update
brew install msodbcsql17 mssql-tools

Microsoft ODBC Driver 13.1 for SQL ServerMicrosoft ODBC Driver 13.1 for SQL Server

Debian 8Debian 8

sudo su 
curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add -
curl https://packages.microsoft.com/config/debian/8/prod.list > /etc/apt/sources.list.d/mssql-release.list
exit
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"' >> ~/.bash_profile
echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
source ~/.bashrc
# optional: for unixODBC development headers
sudo apt-get install unixodbc-dev

RedHat Enterprise Server 6RedHat Enterprise Server 6

sudo su
curl https://packages.microsoft.com/config/rhel/6/prod.repo > /etc/yum.repos.d/mssql-release.repo
exit
sudo yum remove unixODBC-utf16 unixODBC-utf16-devel #to avoid conflicts
sudo ACCEPT_EULA=Y yum install msodbcsql
# optional: for bcp and sqlcmd
sudo ACCEPT_EULA=Y yum install mssql-tools
echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bash_profile
echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
source ~/.bashrc
# optional: for unixODBC development headers
sudo yum install unixODBC-devel

RedHat Enterprise Server 7RedHat Enterprise Server 7

sudo su
curl https://packages.microsoft.com/config/rhel/7/prod.repo > /etc/yum.repos.d/mssql-release.repo
exit
sudo yum remove unixODBC-utf16 unixODBC-utf16-devel #to avoid conflicts
sudo ACCEPT_EULA=Y yum install msodbcsql
# optional: for bcp and sqlcmd
sudo ACCEPT_EULA=Y yum install mssql-tools
echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bash_profile
echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
source ~/.bashrc
# optional: for unixODBC development headers
sudo yum install unixODBC-devel

SUSE Linux Enterprise Server 11SUSE Linux Enterprise Server 11

sudo su
zypper ar https://packages.microsoft.com/config/sles/11/prod.repo
exit
sudo ACCEPT_EULA=Y zypper install msodbcsql
# optional: for bcp and sqlcmd
sudo ACCEPT_EULA=Y zypper install mssql-tools
echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bash_profile
echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
source ~/.bashrc
# optional: for unixODBC development headers
sudo zypper install unixODBC-devel

SUSE Linux Enterprise Server 12SUSE Linux Enterprise Server 12

sudo su
zypper ar https://packages.microsoft.com/config/sles/12/prod.repo
exit
sudo ACCEPT_EULA=Y zypper install msodbcsql
# optional: for bcp and sqlcmd
sudo ACCEPT_EULA=Y zypper install mssql-tools
echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bash_profile
echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
source ~/.bashrc
# optional: for unixODBC development headers
sudo zypper install unixODBC-devel

Ubuntu 15.10Ubuntu 15.10

sudo su 
curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add -
curl https://packages.microsoft.com/config/ubuntu/15.10/prod.list > /etc/apt/sources.list.d/mssql-release.list
exit
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"' >> ~/.bash_profile
echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
source ~/.bashrc
# optional: for unixODBC development headers
sudo apt-get install unixodbc-dev

Ubuntu 16.04Ubuntu 16.04

sudo su 
curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add -
curl https://packages.microsoft.com/config/ubuntu/16.04/prod.list > /etc/apt/sources.list.d/mssql-release.list
exit
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"' >> ~/.bash_profile
echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
source ~/.bashrc
# optional: for unixODBC development headers
sudo apt-get install unixodbc-dev

Ubuntu 16.10Ubuntu 16.10

sudo su 
curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add -
curl https://packages.microsoft.com/config/ubuntu/16.10/prod.list > /etc/apt/sources.list.d/mssql-release.list
exit
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"' >> ~/.bash_profile
echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
source ~/.bashrc
# optional: for unixODBC development headers
sudo apt-get install unixodbc-dev

OS X 10.11 (El Capitan) und macOS 10.12 (Sierra)OS X 10.11 (El Capitan) and macOS 10.12 (Sierra)

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

Microsoft ODBC Driver 13 for SQL ServerMicrosoft ODBC Driver 13 for SQL Server

RedHat Enterprise Server 6RedHat Enterprise Server 6

sudo su
curl https://packages.microsoft.com/config/rhel/6/prod.repo > /etc/yum.repos.d/mssql-release.repo
exit
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
ln -sfn /opt/mssql-tools/bin/sqlcmd-13.0.1.0 /usr/bin/sqlcmd 
ln -sfn /opt/mssql-tools/bin/bcp-13.0.1.0 /usr/bin/bcp

RedHat Enterprise Server 7RedHat Enterprise Server 7

sudo su
curl https://packages.microsoft.com/config/rhel/7/prod.repo > /etc/yum.repos.d/mssql-release.repo
exit
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
ln -sfn /opt/mssql-tools/bin/sqlcmd-13.0.1.0 /usr/bin/sqlcmd 
ln -sfn /opt/mssql-tools/bin/bcp-13.0.1.0 /usr/bin/bcp

Ubuntu 15.10Ubuntu 15.10

sudo su 
curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add -
curl https://packages.microsoft.com/config/ubuntu/15.10/prod.list > /etc/apt/sources.list.d/mssql-release.list
exit
sudo apt-get update
sudo ACCEPT_EULA=Y apt-get install msodbcsql=13.0.1.0-1 mssql-tools=14.0.2.0-1
sudo apt-get install unixodbc-dev-utf16 #this step is optional but recommended*
#Create symlinks for tools
ln -sfn /opt/mssql-tools/bin/sqlcmd-13.0.1.0 /usr/bin/sqlcmd 
ln -sfn /opt/mssql-tools/bin/bcp-13.0.1.0 /usr/bin/bcp

Ubuntu 16.04Ubuntu 16.04

sudo su 
curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add -
curl https://packages.microsoft.com/config/ubuntu/16.04/prod.list > /etc/apt/sources.list.d/mssql-release.list
exit
sudo apt-get update
sudo ACCEPT_EULA=Y apt-get install msodbcsql=13.0.1.0-1 mssql-tools=14.0.2.0-1
sudo apt-get install unixodbc-dev-utf16 #this step is optional but recommended*
#Create symlinks for tools
ln -sfn /opt/mssql-tools/bin/sqlcmd-13.0.1.0 /usr/bin/sqlcmd 
ln -sfn /opt/mssql-tools/bin/bcp-13.0.1.0 /usr/bin/bcp

SUSE Linux Enterprise Server 12SUSE Linux Enterprise Server 12

sudo su 
zypper ar https://packages.microsoft.com/config/sles/12/prod.repo 
zypper update 
sudo ACCEPT_EULA=Y zypper install msodbcsql-13.0.1.0-1 mssql-tools-14.0.2.0-1
zypper install unixODBC-utf16-devel
#Create symlinks for tools
ln -sfn /opt/mssql-tools/bin/sqlcmd-13.0.1.0 /usr/bin/sqlcmd 
ln -sfn /opt/mssql-tools/bin/bcp-13.0.1.0 /usr/bin/bcp

OfflineinstallationOffline installation

Wenn Sie es vorziehen/es erforderlich ist, dass der MicrosoftMicrosoft ODBC-Treiber 13 auf einem Computer ohne Internetverbindung installiert wird, müssen Paketabhängigkeiten manuell aufgelöst werden.If you prefer/require the MicrosoftMicrosoft ODBC Driver 13 to be installed on a computer with no internet connection, you will need to resolve package dependencies manually. Der MicrosoftMicrosoft ODBC-Treiber 13 hat die folgenden direkten Abhängigkeiten:The MicrosoftMicrosoft ODBC Driver 13 has the following direct dependencies:

  • Ubuntu: libc6 (>= 2.21), libstdc++6 (>= 4.9), libkrb5-3, libcurl3, openssl, debconf (>= 0.5), unixodbc (>= 2.3.1-1)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, unixODBCRed Hat: glibc, e2fsprogs, krb5-libs, openssl, unixODBC
  • SuSE: glibc, libuuid1, krb5, openssl, unixODBCSuSE: glibc, libuuid1, krb5, openssl, unixODBC

Jedes dieser Pakete hat wiederum seine eigenen Abhängigkeiten, die auf dem System entweder vorhanden oder nicht vorhanden sind.Each of these packages in turn has their own dependencies, which may or may not be present on the system. Eine allgemeine Lösung für das Problem finden Sie in der Paket-Manager-Dokumentation Ihrer Verteilung: Redhat, Ubuntu und SUSE.For a general solution to this issue, refer to your distribution's package manager documentation: Redhat, Ubuntu, and SUSE

Es ist außerdem gängig, alle abhängigen Pakete manuell herunterzuladen und sie zusammen auf dem Installationscomputer zu platzieren, dann wiederum jedes Paket manuell zu installieren und dabei mit dem MicrosoftMicrosoft ODBC-Treiberpaket 13 zu enden.It is also common to manually download all the dependent packages and place them together on the installation computer, then manually install each package in turn, finishing with the MicrosoftMicrosoft ODBC Driver 13 package.

Redhat Linux Enterprise Server 7Redhat Linux Enterprise Server 7

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

Ubuntu 16.04Ubuntu 16.04

sudo apt-get install libc6 libstdc++6 libkrb5-3 libcurl3 openssl debconf unixodbc unixodbc-dev #install dependencies
sudo dpkg -i msodbcsql_13.1.X.X-X_amd64.deb #install the Driver

SUSE Linux Enterprise Server 12SUSE Linux Enterprise Server 12

zypper install glibc, libuuid1, krb5, openssl, unixODBC unixODBC-devel #install dependencies
sudo rpm -i  msodbcsql-13.1.X.X-X.x86_64.rpm #install the Driver

Sobald die Paketeinstallation abgeschlossen wurde, können Sie überprüfen, ob der MicrosoftMicrosoft ODBC-Treiber 13 alle seine Abhängigkeiten finden kann, indem Sie „Idd“ ausführen und die entsprechende Ausgabe nach fehlenden Bibliotheken untersuchen:Once you have completed the package installation, you can verify that the MicrosoftMicrosoft ODBC Driver 13 can find all its dependencies by running ldd and inspecting its output for missing libraries:

ldd /opt/microsoft/msodbcsql/lib64/libmsodbcsql-*

Microsoft ODBC Driver 11 for SQL Server unter LinuxMicrosoft ODBC Driver 11 for SQL Server on Linux

Sie müssen den unixODBC-Treiber-Manager installieren, bevor Sie den Treiber verwenden können.Before you can use the driver, install the unixODBC driver manager. Weitere Informationen finden Sie unter Installieren des Treiber-Managers.For more information, see Installing the Driver Manager.

InstallationsschritteInstallation Steps

Wichtig

Diese Anleitung bezieht sich auf msodbcsql-11.0.2270.0.tar.gz, die Installationsdatei für Red Hat Linux.These instructions refer to msodbcsql-11.0.2270.0.tar.gz, which is installation file for Red Hat Linux. Wenn Sie die Vorschauversion von SUSE Linux installieren, ist der Dateiname msodbcsql-11.0.2260.0.tar.gz.If you are installing the Preview for SUSE Linux, the file name is msodbcsql-11.0.2260.0.tar.gz.

Den Treiber installieren:To install the driver:

  1. Stellen Sie sicher, dass Sie die Root-Berechtigung besitzen.Make sure that you have root permission.

  2. Wechseln Sie zu dem Verzeichnis, in dem der Download die Datei msodbcsql-11.0.2270.0.tar.gz platziert hat.Change to the directory where the download placed the file msodbcsql-11.0.2270.0.tar.gz. Stellen Sie sicher, dass Sie die zu Ihrer Linux-Version passende Datei „ *.tar.g“ besitzen.Make sure that you have the *.tar.gz file that matches your version of Linux. Führen Sie den folgenden Befehl aus, um die Dateien zu extrahieren: tar xvzf msodbcsql-11.0.2270.0.tar.gz.To extract the files, execute the following command, tar xvzf msodbcsql-11.0.2270.0.tar.gz.

  3. Wechseln Sie zum Verzeichnis msodbcsql-11.0.2270.0, das eine Datei namens install.sh enthalten sollte.Change to the msodbcsql-11.0.2270.0 directory and there you should see a file called install.sh.

  4. Um eine Liste aller verfügbaren Installationsoptionen zu erhalten, führen Sie den folgenden Befehl aus: ./install.sh.To see a list of the available installation options, execute the following command: ./install.sh.

  5. Führen Sie eine Sicherung von odbcinst.inimittels Backup durch.Make a backup of odbcinst.ini. Die Treiberinstallation aktualisiert odbcinst.ini.The driver installation updates odbcinst.ini. „odbcinst.ini“ beinhaltet die Liste der Treiber, die beim unixODBC-Treiber-Manager registriert sind.odbcinst.ini contains the list of drivers that are registered with the unixODBC Driver Manager. Um den Speicherort von „odbcinst.ini“ auf Ihrem Computer zu finden, führen Sie den folgenden Befehl aus: odbc_config --odbcinstini.To discover the location of odbcinst.ini on your computer, execute the following command: odbc_config --odbcinstini.

  6. Führen Sie den folgenden Befehl aus, bevor Sie den Treiber installieren: ./install.sh verify.Before you install the driver, execute the following command: ./install.sh verify. Die Ausgabe von ./install.sh verify gibt an, ob Ihr Computer über die erforderliche Software verfügt, um den ODBC-Treiber unter Linux zu unterstützen.The output of ./install.sh verify reports if your computer has the required software to support the ODBC driver on Linux.

  7. Wenn Sie bereit sind, den ODBC-Treiber unter Linux zu installieren, führen Sie diesen Befehl aus: ./install.sh install.When you are ready to install the ODBC driver on Linux, execute the command: ./install.sh install. Falls Sie einen Installationsbefehl angeben müssen (bin-dir oder lib-dir), geben Sie den Befehl nach der Option install an.If you need to specify an install command (bin-dir or lib-dir), specify the command after the install option.

  8. Lesen Sie die Lizenzvereinbarung und geben Sie YES ein, um mit der Installation fortzufahren.After reviewing the license agreement, type YES to continue with the installation.

Die Installation platziert den Treiber in /opt/microsoft/msodbcsql/11.0.2270.0.Installation puts the driver in /opt/microsoft/msodbcsql/11.0.2270.0. Der Treiber und seine Unterstützungsdateien müssen sich in /opt/microsoft/msodbcsql/11.0.2270.0 befinden.The driver and its support files must be in /opt/microsoft/msodbcsql/11.0.2270.0.

Um zu überprüfen, ob der ODBC-Treiber unter Linux erfolgreich registriert wurde, führen Sie den folgenden Befehl aus: odbcinst -q -d -n "ODBC Driver 11 for SQL Server".To verify that the Microsoft ODBC driver on Linux was registered successfully, execute the following command: odbcinst -q -d -n "ODBC Driver 11 for SQL Server".

Verwende bestehende MSDN C++ ODBC-Beispiele für den ODBC-Treiber unter Linux zeigt ein Beispiel, das mittels des ODBC-Treibers unter Linux eine Verbindung mit SQL ServerSQL Server herstellt.Use Existing MSDN C++ ODBC Samples for the ODBC Driver on Linux shows a code sample that connects to SQL ServerSQL Server using the ODBC driver on Linux.

DeinstallierenUninstalling

Sie können den ODBC-Treiber 11 unter Linux deinstallieren, indem Sie die folgenden Befehle ausführen:You can uninstall the ODBC driver 11 on Linux by executing the following commands:

  1. rm -f /usr/bin/sqlcmd

  2. rm -f /usr/bin/bcp

  3. rm -rf /opt/microsoft/msodbcsql

  4. odbcinst -u -d -n "ODBC Driver 11 for SQL Server"

Beheben von VerbindungsproblemenTroubleshooting Connection Problems

Falls Sie keine Verbindung mittels ODBC-Treiber mit SQL ServerSQL Server herstellen können, verwenden Sie die folgenden Informationen, um das Problem zu identifizieren.If you are unable to make a connection to SQL ServerSQL Server using the ODBC driver, use the following information to identify the problem.

Das häufigste Verbindungsproblem besteht darin, dass der unixODBC-Treiber-Manager doppelt installiert wurde.The most common connection problem is to have two copies of the UnixODBC Driver Manager installed. Durchsuchen Sie „/usr“ nach „libodbc*.so*“.Search /usr for libodbc*.so*. Falls Sie mehr als eine Version der Datei sehen, haben Sie (möglicherweise) mehr als einen Treiber-Manager installiert.If you see more than one version of the file, you (possibly) have more than one driver manager installed. Ihre Anwendung verwendet eventuell die falsche Version.Your application might use the wrong version.

Aktivieren Sie das Verbindungsprotokoll, indem Sie Ihre /etc/odbcinst.ini-Datei so bearbeiten, dass Sie den folgenden Bereich mit diesen Elementen enthält:Enable the connection log by editing your /etc/odbcinst.ini file to contain the following section with these items:

[ODBC]
Trace = Yes
TraceFile = (path to log file, or /dev/stdout to output directly to the terminal)

Falls der Verbindungsversuch wieder fehlschlägt und Ihnen keine Protokolldatei angezeigt wird, gibt es (möglicherweise) zwei Kopien des Treiber-Managers auf Ihrem Computer.If you get another connection failure and do not see a log file, there (possibly) are two copies of the driver manager on your computer. Andernfalls sollte die Ausgabe des Protokolls etwa so aussehen:Otherwise, the log output should be similar to the following:

[ODBC][28783][1321576347.077780][SQLDriverConnectW.c][290]  
        Entry:  
            Connection = 0x17c858e0  
            Window Hdl = (nil)  
            Str In = [DRIVER={ODBC Driver 13 for SQL Server};SERVER={contoso.com};Trusted_Connection={YES};WSID={mydb.contoso.com};AP...][length = 139 (SQL_NTS)]  
            Str Out = (nil)  
            Str Out Max = 0  
            Str Out Ptr = (nil)  
            Completion = 0  
        UNICODE Using encoding ASCII 'UTF8' and UNICODE 'UTF16LE'  

Falls die ASCII-Zeichencodierung beispielsweise nicht UTF-8 ist:If the ASCII character encoding is not UTF-8, for example:

UNICODE Using encoding ASCII 'ISO8859-1' and UNICODE 'UCS-2LE'  

Mehr als ein Treiber-Manager ist installiert und Ihre Anwendung verwendet den falschen, oder der Treiber-Manager wurde nicht korrekt erstellt.There is more than one Driver Manager installed and your application is using the wrong one, or the Driver Manager was not built correctly.

Weitere Informationen zum Beheben von Verbindungsproblemen finden Sie hier:For more information about resolving connection failures, see:

TreiberdateienDriver Files

Der ODBC-Treiber unter Linux und MacOS besteht aus den folgenden Komponenten:The ODBC Driver on Linux and MacOS consists of the following components:

LinuxLinux

KomponenteComponent und BeschreibungDescription
libmsodbcsql-17.X.so.X.X oder libmsodbcsql-13.X.so.X.Xlibmsodbcsql-17.X.so.X.X or libmsodbcsql-13.X.so.X.X Das freigegebene Objekt (so) der dynamischen Bibliotheksdatei, das die gesamte Funktionalität des Treibers enthält.The shared object (so) dynamic library file that contains all of the driver's functionality. Diese Datei wird in /opt/microsoft/msodbcsql17/lib64/ für den Treiber 17 und in /opt/microsoft/msodbcsql/lib64/ für den Treiber 13 installiert.This file is installed in /opt/microsoft/msodbcsql17/lib64/ for the Driver 17 and in /opt/microsoft/msodbcsql/lib64/ for Driver 13.
msodbcsqlr17.rll oder msodbcsqlr13.rllmsodbcsqlr17.rll or msodbcsqlr13.rll Die begleitende Ressourcendatei für die Treiberbibliothek.The accompanying resource file for the driver library. Diese Datei wird in [driver .so directory]../share/resources/en_US/ installiert.This file is installed in [driver .so directory]../share/resources/en_US/
msodbcsql.hmsodbcsql.h Die Headerdatei, die alle erforderlichen neuen Definitionen für die Verwendung des Treibers enthält.The header file that contains all of the new definitions needed to use the driver.

Hinweis: Sie können nicht auf „msodbcsql.h“ und „odbcss.h“ im selben Programm verweisen.Note: You cannot reference msodbcsql.h and odbcss.h in the same program.

„msodbcsql“ wird in /opt/microsoft/msodbcsql17/include/ für den Treiber 17 und in /opt/microsoft/msodbcsql/include/ für den Treiber 13 installiert.msodbcsql.h is installed in /opt/microsoft/msodbcsql17/include/ for Driver 17 and in /opt/microsoft/msodbcsql/include/ for Driver 13.
LICENSE.txtLICENSE.txt Die Textdatei, die die Bestimmungen des Endbenutzer-Lizenzvertrags enthält.The text file that contains the terms of the End-User License Agreement. Diese Datei wird in /usr/share/doc/msodbcsql17/ für den Treiber 17 und in /usr/share/doc/msodbcsql/ für den Treiber 13 platziert.This file is placed in /usr/share/doc/msodbcsql17/ for Driver 17 and in /usr/share/doc/msodbcsql/ for Driver 13.
RELEASE_NOTESRELEASE_NOTES Die Textdatei, die die Versionshinweise enthält.The text file that contains release notes. Diese Datei wird in /usr/share/doc/msodbcsql17/ für den Treiber 17 und in /usr/share/doc/msodbcsql/ für den Treiber 13 platziert.This file is placed in /usr/share/doc/msodbcsql17/ for Driver 17 and in /usr/share/doc/msodbcsql/ for Driver 13.

macOSMacOS

KomponenteComponent und BeschreibungDescription
libmsodbcsql.17.dylib oder libmsodbcsql.13.dyliblibmsodbcsql.17.dylib or libmsodbcsql.13.dylib Die Datei (dylib) der dynamischen Bibliothek, die die gesamte Funktionalität des Treibers enthält.The dynamic library (dylib) file that contains all of the driver's functionality. Diese Datei wird in /usr/local/lib/ installiert.This file is installed in /usr/local/lib/.
msodbcsqlr17.rll oder msodbcsqlr13.rllmsodbcsqlr17.rll or msodbcsqlr13.rll Die begleitende Ressourcendatei für die Treiberbibliothek.The accompanying resource file for the driver library. Diese Datei wird in [driver .dylib directory]../share/msodbcsql17/resources/en_US/ für den Treiber 17 und in [driver .dylib directory]../share/msodbcsql/resources/en_US/ für den Treiber 13 installiert.This file is installed in [driver .dylib directory]../share/msodbcsql17/resources/en_US/ for Driver 17 and in [driver .dylib directory]../share/msodbcsql/resources/en_US/ for Driver 13.
msodbcsql.hmsodbcsql.h Die Headerdatei, die alle erforderlichen neuen Definitionen für die Verwendung des Treibers enthält.The header file that contains all of the new definitions needed to use the driver.

Hinweis: Sie können nicht auf „msodbcsql.h“ und „odbcss.h“ im selben Programm verweisen.Note: You cannot reference msodbcsql.h and odbcss.h in the same program.

„msodbcsql“ wird in /usr/local/include/msodbcsql17/ für den Treiber 17 und in /usr/local/include/msodbcsql/ für den Treiber 13 installiert.msodbcsql.h is installed in /usr/local/include/msodbcsql17/ for Driver 17 and in /usr/local/include/msodbcsql/ for Driver 13.
LICENSE.txtLICENSE.txt Die Textdatei, die die Bestimmungen des Endbenutzer-Lizenzvertrags enthält.The text file that contains the terms of the End-User License Agreement. Diese Datei wird in /usr/local/share/doc/msodbcsql17/ für den Treiber 17 und in /usr/local/share/doc/msodbcsql/ für den Treiber 13 platziert.This file is placed in /usr/local/share/doc/msodbcsql17/ for Driver 17 and in /usr/local/share/doc/msodbcsql/ for Driver 13.
RELEASE_NOTESRELEASE_NOTES Die Textdatei, die die Versionshinweise enthält.The text file that contains release notes. Diese Datei wird in /usr/local/share/doc/msodbcsql17/ für den Treiber 17 und in /usr/local/share/doc/msodbcsql/ für den Treiber 13 platziert.This file is placed in /usr/local/share/doc/msodbcsql17/ for Driver 17 and in /usr/local/share/doc/msodbcsql/ for Driver 13.

Laden der RessourcendateiResource File Loading

Der Treiber muss die Ressourcendatei laden, um zu funktionieren.The driver needs to load the resource file in order to function. Diese Datei heißt msodbcsqlr17.rll oder msodbcsqlr13.rll, je nach Treiberversion.This file is called msodbcsqlr17.rll or msodbcsqlr13.rll depending on the driver version. Wie oben in der Tabelle aufgeführt, ist der Speicherort der .rll-Datei relativ zum Speicherort des Treibers selbst (so oder dylib).The location of the .rll file is relative to the location of the driver itself (so or dylib), as noted in the table above. 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.As of version 17.1 the driver will also attempt to load the .rll from the default directory if loading from the relative path fails. Die Standardressourcendateipfade sind die folgenden:The default resource file paths are:

Linux: /opt/microsoft/msodbcsql17/share/resources/en_US/Linux: /opt/microsoft/msodbcsql17/share/resources/en_US/

macOS: /usr/local/share/msodbcsql17/resources/en_US/MacOS: /usr/local/share/msodbcsql17/resources/en_US/

Weitere InformationenSee Also

Installieren des Treiber-ManagersInstalling the Driver Manager

VersionsanmerkungenRelease Notes

SystemanforderungenSystem Requirements