次の方法で共有


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 のインストール

  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-cu6azdata の実際のインストールのバージョンと 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-cu6azdata の実際のインストールのバージョンと 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