适用于: Azure Data CLI ( azdata )

本文介绍如何使用 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 安装

  • 在 Windows 客户端上,从 https://www.python.org/downloads/ 下载所需的 Python 包。 对于 Python 3.6 及更高版本,安装 Python 时还会安装 pip3。

    安装 Python3 时,选择将 Python 添加到 PATH。 如果没有这样做,可在稍后找到 pip3 所在的位置并手动将其添加到 PATH

  • 打开新的 Windows PowerShell 会话,以便它获取包含 Python 的最新路径。

  • 从 SQL Server 2019 CU5 版本开始,azdata 具有来自服务器的独立语义版本。 如果你在此之前安装了任何以前的 azdata 版本,则在安装最新版本之前,务必先卸载这些以前的版本。

    例如,对于 2019-cu4,运行以下命令:

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

    Linux azdata 安装

    在 Linux 上,必须安装 Python 3.6,然后升级 pip。 以下示例介绍了适用于 Ubuntu 的命令。 对于其他 Linux 平台,请参阅 Python 文档

  • 安装必需的 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
    
  • 升级 pip3。

    sudo -H pip3 install --upgrade pip
    
  • 从 SQL Server 2019 CU5 版本开始,azdata 具有来自服务器的独立语义版本。 如果你在此之前安装了任何以前的 azdata 版本,则在安装最新版本之前,务必先卸载这些以前的版本。

    例如,对于 2019-cu6,运行以下命令:

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

    要在 macOS 或 OS X 上安装 azdata,请完成以下步骤。 对于每个步骤,请在终端中运行示例。

  • 在 macOS 客户端上,如果尚未安装 Homebrew,请进行安装:

    /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
    
  • 安装 Python 和 pip,最低版本为 3.0:

    brew install python3
    
  • 安装依赖项:

    pip3 install -U requests
    brew install freetds
    
  • 从 SQL Server 2019 CU5 版本开始,azdata 具有来自服务器的独立语义版本。 如果你在此之前安装了任何以前的 azdata 版本,则在安装最新版本之前,务必先卸载这些以前的版本。 例如,以下命令删除 azdata 的 RC1 版本:

    pip3 uninstall -r https://azdatacli.blob.core.windows.net/python/azdata/2019-rc1/requirements.txt
    
  • 安装 Azure Data CLI。

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

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

  •