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

  • [アーティクル]

適用対象: Azure Data CLI (azdata)

注意事項

この記事では、間もなくサポート終了 (EOL) 状態になる Linux ディストリビューションである CentOS について説明します。 適宜、使用と計画を検討してください。 詳細については、「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 をインストールするときに、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 に置き換えます。

  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 ビッグ データ クラスターとは」を参照してください。