Installieren der SQL Server-Befehlszeilentools sqlcmd und bcp unter LinuxInstall sqlcmd and bcp the SQL Server command-line tools on Linux

Anwendungsbereich:Applies to: JaSQL ServerSQL Server (alle unterstützten Versionen) yesSQL ServerSQL Server (all supported versions) : LinuxAnwendungsbereich:Applies to: JaSQL ServerSQL Server (alle unterstützten Versionen) yesSQL ServerSQL Server (all supported versions) - Linux

Über die folgenden Schritte werden die Befehlszeilentools, die Microsoft ODBC-Treiber und deren Abhängigkeiten installiert.The following steps install the command-line tools, Microsoft ODBC drivers, and their dependencies. Das Paket mssql-tools enthält Folgendes:The mssql-tools package contains:

  • sqlcmd: Abfragehilfsprogramm für die Befehlszeilesqlcmd: Command-line query utility.
  • bcp: Hilfsprogramm für den Massenimport/-exportbcp: Bulk import-export utility.

Installieren Sie die Tools für Ihre Plattform:Install the tools for your platform:

In diesem Artikel wird beschrieben, wie die Befehlszeilentools installiert werden.This article describes how to install the command-line tools. Beispiele zur Verwendung von sqlcmd oder bcp finden Sie unter den Links am Ende dieses Artikels.If you are looking for examples of how to use sqlcmd or bcp, see the links at the end of this topic.

Installieren von Tools unter RHEL 8Install tools on RHEL 8

Führen Sie zum Installieren von mssql-tools unter Red Hat Enterprise Linux die folgenden Schritte aus.Use the following steps to install the mssql-tools on Red Hat Enterprise Linux.

  1. Wechseln Sie in den Superuser-Modus.Enter superuser mode.

    sudo su
    
  2. Laden Sie die Konfigurationsdatei für das Microsoft Red Hat-Repository herunter.Download the Microsoft Red Hat repository configuration file.

    curl https://packages.microsoft.com/config/rhel/8/prod.repo > /etc/yum.repos.d/msprod.repo
    
  3. Beenden Sie den Superuser-Modus.Exit superuser mode.

    exit
    
  4. Wenn Sie eine frühere Version von mssql-tools installiert hatten, entfernen Sie alle älteren unixODBC-Pakete.If you had a previous version of mssql-tools installed, remove any older unixODBC packages.

    sudo yum remove mssql-tools unixODBC-utf16-devel
    
  5. Führen Sie die folgenden Befehle aus, um mssql-tools mit dem unixODBC-Entwicklerpaket zu installieren.Run the following commands to install mssql-tools with the unixODBC developer package.

    sudo yum install mssql-tools unixODBC-devel
    

    Hinweis

    Führen Sie die folgenden Befehle aus, um mssql-tools auf die neueste Version zu aktualisieren:To update to the latest version of mssql-tools run the following commands:

    sudo yum check-update
    sudo yum update mssql-tools
    
  6. Optional: Fügen Sie in einer Bash-Shell /opt/mssql-tools/bin/ zu Ihrer PATH-Umgebungsvariablen hinzu.Optional: Add /opt/mssql-tools/bin/ to your PATH environment variable in a bash shell.

    Ändern Sie PATH in der Datei ~/.bash_profile mit dem folgenden Befehl, um sqlcmd/bcp von der Bash-Shell aus für Anmeldesitzungen zugänglich zu machen:To make sqlcmd/bcp accessible from the bash shell for login sessions, modify your PATH in the ~/.bash_profile file with the following command:

    echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bash_profile
    

    Ändern Sie PATH in der Datei ~/.bashrc mit dem folgenden Befehl, um sqlcmd/bcp von der Bash-Shell aus für interaktive Sitzungen oder Sitzungen ohne Anmeldung zugänglich zu machen:To make sqlcmd/bcp accessible from the bash shell for interactive/non-login sessions, modify the PATH in the ~/.bashrc file with the following command:

    echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
    source ~/.bashrc
    

Installieren von Tools unter Ubuntu 16.04Install tools on Ubuntu 16.04

Führen Sie zum Installieren von mssql-tools unter Ubuntu die folgenden Schritte aus.Use the following steps to install the mssql-tools on Ubuntu.

Hinweis

Ubuntu 18.04 wird ab SQL Server 2019 CU3 unterstützt.Ubuntu 18.04 is supported starting with SQL Server 2019 CU3. Wenn Sie Ubuntu 18.04 verwenden, ändern Sie den Pfad des Repositorys von /ubuntu/16.04 in /ubuntu/18.04.If you are using Ubuntu 18.04, change the repository path from /ubuntu/16.04 to /ubuntu/18.04.

  1. Importieren Sie die GPG-Schlüssel des öffentlichen Repositorys.Import the public repository GPG keys.

    curl https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add -
    
  2. Registrieren Sie das Microsoft Ubuntu-Repository.Register the Microsoft Ubuntu repository.

    curl https://packages.microsoft.com/config/ubuntu/16.04/prod.list | sudo tee /etc/apt/sources.list.d/msprod.list
    
  3. Aktualisieren Sie die Liste mit Quellen, und führen Sie den Installationsbefehl mit dem unixODBC-Entwicklerpaket aus.Update the sources list and run the installation command with the unixODBC developer package.

    sudo apt-get update 
    sudo apt-get install mssql-tools unixodbc-dev
    

    Hinweis

    Führen Sie die folgenden Befehle aus, um mssql-tools auf die neueste Version zu aktualisieren:To update to the latest version of mssql-tools run the following commands:

    sudo apt-get update 
    sudo apt-get install mssql-tools 
    
  4. Optional: Fügen Sie in einer Bash-Shell /opt/mssql-tools/bin/ zu Ihrer PATH-Umgebungsvariablen hinzu.Optional: Add /opt/mssql-tools/bin/ to your PATH environment variable in a bash shell.

    Ändern Sie PATH in der Datei ~/.bash_profile mit dem folgenden Befehl, um sqlcmd/bcp von der Bash-Shell aus für Anmeldesitzungen zugänglich zu machen:To make sqlcmd/bcp accessible from the bash shell for login sessions, modify your PATH in the ~/.bash_profile file with the following command:

    echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bash_profile
    

    Ändern Sie PATH in der Datei ~/.bashrc mit dem folgenden Befehl, um sqlcmd/bcp von der Bash-Shell aus für interaktive Sitzungen oder Sitzungen ohne Anmeldung zugänglich zu machen:To make sqlcmd/bcp accessible from the bash shell for interactive/non-login sessions, modify the PATH in the ~/.bashrc file with the following command:

    echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
    source ~/.bashrc
    

Installieren von Tools unter SLES 12Install tools on SLES 12

Führen Sie zum Installieren von mssql-tools unter SUSE Linux Enterprise Server die folgenden Schritte aus.Use the following steps to install the mssql-tools on SUSE Linux Enterprise Server.

  1. Fügen Sie das Microsoft SQL Server-Repository zu Zypper hinzu.Add the Microsoft SQL Server repository to Zypper.

    sudo zypper addrepo -fc https://packages.microsoft.com/config/sles/12/prod.repo 
    sudo zypper --gpg-auto-import-keys refresh
    
  2. Installieren Sie mssql-tools mit dem unixODBC-Entwicklerpaket.Install mssql-tools with the unixODBC developer package.

    sudo zypper install mssql-tools unixODBC-devel
    

    Hinweis

    Führen Sie die folgenden Befehle aus, um mssql-tools auf die neueste Version zu aktualisieren:To update to the latest version of mssql-tools run the following commands:

    sudo zypper refresh
    sudo zypper update mssql-tools
    
  3. Optional: Fügen Sie in einer Bash-Shell /opt/mssql-tools/bin/ zu Ihrer PATH-Umgebungsvariablen hinzu.Optional: Add /opt/mssql-tools/bin/ to your PATH environment variable in a bash shell.

    Ändern Sie PATH in der Datei ~/.bash_profile mit dem folgenden Befehl, um sqlcmd/bcp von der Bash-Shell aus für Anmeldesitzungen zugänglich zu machen:To make sqlcmd/bcp accessible from the bash shell for login sessions, modify your PATH in the ~/.bash_profile file with the following command:

    echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bash_profile
    

    Ändern Sie PATH in der Datei ~/.bashrc mit dem folgenden Befehl, um sqlcmd/bcp von der Bash-Shell aus für interaktive Sitzungen oder Sitzungen ohne Anmeldung zugänglich zu machen:To make sqlcmd/bcp accessible from the bash shell for interactive/non-login sessions, modify the PATH in the ~/.bashrc file with the following command:

    echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
    source ~/.bashrc
    

Installieren von Tools unter macOSInstall tools on macOS

Eine Vorschauversion von sqlcmd und bcp ist nun unter macOS verfügbar.A preview of sqlcmd and bcp is now available on macOS. Weitere Informationen finden Sie in der Ankündigung.For more information, see the announcement.

Installieren Sie Homebrew, falls Sie es noch nicht installiert haben:Install Homebrew if you don't have it already:

  • /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Verwenden Sie zum Installieren der Tools für Mac El Capitan und Sierra die folgenden Befehle:To install the tools for Mac El Capitan and Sierra, use the following commands:

# brew untap microsoft/mssql-preview if you installed the preview version 
brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release
brew update
brew install mssql-tools
#for silent install: 
#HOMEBREW_NO_ENV_FILTERING=1 ACCEPT_EULA=y brew install mssql-tools

DockerDocker

Wenn Sie SQL Server in einem Docker-Container ausführen, sind die SQL Server-Befehlszeilentools bereits im Linux-Containerimage von SQL Server enthalten.If you run SQL Server in a Docker container, the SQL Server command-line tools are already included in the SQL Server Linux container image. Wenn Sie mithilfe einer interaktiven Bash-Shell mit einem ausgeführten Container verbunden sind, können Sie die Tools lokal ausführen.If you attach to a running container with an interactive bash shell, you can run the tools locally.

OfflineinstallationOffline installation

Wenn Ihr Linux-Computer keinen Zugriff auf die Onlinerepositorys hat, die in den vorherigen Abschnitten verwendet werden, können Sie die Paketdateien direkt herunterladen.If your Linux machine does not have access to the online repositories used in the previous sections, you can download the package files directly. Diese Pakete befinden sich im Microsoft-Repository https://packages.microsoft.com.These packages are located in the Microsoft repository, https://packages.microsoft.com.

Tipp

Wenn Sie die Installation mithilfe der Schritte in den vorherigen Abschnitten erfolgreich abgeschlossen haben, müssen Sie das oder die nachstehend aufgeführten Pakete nicht herunterladen oder manuell installieren.If you successfully installed with the steps in the previous sections, you do not need to download or manually install the package(s) below. Dies gilt nur für das Offlineszenario.This is only for the offline scenario.

  1. Suchen und kopieren Sie zunächst das Paket mssql-tools für Ihre Linux-Verteilung:First, locate and copy the mssql-tools package for your Linux distribution:

    Linux-VerteilungLinux distribution Speicherort des Pakets mssql-toolsmssql-tools package location
    Red HatRed Hat https://packages.microsoft.com/rhel/7.3/prod
    SLESSLES https://packages.microsoft.com/sles/12/prod
    Ubuntu 16.04Ubuntu 16.04 https://packages.microsoft.com/ubuntu/16.04/prod/pool/main/m/mssql-tools
  2. Suchen und kopieren Sie auch das Paket msodbcsql, bei dem es sich um eine Abhängigkeit handelt.Also locate and copy the msodbcsql package, which is a dependency. Das Paket msodbcsql verfügt ebenfalls über eine Abhängigkeit von unixODBC-devel (Red Hat und SLES) oder unixodbc-dev (Ubuntu).The msodbcsql package also has a dependency on either unixODBC-devel (Red Hat and SLES) or unixodbc-dev (Ubuntu). Die Speicherorte der msodbcsql-Pakete sind in der folgenden Tabelle aufgeführt:The location of the msodbcsql packages are listed in the following table:

    Linux-VerteilungLinux distribution Speicherort von ODBC-PaketenODBC packages location
    Red HatRed Hat https://packages.microsoft.com/rhel/8/prod
    SLESSLES https://packages.microsoft.com/sles/12/prod
    Ubuntu 16.04Ubuntu 16.04 msodbcsqlmsodbcsql
    unixodbc-devunixodbc-dev
  3. Verschieben Sie die heruntergeladenen Pakete auf Ihren Linux-Computer.Move the downloaded packages to your Linux machine. Wenn Sie einen anderen Computer zum Herunterladen der Pakete verwendet haben, stellt der Befehl scp eine Möglichkeit dar, die Pakete auf Ihren Linux-Computer zu verschieben.If you used a different machine to download the packages, one way to move the packages to your Linux machine is with the scp command.

  4. Installieren der Pakete: Installieren Sie die Pakete mssql-tools und msodbc.Install the and packages: Install the mssql-tools and msodbc packages. Wenn Abhängigkeitsfehler auftreten, ignorieren Sie diese bis zum nächsten Schritt.If you get any dependency errors, ignore them until the next step.

    PlattformPlatform Befehle zur PaketinstallationPackage install commands
    Red HatRed Hat sudo yum localinstall msodbcsql-<version>.rpm
    sudo yum localinstall mssql-tools-<version>.rpm
    SLESSLES sudo zypper install msodbcsql-<version>.rpm
    sudo zypper install mssql-tools-<version>.rpm
    UbuntuUbuntu sudo dpkg -i msodbcsql_<version>.deb
    sudo dpkg -i mssql-tools_<version>.deb
  5. Lösen Sie fehlende Abhängigkeiten auf: Zu diesem Zeitpunkt fehlen möglicherweise Abhängigkeiten.Resolve missing dependencies: You might have missing dependencies at this point. Falls nicht, können Sie diesen Schritt überspringen.If not, you can skip this step. In einigen Fällen müssen Sie diese Abhängigkeiten manuell suchen und installieren.In some cases, you must manually locate and install these dependencies.

    Bei RPM-Paketen können Sie die erforderlichen Abhängigkeiten mithilfe der folgenden Befehle überprüfen:For RPM packages, you can inspect the required dependencies with the following commands:

    rpm -qpR msodbcsql-<version>.rpm
    rpm -qpR mssql-tools-<version>.rpm
    

    Wenn Sie bei Debian-Paketen Zugriff auf genehmigte Repositorys mit diesen Abhängigkeiten haben, ist die einfachste Lösung die Verwendung des Befehls apt-get:For Debian packages, if you have access to approved repositories containing those dependencies, the easiest solution is to use the apt-get command:

    sudo apt-get -f install
    

    Hinweis

    Mit diesem Befehl wird auch die Installation der SQL Server-Pakete abgeschlossen.This command completes the installation of the SQL Server packages as well.

    Wenn das bei Ihren Debian-Paketen nicht funktioniert, können Sie die erforderlichen Abhängigkeiten mithilfe der folgenden Befehle überprüfen:If this does not work for your Debian package, you can inspect the required dependencies with the following commands:

    dpkg -I msodbcsql_<version>_amd64.deb | grep "Depends:"
    dpkg -I mssql-tools_<version>_amd64.deb | grep "Depends:"
    

Nächste SchritteNext steps

Ein Beispiel für die Verwendung von sqlcmd zum Herstellen einer Verbindung mit SQL Server und zum Erstellen einer Datenbank finden Sie in einem der folgenden Schnellstarts:For an example of how to use sqlcmd to connect to SQL Server and create a database, see one of the following quickstarts:

Ein Beispiel für die Verwendung von bcp für den Massenimport und -export von Daten finden Sie unter Bulk copy data to SQL Server on Linux (Massenkopieren von Daten auf SQL Server für Linux).For an example of how to use bcp to bulk import and export data, see Bulk copy data to SQL Server on Linux.