Freigeben über

Installieren von Azure Data CLI (azdata) mit pip

  • Artikel

Gilt für: Azure Data CLI (azdata)

Achtung

Dieser Artikel bezieht sich auf CentOS, eine Linux-Distribution, die sich dem End-of-Life-Status (EOL) nähert. Sie sollten Ihre Nutzung entsprechend planen. Weitere Informationen finden Sie im CentOS End-of-Life-Leitfaden.

In diesem Artikel wird beschrieben, wie Sie das Azure Data CLI (azdata)-Tool mithilfe von pip unter Windows, Linux oder macOS/OS X installieren.

Tipp

Zur Vereinfachung können Sie zum Installieren von azdata einen Paket-Manager für Windows, Linux (Ubuntu-, Debian-, RHEL-, CentOS-, openSUSE- und SLE-Distributionen) und macOS verwenden.

Voraussetzungen

azdata ist ein in Python geschriebenes Befehlszeilen-Hilfsprogramm, mit dem Clusteradministratoren über REST-APIs Bootstraps durchführen und Datenressourcen verwalten können. Die mindestens erforderliche Python-Version ist 3.6. pip ist zum Herunterladen und Installieren des azdata-Tools erforderlich. Die nachstehenden Anweisungen enthalten Beispiele für Windows, Linux (Ubuntu) und macOS/OS X. Informationen zum Installieren von Python auf anderen Plattformen finden Sie in der Python-Dokumentation. Installieren und aktualisieren Sie außerdem die aktuelle Version des Python-Pakets requests:

pip3 install -U requests

Installation von azdata unter Windows

  1. Laden Sie das erforderliche Python-Paket aus https://www.python.org/downloads/ auf einen Windows-Client herunter. Bei Python 3.6 und höher wird bei der Installation von Python auch pip3 installiert.

    Tipp

    Wenn Sie Python 3 installieren, wählen Sie aus, dass Python PATH hinzugefügt wird. Wenn nicht, können Sie später ermitteln, wo sich pip3 befindet, und pip3 manuell PATH hinzufügen.

  2. Öffnen Sie eine neue Windows PowerShell-Sitzung, um den aktuellen Pfad mit Python zu verwenden.

  3. Ab SQL Server 2019 CU5 verfügt azdata über eine vom Server unabhängige Semantik. Wenn bereits vorherige Releases von azdata installiert sind, müssen Sie diese vor dem Installieren der aktuellen Version erst deinstallieren.

    Führen Sie beispielsweise für 2019-cu4 den folgenden Befehl aus:

    pip3 uninstall -r https://azdatacli.blob.core.windows.net/python/azdata/2019-cu4/requirements.txt

Hinweis

Ersetzen Sie in den vorstehenden Beispielen 2019-cu6 durch Version und CU Ihrer installierten Version von azdata.

  1. Installieren von azdata.

    pip3 install -r https://aka.ms/azdata

Installation von azdata unter Linux

Unter Linux müssen Sie Python 3.6 installieren und dann pip upgraden. Das folgende Beispiel zeigt die Befehle, die für Ubuntu funktionieren. Informationen zu anderen Linux-Plattformen finden Sie in der Python-Dokumentation.

  1. Installieren Sie die erforderlichen Python-Pakete:

    sudo apt-get update && \
sudo apt-get install -y python3 && \
sudo apt-get install -y python3-pip && \
sudo apt-get install -y libkrb5-dev && \
sudo apt-get install -y libsqlite3-dev && \
sudo apt-get install -y unixodbc-dev

  2. Führen Sie ein Upgrade für pip3 durch.

    sudo -H pip3 install --upgrade pip

  3. Ab SQL Server 2019 CU5 verfügt azdata über eine vom Server unabhängige Semantik. Wenn bereits vorherige Releases von azdata installiert sind, müssen Sie diese vor dem Installieren der aktuellen Version erst deinstallieren.

    Führen Sie für 2019-cu6 beispielsweise den folgenden Befehl aus:

    pip3 uninstall -r https://azdatacli.blob.core.windows.net/python/azdata/2019-cu6/requirements.txt

Hinweis

Ersetzen Sie in den vorstehenden Beispielen 2019-cu6 durch Version und CU Ihrer installierten Version von azdata.

  1. Installieren von azdata.

    pip3 install -r https://aka.ms/azdata --user

    Hinweis

    Mit der Befehlszeilenoption --user wird azdata im Python-Benutzerinstallationsverzeichnis installiert. Dies ist unter Linux in der Regel ~/.local/bin. Fügen Sie entweder dieses Verzeichnis dem Pfad hinzu, oder navigieren Sie zum Benutzerinstallationsverzeichnis, und führen Sie ./azdata dort aus.

Installation von azdata unter macOS oder OS X

Befolgen Sie diese Schritte, um azdata unter macOS oder OS X zu installieren. Führen Sie für jeden Schritt das Beispiel im Terminal aus.

  1. Installieren Sie auf einem macOS-Client Homebrew, sofern Sie das noch nicht getan haben:

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

  2. Installieren Sie mindestens Version 3.0 von Python und pip.

    brew install python3

  3. Installieren von Abhängigkeiten:

    pip3 install -U requests
brew install freetds

  4. Ab SQL Server 2019 CU5 verfügt azdata über eine vom Server unabhängige Semantik. Wenn bereits vorherige Releases von azdata installiert sind, müssen Sie diese vor dem Installieren der aktuellen Version erst deinstallieren. Mit dem folgenden Befehl wird beispielsweise die RC1-Version von azdata entfernt:

    pip3 uninstall -r https://azdatacli.blob.core.windows.net/python/azdata/2019-rc1/requirements.txt

  5. Installieren Sie die Azure Data CLI.

    pip3 install -r https://aka.ms/azdata

Nächste Schritte

Weitere Informationen zu Big Data-Clustern finden Sie unter Was sind SQL Server 2019: Big Data-Cluster?.