使用 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
安装
在 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
注意
在前面的示例中,将
2019-cu6
替换为你安装的azdata
版本和 CU。安装
azdata
。pip3 install -r https://aka.ms/azdata
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
备注
在前面的示例中,将
2019-cu6
替换为你安装的azdata
版本和 CU。安装
azdata
。pip3 install -r https://aka.ms/azdata --user
备注
--user
交换机将azdata
安装到 Python 用户安装目录。 这通常是 Linux 上的~/.local/bin
。 将此目录添加到路径或导航到用户安装目录并从此处运行./azdata
。
在 macOS 上安装 azdata
要在 macOS 上安装 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