使用 pip 安装 Azure Data CLI (azdata)

适用范围:Azure Data CLI (azdata)

本文介绍如何使用 pip 在 Windows、Linux 或 macOS 上安装 Azure Data CLI (azdata) 工具。

提示

为了获得更简单的体验,可使用适用于 Windows、Linux(Ubuntu、Debian、RHEL、openSUSE 和 SLE 发行版)和 macOS 的包管理器安装 azdata

先决条件

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