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.

• Per le versioni di Python supportate, vedere i criteri di supporto per le versioni di Python degli Azure SDK. Se si usa PyPy, usare una versione compatibile con una versione di Python supportata.

• 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 Archiviazione di Azure, 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 SDK to interact with Azure resources (PyCon 2020).

Dettagli non essenziali ma comunque interessanti

• Poiché il interfaccia della riga di comando di Azure viene scritto in Python e usa le librerie di gestione, è possibile eseguire qualsiasi operazione con i comandi interfaccia della riga di comando di Azure 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/.

• Le librerie Python di Azure condividono modelli cloud comuni, ad esempio protocolli di autenticazione, logging, tracing, protocolli di trasporto, risposte memorizzate nel buffer e ritentativi. Le librerie sono conformi alle linee guida correnti Azure SDK.

• 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 interfaccia della riga di comando di Azure. Come indicato in precedenza, il interfaccia della riga di comando di Azure 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 Archiviazione di Azure 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 Archiviazione di Azure 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.