Usare Jupyter Notebook in un'area di lavoro di Azure Quantum

Informazioni su come eseguire Q# o codice Python in un Jupyter Notebook in un'area di lavoro di Azure Quantum. Un Jupyter Notebook è un documento che contiene sia testo rtf che codice e può essere eseguito nel browser.

Prerequisiti

Per usare Jupyter Notebook in un'area di lavoro di Azure Quantum, sono necessari i prerequisiti seguenti.

• Un account Azure con una sottoscrizione attiva. Se non si ha un account Azure, registrarsi gratuitamente e iscriversi per ottenere una sottoscrizione con pagamento in base al consumo.
• Un'area di lavoro di Azure Quantum. Vedere Creare un'area di lavoro di Azure Quantum.

Ottenere un notebook di esempio

Per iniziare, è possibile usare un notebook di esempio dalla raccolta di esempi.

1. Selezionare l'area di lavoro di Azure Quantum nel portale di Azure.

2. Selezionare Notebook.

3. Selezionare Sample gallery (Raccolta di esempi).

4. Selezionare l'esempio da usare e selezionare Copia nei notebook.

   

Il notebook di esempio è disponibile in I miei notebook ed è ora possibile eseguire il notebook.

Eseguire un notebook

Per eseguire o codice Q# Python in un Jupyter Notebook, seguire questa procedura.

1. Selezionare l'area di lavoro di Azure Quantum nel portale di Azure.

2. Selezionare Notebook.

3. Selezionare il notebook in I miei notebook.

4. Selezionare la cella da eseguire e selezionare l'icona di esecuzione per eseguire il codice nella cella oppure selezionare Esegui tutto per eseguire tutte le celle del notebook.

   

Creare un nuovo notebook

Seguire questa procedura per creare una nuova Jupyter Notebook usando Q# o Python.

1. Selezionare l'area di lavoro di Azure Quantum nel portale di Azure.

2. Selezionare Notebook.

3. Selezionare I miei notebook e quindi Aggiungi nuovo

   

4. Digitare un nome file e selezionare Crea file.

La prima cella del notebook viene popolata automaticamente con la stringa di connessione nell'area di lavoro di Azure Quantum.

Selezionare + Codice o + Markdown per aggiungere un codice o una cella di testo di markdown.

Suggerimento

Un notebook viene salvato automaticamente ogni 30 secondi. È anche possibile salvarli manualmente premendo CTRL+S.

Caricare notebook

È possibile caricare uno o più jupyter Notebook esistenti in un'area di lavoro di Azure Quantum.

Attenzione

È consigliabile caricare ed eseguire Jupyter Notebook solo da origini attendibili e installare solo i pacchetti da origini attendibili. Sebbene i notebook in Azure Quantum proteggano l'utente tramite la sandbox degli output, Jupyter Notebook è progettato per l'esecuzione arbitraria del codice, quindi vi sono rischi intrinseci per il caricamento o l'esecuzione di notebook da un'origine non attendibile.

1. Selezionare l'area di lavoro di Azure Quantum nel portale di Azure.

2. Selezionare Notebook.

3. Selezionare I miei notebook.

4. Selezionare Carica ora.

5. Trascinare e rilasciare i file del notebook oppure selezionare Sfoglia elenco file e selezionare i file del notebook da caricare.

6. Se si desidera sovrascrivere file già esistenti, selezionare Overwrite if already exists (Sovrascrivi se esiste già).

7. Selezionare Upload files (Carica file).

   

Dopo aver caricato i notebook, è possibile trovarli in I miei notebook.

Nota

Se si carica un notebook salvato da un'altra area di lavoro di Azure Quantum, potrebbe essere necessario aggiornare le informazioni di connessione, ad esempio Sottoscrizione, Gruppo di risorse, nome area di lavoro, Posizione o ID risorsa, prima di eseguire il notebook.

Gestire i notebook

È possibile rinominare, eliminare, duplicare e scaricare i notebook esistenti.

1. Selezionare l'area di lavoro di Azure Quantum nel portale di Azure.

2. Selezionare Notebook.

3. Selezionare il notebook in Notebook personali

4. Fare clic sul riquadro di contesto, che è ... a destra del nome del notebook.

5. Selezionare Rinomina notebook, Elimina notebook, Duplica notebook o Scarica notebook.

   

Isolamento

I notebook Jupyter in aree di lavoro di Azure Quantum sono isolati dai notebook di altri utenti.

• L'istanza di Jupyter Notebook è ospitata da Azure Quantum con isolamento a livello di hypervisor dalle istanze di altri utenti.
• I notebook vengono archiviati nell'account di archiviazione collegato nella sottoscrizione.
• Un'istanza di Jupyter Notebook ha come ambito una combinazione di utenti e un'area di lavoro specifica. Se si visita un'altra area di lavoro, si otterrà un'istanza di Jupyter Notebook diversa. Se un altro utente visita la stessa area di lavoro, otterrà un'istanza di Jupyter Notebook diversa da quella dell'utente.
• L'ambito dei notebook è quello dell'utente e di un'area di lavoro specifica. Se si visita un'altra area di lavoro, gli stessi notebook non verranno visualizzati in Blocchi appunti personali. Se un altro utente visita tale area di lavoro, non visualizzerà i blocchi appunti.

Archiviazione di notebook

I notebook di Jupyter vengono archiviati in un account di archiviazione di Azure collegato all'area di lavoro di Azure Quantum.

Nota

Quando viene creata un'area di lavoro di Azure Quantum, corS (Cross-Origin Resource Sharing) in abilitata nell'account di archiviazione di Azure collegato. Questa operazione è necessaria per l'uso di Jupyter Notebook nel portale. Se non si prevede di usare Jupyter Notebook nel portale e non si vuole abilitare CORS per l'account di archiviazione di Azure, è possibile modificare direttamente l'account di archiviazione per rimuovere la regola CORS. Nelle proprietà dell'account di archiviazione, in Impostazioni selezionare Condivisione risorse (CORS) e rimuovere la regola in Servizio file. Tenere presente che se si apre nuovamente il pannello Notebook nell'area di lavoro, la regola verrà ricreata automaticamente.

Limitazioni

Di seguito sono riportate le limitazioni relative ai notebook di Jupyter in un'area di lavoro di Azure Quantum.

• Poiché è gratuito, l'istanza di Jupyter Notebook avrà un massimo di 12 ore (dopo tale periodo, l'istanza verrà eliminata o ricreata ed è necessario reinstallare eventuali pacchetti personalizzati).
• Azure Quantum potrebbe dover eliminare l'istanza di Jupyter Notebook per applicare patch di sicurezza o implementare modifiche di emergenza. Quando possibile, il flusso di lavoro non verrà interrotto.
• Nelle istanze di notebook sono preallocati 2 vCPU e 4 GB di memoria.
• I kernel inattivi vengono terminati dopo 30 minuti. Dopo tale periodo, sarà necessario eseguire di nuovo le celle.
• La posizione dell'account di archiviazione e dell'area di lavoro influirà sulle prestazioni dei notebook di Jupyter in un'area di lavoro di Azure Quantum. Quando possibile, provare a creare l'account di archiviazione e l'area di lavoro in un'area vicina a quella d'uso dei notebook.
• Non possono essere aperti più di 10 notebook contemporaneamente in un'area per ogni sottoscrizione. Per aprire più di 10 notebook contemporaneamente, è necessario distribuire le aree di lavoro in più aree.
• Un singolo utente può aprire contemporaneamente non più di cinque notebook in un'area per ogni sottoscrizione.

Passaggi successivi

• Introduzione a Q# e a un notebook di Azure Quantum
• Guida introduttiva: Inviare un circuito con Qiskit