Guide pratique pour installer les packages de bibliothèque Azure pour Python

Le Kit de développement logiciel (SDK) Azure pour Python est composé de nombreuses bibliothèques individuelles qui peuvent être installées dans des environnements Python ou conda standard.

Les bibliothèques des environnements Python standard sont listées dans l’index des packages.

Les packages pour les environnements conda sont répertoriés dans le canal Microsoft sur anaconda.org. Les packages Azure ont des noms qui commencent par azure-.

Avec ces bibliothèques Azure, vous pouvez créer et gérer des ressources sur les services Azure (à l’aide des bibliothèques de gestion, dont les noms de package commencent par azure-mgmt) et vous connecter avec ces ressources à partir du code d’application (à l’aide des bibliothèques clientes, dont les noms de package commencent par juste azure-).

Installer la dernière version d’un package

pip

pip install <package>

pip install récupère la dernière version d’un package dans votre environnement Python actuel.

Sur les systèmes Linux, vous devez installer un package pour chaque utilisateur séparément. L’installation de packages pour tous les utilisateurs avec sudo pip install n’est pas prise en charge.

Vous pouvez utiliser n’importe quel nom de package listé dans l’index des packages. Dans la page d’index, recherchez la fonctionnalité dont vous avez besoin dans la colonne Nom , puis recherchez et sélectionnez le lien PyPI dans la colonne Package .

conda

Veillez à ajouter le canal Microsoft à votre configuration conda (vous devez exécuter cette commande une seule fois) :

conda config --add channels "Microsoft"

Ensuite, installez le package souhaité :

conda install <package>

conda install récupère la dernière version d’un package dans votre environnement Python actuel.

Vous pouvez utiliser n’importe quel nom de package listé dans le canal Microsoft sur anaconda.org. Les packages Azure portent des noms qui commencent par azure-.

Les packages pour conda sont regroupés par services. Par exemple, azure-storage inclut des bibliothèques permettant d’utiliser des blobs, des partages de fichiers, des files d’attente et tout autre service de stockage Azure. Seul le package azure-mgmt contient les bibliothèques de gestion pour tous les services.

Installer des versions de package spécifiques

pip

Spécifiez la version souhaitée sur la ligne de commande à l’aide de pip install.

pip install <package>==<version>

Vous trouverez les numéros de version dans l’index du package. Dans la page d’index, recherchez la fonctionnalité dont vous avez besoin dans la colonne Nom , puis recherchez et sélectionnez le lien PyPI dans la colonne Package . Par exemple, pour installer une version du azure-storage-blob package, vous pouvez utiliser : pip install azure-storage-blob==12.19.0.

conda

Veillez à ajouter le canal Microsoft à votre configuration conda (vous devez exécuter cette commande une seule fois) :

conda config --add channels "Microsoft"

Ensuite, installez le package et la version souhaités :

conda install <package>==<version>

Vous trouverez les numéros de version sur le canal Microsoft sur anaconda.org. Les packages Azure ont des noms qui commencent par azure-. Recherchez la bibliothèque/le package souhaité, explorez-le et recherchez le numéro de version sous l’onglet « Fichiers ». Par exemple, pour installer une version de azure-storage vous pouvez utiliser : conda install azure-storage=2023.09.01. Vous pouvez également spécifier la version souhaitée sur la ligne de commande avec conda install --revision.

Installer des packages en préversion

pip

Pour installer la dernière préversion d’un package, incluez l’indicateur --pre sur la ligne de commande.

pip install --pre <package>

Microsoft publie régulièrement des packages en préversion qui prennent en charge les fonctionnalités à venir. Les packages en préversion sont fournis avec la mise en garde que le package est susceptible de changer et ne doit pas être utilisé dans les projets de production.

Vous pouvez utiliser n’importe quel nom de package listé dans l’index des packages.

conda

Les packages en préversion pour conda ne sont pas disponibles pour l’instant.

Vérifier l’installation d’un package

pip

Pour vérifier une installation de package :

pip show <package>

Si le package est installé, pip show affiche sa version, entre autres informations. S’il n’est pas installé, la commande n’affiche rien.

Vous pouvez également utiliser pip freeze ou pip list afficher tous les packages installés dans votre environnement Python actuel.

Vous pouvez utiliser n’importe quel nom de package listé dans l’index des packages.

conda

Pour vérifier une installation de package :

conda list <package>

Si le package est installé, conda list affiche sa version, entre autres informations. S’il n’est pas installé, la commande n’affiche rien.

Vous pouvez également utiliser conda list pour afficher tous les packages installés dans votre environnement Conda actuel.

Vous pouvez utiliser n’importe quel nom de package listé dans le canal Microsoft sur anaconda.org. Les packages Azure portent des noms qui commencent par azure-.

Désinstaller un package

pip

Pour désinstaller un package :

pip uninstall <package>

Vous pouvez utiliser n’importe quel nom de package listé dans l’index des packages.

conda

Pour désinstaller un package :

conda remove <package>

Vous pouvez utiliser n’importe quel nom de package listé dans le canal Microsoft sur anaconda.org. Les packages Azure portent des noms qui commencent par azure-.