Uso delle librerie Azure (SDK) per Python

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

I dettagli che vuoi davvero sapere

• Usare le librerie di Azure per comunicare con i servizi Azure da codice Python eseguito in locale o nel cloud. La possibilità di eseguire Python codice nell'ambito di un determinato servizio dipende dal fatto che tale servizio attualmente supporti Python.

• Le librerie supportano Python 3.9 o versione successiva. Per altre informazioni sulle versioni supportate di Python, vedere Azure SDKs Python version support policy. Se si usa PyPy, assicurarsi che la versione usata supporti almeno la versione Python menzionata in precedenza.

• Il Azure SDK per Python è composto esclusivamente da oltre 180 singole librerie Python correlate a specifici servizi di Azure. Non sono disponibili 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 per Azure servizi usando il Azure SDK per Python.

• Per installare i pacchetti di libreria con pip, utilizzare pip install <library_name> utilizzando i nomi delle librerie dall'indice dei pacchetti. Per installare i pacchetti di libreria in ambienti conda, usare conda install <package_name> usando nomi del canale Microsoft in anaconda.org. Per altre informazioni, vedere Installare pacchetti di libreria Azure.

• Sono disponibili librerie client e di gestione distinte (talvolta denominate "piano di gestione" e "piano dati"). Ogni set svolge scopi diversi e viene usato da diversi tipi di codice. Per altre informazioni, vedere le sezioni seguenti più avanti in questo articolo:

  • Creare e gestire le risorse di Azure con librerie di gestione
  • Connettersi e utilizzare le risorse di Azure con le librerie client

• È possibile trovare la documentazione per le librerie nel Azure per Python Reference, organizzato per Azure Service o Python api browser, organizzato in base al nome del pacchetto.

• Per provare manualmente le librerie, configurare prima di tutto l'ambiente di sviluppo locale. È quindi possibile provare uno degli esempi autonomi seguenti (in qualsiasi ordine): Example: Creare un gruppo di risorse, Example: Creare e usare Azure Storage, Example: Creare e distribuire un'app Web, Example: Creare ed eseguire query su un database MySQL, e Example: Creare una macchina virtuale.

• Per i video dimostrativi, vedere Introducing the Azure SDK for Python (PyCon 2021) and Using Azure SDKs to interact with Azure resources (PyCon 2020).

Dettagli non essenziali ma comunque interessanti

• Poiché il Azure CLI viene scritto in Python e usa le librerie di gestione, è possibile eseguire qualsiasi operazione con i comandi Azure CLI che è possibile eseguire anche da uno script di Python. I comandi dell'interfaccia della riga di comando offrono molte funzionalità utili, ad esempio l'esecuzione di più attività insieme, la gestione automatica delle operazioni asincrone, la formattazione dell'output come le stringhe di connessione e altro ancora. Pertanto, l'uso dell'interfaccia della riga di comando (o del relativo equivalente, Azure PowerShell) per la creazione automatica e gli script di gestione 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 sottostante Azure, quindi è possibile usare tali API tramite paradigmi di Python familiari. Tuttavia, è sempre possibile usare l'API REST direttamente dal codice Python, se necessario.

• È possibile trovare il codice sorgente per le librerie di Azure in https://github.com/Azure/azure-sdk-for-python. Come progetto open source, i contributi sono benvenuti!

• Sebbene sia possibile usare le librerie con interpreti come IronPython e Jython, che Microsoft non testa, potrebbero verificarsi problemi isolati e incompatibilità.

• Il repository di origine per la documentazione di riferimento dell'API di libreria risiede in https://github.com/MicrosoftDocs/azure-docs-sdk-python/.

• A partire dal 2019, Microsoft ha aggiornato le librerie di Azure Python per condividere modelli cloud comuni, come i protocolli di autenticazione, il log, il tracciamento, i protocolli di trasporto, le risposte bufferizzate e i tentativi. Le librerie aggiornate sono conformi alle linee guida current Azure SDK.

  • Il 31 marzo 2023 Microsoft ha ritirato il supporto per le librerie di Azure SDK non conformi alle linee guida correnti Azure SDK. Anche se le librerie meno recenti possono ancora essere usate oltre il 31 marzo 2023, non ricevono più il supporto e gli aggiornamenti ufficiali da Microsoft. Per altre informazioni, vedere l'avviso Aggiornare le librerie di Azure SDK.

  • Per evitare di perdere aggiornamenti di sicurezza e prestazioni per gli SDK di Azure, eseguire l'aggiornamento alle ultime librerie SDK di Azure entro il 31 marzo 2023.

  • Per verificare quali librerie Python sono interessate, vedere Azure SDK Versioni deprecate per Python.

• Per informazioni dettagliate sulle linee guida che Microsoft si applica alle librerie, vedere le linee guida Python: Introduzione.

Creare e gestire Azure risorse con librerie di gestione

Librerie management (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 Azure dagli script di Python. Tutti i servizi Azure dispongono di librerie di gestione corrispondenti. Per altre informazioni, vedere Azure piano di controllo e piano dati.

Usando le librerie di gestione, è possibile scrivere script di configurazione e distribuzione per eseguire le stesse attività che è possibile eseguire tramite il portale Azure o Azure CLI. Come indicato in precedenza, il Azure CLI viene scritto in Python e usa le librerie di gestione per implementare i vari comandi.

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

• Creare un gruppo di risorse
• Elencare i gruppi di risorse in una sottoscrizione
• Creare un account di Azure Storage e un contenitore di archiviazione BLOB
• Creare e distribuire un'app Web in App Service
• Creare ed eseguire query su un database MySQL Azure
• Creare una macchina virtuale

Per informazioni dettagliate sull'uso di ogni libreria di gestione, vedere il file README.md o README.rst che si trova nella cartella del progetto della libreria nella SDK GitHub repository. È anche possibile trovare altri frammenti di codice nella documentazione reference e Azure Samples.

Migrazione da librerie di gestione meno recenti

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

• Se si usa la classe ServicePrincipalCredentials, vedere Autenticarsi con credenziali token.
• I nomi delle API asincrone sono stati modificati come descritto in Modelli di utilizzo della libreria - 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 Azure con le librerie client

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

L'articolo Example: Usare Azure Storage fornisce un'illustrazione di base dell'uso di una libreria client.

Diversi servizi di Azure forniscono anche esempi che usano queste librerie. Per altri collegamenti, vedere le pagine di indice seguenti:

• Hosting di app
• Servizi cognitivi
• Soluzioni per i dati
• Identità e sicurezza
• Apprendimento automatico
• Messaggistica e IoT
• Altri servizi

Per informazioni dettagliate sull'uso di ogni libreria client, consultare il file README.md o README.rst che si trova nella cartella del progetto della libreria nel repository GitHub del SDK. È anche possibile trovare altri frammenti di codice nella documentazione reference e Azure Samples.

Ottenere assistenza e connettersi al team SDK

• Consulta la documentazione delle librerie Azure per Python
• Inviare domande alla community su Stack Overflow
• Problemi aperti relativi all'SDK su GitHub
• Menzionare @AzureSDK su Twitter
• Complete un breve sondaggio sul Azure SDK per Python

Passo successivo

Configurare l'ambiente di sviluppo locale in modo da poter usare facilmente qualsiasi libreria di Azure per Python.

Configurare l'ambiente di sviluppo locale >>>