Partager via


Installer Azure Data CLI (azdata) avec pip

S’applique à : Azure Data CLI (azdata)

Cet article explique comment installer l’outil Azure Data CLI (azdata) sur Windows, Linux ou macOS à l’aide de pip.

Conseil

Pour bénéficier d’une expérience plus simple, azdata peut être installé avec un gestionnaire de package pour Windows, Linux (distributions Ubuntu, Debian, RHEL, openSUSE et SLE) et macOS.

Prérequis

azdata est un utilitaire en ligne de commande écrit en Python qui permet aux administrateurs de clusters de démarrer et de gérer des ressources de données par le biais des API REST. Vous devez utiliser au minimum Python version 3.6. pip est nécessaire pour télécharger et installer l’outil azdata. Les instructions suivantes fournissent des exemples pour Windows, Linux (Ubuntu) et macOS. Pour installer Python sur d’autres plateformes, consultez la documentation Python. En outre, installez et mettez à jour la dernière version du package Python requests :

pip3 install -U requests

Installation de azdata sur Windows

  1. Sur un client Windows, téléchargez le package Python nécessaire à partir de https://www.python.org/downloads/. Pour Python 3.6 et les versions ultérieures, pip3 est installé en même temps que Python.

    Conseil

    Lorsque vous installez Python 3, ajoutez Python à votre chemin (PATH). Si vous ne le faites pas, vous pourrez rechercher plus tard l’emplacement de PIP3 et l’ajouter manuellement à PATH.

  2. Ouvrez une nouvelle session Windows PowerShell afin d’obtenir le chemin le plus récent avec Python.

  3. À compter de SQL Server 2019 CU5, azdata inclut une version sémantique indépendante du serveur. Si des versions précédentes d’azdata sont déjà installées avant celle-ci, il est important de les désinstaller d’abord, puis d’installer la dernière version.

    Par exemple, pour 2019-cu4, exécutez la commande suivante :

    pip3 uninstall -r https://azdatacli.blob.core.windows.net/python/azdata/2019-cu4/requirements.txt
    

    Notes

    Dans les exemples précédents, remplacez 2019-cu6 par la version et la mise à jour cumulative (CU) de votre installation d’azdata.

  4. Installez azdata.

    pip3 install -r https://aka.ms/azdata
    

Installation de azdata sur Linux

Sur Linux, vous devez installer Python 3.6, puis mettre à niveau pip. L’exemple suivant montre les commandes qui fonctionnent pour Ubuntu. Pour les autres plateformes Linux, consultez la documentation Python.

  1. Installez les packages Python nécessaires :

    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. Mettez à niveau pip3.

    sudo -H pip3 install --upgrade pip
    
  3. À compter de SQL Server 2019 CU5, azdata inclut une version sémantique indépendante du serveur. Si des versions précédentes d’azdata sont déjà installées avant celle-ci, il est important de les désinstaller d’abord, puis d’installer la dernière version.

    Par exemple, pour 2019-cu6, exécutez la commande suivante :

    pip3 uninstall -r https://azdatacli.blob.core.windows.net/python/azdata/2019-cu6/requirements.txt
    

    Notes

    Dans les exemples précédents, remplacez 2019-cu6 par la version et la mise à jour cumulative (CU) de votre installation d’azdata.

  4. Installez azdata.

    pip3 install -r https://aka.ms/azdata --user
    

    Notes

    Le commutateur --user installe azdata dans le répertoire d’installation de l’utilisateur Python. Sur Linux, il s’agit généralement de ~/.local/bin. Ajoutez ce répertoire à votre chemin ou accédez au répertoire d’installation de l’utilisateur et exécutez ./azdata à partir de ce répertoire.

Installer azdata sur macOS

Pour installer azdata sur macOS, effectuez les étapes suivantes. Pour chaque étape, exécutez l’exemple dans Terminal.

  1. Sur un client macOS, installez Homebrew si vous ne l’avez pas déjà :

    /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
    
  2. Installez Python et PIP, au minimum la version 3.0 :

    brew install python3
    
  3. Installez des dépendances :

    pip3 install -U requests
    brew install freetds
    
  4. À compter de SQL Server 2019 CU5, azdata inclut une version sémantique indépendante du serveur. Si des versions précédentes d’azdata sont déjà installées avant celle-ci, il est important de les désinstaller d’abord, puis d’installer la dernière version. Par exemple, la commande suivante supprime la version RC1 disque défini au d’azdata :

    pip3 uninstall -r https://azdatacli.blob.core.windows.net/python/azdata/2019-rc1/requirements.txt
    
  5. Installer Azure Data CLI.

    pip3 install -r https://aka.ms/azdata