共用方式為

使用 pip 安裝 Azure Data CLI (azdata)

  • 發行項

適用於：Azure Data CLI (azdata)

本文說明如何使用 pip 在 Windows、Linux 或 macOS/OS 上安裝 Azure Data CLI (azdata) 工具。

提示

為了提供更簡單的體驗，azdata 可以使用適用於 Windows、Linux (Ubuntu、Debian、RHEL、openSUSE 與 SLE 發行版本) 與 macOS 的套件管理員來安裝。

必要條件

azdata 是以 Python 撰寫的命令列公用程式，可讓叢集系統管理員透過 REST API 來啟動及管理資料資源。 所需的最低 Python 版本為 v3.6。 需要 pip 才能下載及安裝 azdata 工具。 下列指示提供 Windows、Linux (Ubuntu) 和 macOS 的範例。 針對其他 Python 或其他平台，請參閱 Python 文件。 此外也請安裝及更新最新版的 requests Python 套件：

pip3 install -U requests

Windows azdata 安裝

  1. 在 Windows 用戶端上，從 https://www.python.org/downloads/ 下載所需的 Python 套件。 若為 Python 3.6 和更新版本，在您安裝 Python 時也會一併安裝 pip3。

    提示

    安裝 Python3 時，請選取將 Python 新增至您的 PATH。 若安裝時未採取此動作，也可以在之後尋找 pip3 的位置，然後手動將其新增至您的PATH。

  2. 開啟新的 Windows PowerShell 工作階段，讓其取得最新的路徑，其中包含 Python。

  3. 從 SQL Server 2019 CU5 版本開始，azdata 與伺服器之間有獨立的語意版本。 如果您在這之前已安裝任何舊版的 azdata，請務必先解除安裝，然後安裝最新版本。

    例如，針對 2019-cu4，請執行下列命令：

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

    注意

    在上面的範例中，請將 2019-cu6 取代為 azdata 安裝的版本與 CU。

  4. 安裝 azdata。

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

Linux azdata 安裝

在 Linux 上，您必須安裝 Python 3.6，然後升級 pip。 下列範例顯示適用於 Ubuntu 的命令。 針對其他 Linux 平台，請參閱 Python 文件。

  1. 安裝必要的 Python 套件：

    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. 升級 pip3。

    sudo -H pip3 install --upgrade pip

  3. 從 SQL Server 2019 CU5 版本開始，azdata 與伺服器之間有獨立的語意版本。 如果您在這之前已安裝任何舊版的 azdata，請務必先解除安裝，然後安裝最新版本。

    例如，針對 2019-cu6，請執行下列命令：

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

    注意

    在上面的範例中，請將 2019-cu6 取代為 azdata 安裝的版本與 CU。

  4. 安裝 azdata。

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

    注意

    --user 參數會將 azdata 安裝至 Python 使用者安裝目錄。 在 Linux 上通常是 ~/.local/bin。 請將此目錄新增至您的路徑，或巡覽至使用者安裝目錄，然後從該處執行 ./azdata。

在 macOS 上安裝 azdata

若要在 macOS 上安裝 azdata，請完成下列步驟。 在每個步驟中，於在 [終端機] 中執行範例。

  1. 在 macOS 用戶端上，安裝 Homebrew (若還未安裝)：

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

  2. 安裝 Python 及 pip (最低版本 3.0)：

    brew install python3

  3. 安裝相依性：

    pip3 install -U requests
brew install freetds

  4. 從 SQL Server 2019 CU5 版本開始，azdata 與伺服器之間有獨立的語意版本。 如果您在這之前已安裝任何舊版的 azdata，請務必先解除安裝，然後安裝最新版本。 例如，下列命令會移除 azdata 的 RC1 版本：

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

  5. 安裝 Azure Data CLI。

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

相關內容