Azure Data CLI (azdata
) の pip
でのインストール
適用対象: 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 をインストールするときに、
PATH
に Python を追加することを選択します。 そうしない場合は、後で 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
を実行します。
azdata
の macOS へのインストール
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