Arbeta med Jupyter Notebooks på en Azure Quantum-arbetsyta

  • Artikel

Lär dig hur du kör Q# eller Python-kod i en Jupyter Notebook på en Azure Quantum-arbetsyta. En Jupyter Notebook är ett dokument som innehåller både RTF och kod och kan köras i webbläsaren.

Förutsättningar

Du behöver följande förutsättningar för att använda Jupyter Notebooks på en Azure Quantum-arbetsyta.

Hämta en exempelanteckningsbok

För att komma igång kan du använda en exempelanteckningsbok från exempelgalleriet.

  1. Välj din Azure Quantum-arbetsyta i Azure Portal.

  2. Välj Notebook-filer.

  3. Välj Exempelgalleri.

  4. Välj det exempel som du vill använda och välj Kopiera till mina anteckningsböcker.

    Skärmbild av Jupyter Notebook-galleriet som visar hur du kopierar en anteckningsbok i galleriet.

Exempelanteckningsboken finns under Mina anteckningsböcker och du kan nu köra anteckningsboken.

Köra en notebook-fil

Följ dessa steg för att köra Q# eller Python-kod i en Jupyter Notebook.

  1. Välj din Azure Quantum-arbetsyta i Azure Portal.

  2. Välj Notebook-filer.

  3. Välj anteckningsboken i Mina anteckningsböcker.

  4. Markera cellen som du vill köra och välj körningsikonen för att köra koden i cellen, eller välj Kör alla för att köra alla celler i anteckningsboken.

    Skärmbild av en Jupyter-anteckningsbok som visar hur du kör den.

Skapa en ny notebook

Följ dessa steg för att skapa en ny Jupyter Notebook med hjälp av Q# eller Python.

  1. Välj din Azure Quantum-arbetsyta i Azure Portal.

  2. Välj Notebook-filer.

  3. Välj Mina anteckningsböcker och välj Lägg till ny

    Skärmbild som visar hur du skapar en ny Jupyter-anteckningsbok i Azure Portal.

  4. Skriv ett filnamn och välj Skapa fil.

Den första cellen i notebook-filen fylls i automatiskt med anslutningssträng till Azure Quantum-arbetsytan.

Skärmbild av den första cellen i en ny Python-anteckningsbok i Azure Quantum.

Välj + Kod eller + Markdown för att lägga till en kod eller markdown-textcell.

Tips

En notebook-fil sparas automatiskt var 30:e sekund. Du kan också spara manuellt genom att trycka på CTRL + S.

Ladda upp notebook-filer

Du kan ladda upp en eller flera befintliga Jupyter Notebooks till en Azure Quantum-arbetsyta.

Varning

Du bör bara ladda upp och köra Jupyter Notebooks från betrodda källor och endast installera paket från betrodda källor. Även om notebook-filer i Azure Quantum skyddar dig genom att sandbox-utdata skapas Jupyter Notebooks för godtycklig kodkörning, så det finns inneboende risker med att ladda upp eller köra notebook-filer från en ej betrodd källa.

  1. Välj din Azure Quantum-arbetsyta i Azure Portal.

  2. Välj Notebook-filer.

  3. Välj Mina anteckningsböcker.

  4. Välj Ladda upp ny.

  5. Dra och släpp notebook-filerna eller välj Bläddra efter filer och välj de notebook-filer som du vill ladda upp.

  6. Om du vill skriva över redan befintliga filer väljer du Skriv över om det redan finns.

  7. Välj Ladda upp filer.

    Skärmbild som visar hur du laddar upp en notebook-fil till Azure Quantum.

När notebook-filerna har laddats upp hittar du dem under Mina anteckningsböcker.

Anteckning

Om du laddar upp en notebook-fil som har sparats från en annan Azure Quantum-arbetsyta kan du behöva uppdatera anslutningsinformationen, till exempel Prenumeration, Resursgrupp, arbetsytenamn, Plats eller Resurs-ID innan du kör anteckningsboken.

Hantera anteckningsböcker

Du kan byta namn på, ta bort, duplicera och ladda ned befintliga notebook-filer.

  1. Välj din Azure Quantum-arbetsyta i Azure Portal.

  2. Välj Notebook-filer.

  3. Välj anteckningsboken i Mina anteckningsböcker

  4. Klicka på kontextfönstret, som är ... till höger om anteckningsbokens namn.

  5. Välj Byt namn på anteckningsbok, Ta bort anteckningsbok, Duplicera anteckningsbok eller Ladda ned anteckningsbok.

    Skärmbild av notebook-kontextfönstret i Azure Quantum.

Isolering

Jupyter Notebooks på en Azure Quantum-arbetsyta är isolerade från andra användares notebook-filer.

  • Din Jupyter Notebook-instans hanteras av Azure Quantum med isolering på hypervisor-nivå från andra användares instanser.
  • Notebook-filer lagras i ditt länkade lagringskonto i din prenumeration.
  • En Jupyter Notebook instans är begränsad till en kombination av dig och en specifik arbetsyta. Om du besöker en annan arbetsyta får du en annan Jupyter Notebook instans. Om en annan användare besöker samma arbetsyta får de en annan Jupyter Notebook instans än du.
  • Notebook-filer är begränsade till dig och en specifik arbetsyta. Om du besöker en annan arbetsyta visas inte samma anteckningsböcker under Mina anteckningsböcker. Om en annan användare besöker arbetsytan visas inte dina anteckningsböcker.

Lagring av notebook-filer

Jupyter Notebooks lagras i ett Azure Storage-konto som är länkat till din Azure Quantum-arbetsyta.

Anteckning

När en Azure Quantum-arbetsyta skapas aktiveras cors (Cross-Origin Resource Sharing) i på det länkade Azure Storage-kontot. Detta krävs för att använda Jupyter Notebooks i portalen. Om du inte planerar att använda Jupyter Notebooks i portalen och du inte vill aktivera CORS för ditt Azure Storage-konto kan du redigera ditt lagringskonto direkt för att ta bort CORS-regeln. I egenskaperna för lagringskontot går du till Inställningar och väljer Resursdelning (CORS) och tar bort regeln under Filtjänst. Tänk på att om du öppnar bladet Notebooks igen på arbetsytan återskapas regeln automatiskt.

Begränsningar

Följande är begränsningar med Jupyter Notebooks på en Azure Quantum-arbetsyta.

  • Eftersom det är kostnadsfritt kommer Jupyter Notebook-instansen att leva upp till högst 12 timmar (efter den tiden tas din instans bort eller återskapas och du måste installera om eventuella anpassade paket).
  • Azure Quantum kan behöva ta bort din Jupyter Notebook-instans för att tillämpa säkerhetskorrigeringar eller distribuera nödändringar. När det är möjligt avbryter det inte arbetsflödet.
  • Notebook-instanser har förallokerat 2 vCPU och 4 GB minne.
  • Inaktiva kernels avslutas efter 30 minuter. Efter det måste du köra cellerna igen.
  • Platsen för ditt lagringskonto och din arbetsyta påverkar prestandan för Jupyter Notebooks på en Azure Quantum-arbetsyta. När det är möjligt kan du försöka skapa lagringskontot och arbetsytan i en region nära där du kommer att använda dina notebook-filer.
  • Det får inte finnas fler än 10 notebook-filer öppna samtidigt i en region per prenumeration. Om du vill öppna fler än 10 notebook-filer samtidigt bör du distribuera arbetsytor i flera regioner.
  • En enskild användare kan inte öppna fler än fem notebook-filer samtidigt i en region per prenumeration.

Nästa steg