Usare le librerie di Azure (SDK) per Python

Articolo
10/23/2023

Le librerie di Azure open source per Python semplificano il provisioning, la gestione e l'uso di risorse di Azure dal codice applicativo Python.

Informazioni che è necessario conoscere

Le librerie di Azure stabiliscono la modalità di comunicazione con i servizi di Azure dal codice Python eseguito localmente o nel cloud. Tenere presente che è possibile eseguire codice Python nell'ambito di un determinato servizio solo se tale servizio supporta attualmente Python.
Le librerie supportano Python 3.8 o versione successiva. Per altre informazioni sulle versioni supportate di Python, vedere Criteri di supporto delle versioni di Python per Azure SDK. Se si usa PyPy, assicurarsi che la versione usata supporti almeno la versione di Python indicata in precedenza.
Azure SDK per Python è costituito da oltre 180 singole librerie Python correlate a servizi specifici di Azure. Non sono presenti altri strumenti nell'SDK.
Quando si esegue il codice in locale, l'autenticazione con Azure si basa su variabili di ambiente, come descritto in Come autenticare le app Python nei servizi di Azure usando Azure SDK per Python.
Per installare i pacchetti di libreria con pip, usare pip install <library_name> i nomi di libreria dell'indice del pacchetto. Per installare i pacchetti di libreria in ambienti conda, usare conda install <package_name> i nomi del canale Microsoft in anaconda.org. Per altre informazioni, vedere Installare pacchetti di libreria di Azure.
Esistono librerie di gestione e client distinte (talvolta denominate librerie del "piano di gestione" e del "piano dati"). Ogni set serve a scopi diversi e viene usato da tipi di codice diversi. Per altre informazioni, vedere le sezioni seguenti più avanti in questo articolo:
- Creare e gestire le risorse di Azure con le librerie di gestione
- Connettersi e usare le risorse di Azure con le librerie client
La documentazione relativa alle librerie è disponibile nelle informazioni di riferimento di Azure per Python, organizzate in base a servizio di Azure, oppure nel browser delle API Python, organizzato in base al nome del pacchetto.
Per provare le librerie, è consigliabile prima di tutto configurare l'ambiente di sviluppo locale. È quindi possibile provare uno degli esempi autonomi seguenti (in qualsiasi ordine): Esempio: Creare un gruppo di risorse, Esempio: Creare e usare Archiviazione di Azure, Esempio: Creare e distribuire un'app Web, Esempio: Creare ed eseguire query su un database MySQL ed esempio: Creare una macchina virtuale.
Per i video dimostrativi, vedere Introduzione ad Azure SDK per Python (PyCon 2021) e Uso degli SDK di Azure per interagire con le risorse di Azure (PyCon 2020).

Dettagli non essenziali ma comunque interessanti

Poiché l'interfaccia della riga di comando di Azure è scritta in Python usando le librerie di gestione, è possibile eseguire qualsiasi operazione con i comandi dell'interfaccia della riga di comando di Azure che è possibile eseguire anche da uno script Python. Detto questo, i comandi dell'interfaccia della riga di comando offrono molte funzionalità utili, ad esempio l'esecuzione simultanea di più attività, la gestione automatica di operazioni asincrone, la formattazione dell'output come stringhe di connessione e così via. Pertanto, l'uso dell'interfaccia della riga di comando (o dell'equivalente, Azure PowerShell) per la creazione e gli script di gestione automatizzati può risultare più pratico rispetto alla scrittura del codice Python equivalente, a meno che non si voglia avere un grado di controllo molto più preciso sul processo.
Le librerie di Azure per Python si basano sull'API REST di Azure sottostante, consentendo di usare tali API tramite paradigmi Python noti. Tuttavia, se si preferisce, è sempre possibile usare l'API REST direttamente dal codice Python.
Il codice sorgente delle librerie di Azure è disponibile all'indirizzo https://github.com/Azure/azure-sdk-for-python. Essendo un progetto open source, i contributi sono benvenuti.
Anche se è possibile usare le librerie con interpreti come IronPython e Jython che non vengono testati, si potrebbero riscontrare incompatibilità e problemi isolati.
Il repository di origine per la documentazione di riferimento delle API delle librerie si trova all'indirizzo https://github.com/MicrosoftDocs/azure-docs-sdk-python/.
A partire dal 2019, sono state aggiornate le librerie Python di Azure per condividere modelli cloud comuni, ad esempio protocolli di autenticazione, registrazione, traccia, protocolli di trasporto, risposte memorizzate nel buffer e tentativi. Le librerie aggiornate rispettano le linee guida correnti di Azure SDK.
- Il 31 marzo 2023 è stato ritirato il supporto per le librerie di Azure SDK che non sono conformi alle linee guida correnti di Azure SDK. Anche se le librerie meno recenti possono ancora essere usate oltre il 31 marzo 2023, non riceveranno più il supporto e gli aggiornamenti ufficiali da Microsoft. Per altre informazioni, vedere l'avviso Aggiornare le librerie di Azure SDK.
- Per evitare aggiornamenti di sicurezza e prestazioni mancanti per gli SDK di Azure, eseguire l'aggiornamento alle librerie più recenti di Azure SDK entro il 31 marzo 2023.
- Per verificare quali librerie Python sono interessate, vedere Versioni deprecate di Azure SDK per Python.
Per informazioni dettagliate sulle linee guida applicate alle librerie, vedere Le linee guida per Python: Introduzione.

Creare e gestire le risorse di Azure con le librerie di gestione

Le librerie di gestione (o "piano di gestione") dell'SDK, i cui nomi iniziano tutti con azure-mgmt-, consentono di creare, configurare e gestire in altro modo le risorse di Azure dagli script Python. Per tutti i servizi di Azure sono disponibili librerie di gestione corrispondenti. Per altre informazioni, vedere Piano di controllo di Azure e piano dati.

Con le librerie di gestione è possibile scrivere script di configurazione e distribuzione per eseguire le stesse attività eseguibili tramite il portale di Azure o l'interfaccia della riga di comando di Azure. Come indicato in precedenza, l'interfaccia della riga di comando di Azure è scritta in Python e usa le librerie di gestione per implementare i vari comandi.

I seguenti esempi illustrano come usare alcune delle librerie di gestione primarie:

Per informazioni dettagliate sull'uso di ogni libreria di gestione, vedere il file README.md o README.rst disponibile nella cartella di progetto della libreria nel repository GitHub dell'SDK. È anche possibile trovare altri frammenti di codice nella documentazione di riferimento e negli esempi di Azure.

Migrazione dalle librerie di gestione precedenti

Se si esegue la migrazione del codice da versioni precedenti delle librerie di gestione, vedere i dettagli seguenti:

Se si usa la classe , vedere Eseguire l'autenticazione ServicePrincipalCredentials con le credenziali del token.
I nomi delle API asincrone sono stati modificati come descritto in Modelli di utilizzo delle librerie - Operazioni asincrone. I nomi delle API asincrone nelle librerie più recenti iniziano con begin_. Nella maggior parte dei casi, la firma dell'API rimane invariata.

Connettersi e usare le risorse di Azure con le librerie client

Le librerie client (o "piano dati") dell'SDK consentono di scrivere il codice applicativo Python per interagire con servizi di cui è già stato effettuato il provisioning. Le librerie client sono disponibili solo per i servizi che supportano un'API client.

L'articolo, Esempio: Usare Archiviazione di Azure, fornisce un'illustrazione di base dell'uso della libreria client.

Anche diversi servizi di Azure forniscono esempi di uso di queste librerie. Per altri collegamenti, vedere le pagine di indice seguenti:

Per informazioni dettagliate sull'uso di ogni libreria client, vedere il file README.md o README.rst disponibile nella cartella di progetto della libreria nel repository GitHub dell'SDK. È anche possibile trovare altri frammenti di codice nella documentazione di riferimento e negli esempi di Azure.

Ottenere assistenza e contattare il team dell'SDK

Vedere la documentazione delle librerie di Azure per Python
Pubblicare le domande per la community in Stack Overflow.
Aprire i problemi relativi all'SDK in GitHub
Menzionare @AzureSDK su Twitter
Completare un breve sondaggio su Azure SDK per Python

Passaggio successivo

È consigliabile eseguire una configurazione una tantum dell'ambiente di sviluppo locale in modo da usare facilmente qualsiasi libreria di Azure per Python.

Configurare l'ambiente di sviluppo locale >>>