使用 pip 安装 Azure Data CLI (azdata)

  • 项目

适用于： Azure Data CLI (azdata)

注意

本文引用了 CentOS，这是一个接近生命周期结束 (EOL) 状态的 Linux 发行版。 请相应地考虑你的使用和规划。 有关详细信息，请参阅 CentOS 生命周期结束指南。

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

提示

为了获得更简单的体验，可使用适用于 Windows、Linux（Ubuntu、Debian、RHEL、CentOS、openSUSE 和 SLE 分发）和 macOS 的包管理器安装 azdata。

先决条件

azdata 是使用 Python 编写的命令行实用工具，可让群集管理员通过 REST API 启动和管理数据资源。 所需的 Python 最低版本为 v3.6。 需要 pip 来下载并安装 azdata 工具。 以下说明提供了 Windows、Linux (Ubuntu) 和 macOS/OS X 的示例。若要在其他平台上安装 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。

  1. 安装 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。

  1. 安装 azdata。

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

    备注

    --user 交换机将 azdata 安装到 Python 用户安装目录。 这通常是 Linux 上的 ~/.local/bin。 将此目录添加到路径或导航到用户安装目录并从此处运行 ./azdata。

在 macOS 或 OS X 上安装 azdata

要在 macOS 或 OS X 上安装 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

后续步骤

有关大数据群集的详细信息，请参阅什么是 SQL Server 2019 大数据群集？。