Azure Data CLI (azdata) の pip でのインストール

適用対象: Azure Data CLI (azdata)

この記事では、pip を使用して Windows、Linux、または macOS 用の Azure Data CLI (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 をインストールするときに、PATH に Python を追加することを選択します。 そうしない場合は、後で 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 を実行します。

azdata の macOS へのインストール

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
   

関連するコンテンツ

• SQL Server 2019 ビッグ データ クラスターとは