Praca z notesami Jupyter Notebook w obszarze roboczym usługi Azure Quantum

Dowiedz się, jak uruchamiać Q# kod w języku Python w Jupyter Notebook w obszarze roboczym usługi Azure Quantum. Jupyter Notebook to dokument zawierający zarówno tekst sformatowany, jak i kod, który można uruchomić w przeglądarce.

Wymagania wstępne

Potrzebne są następujące wymagania wstępne dotyczące korzystania z notesów Jupyter Notebook w obszarze roboczym usługi Azure Quantum.

Pobieranie przykładowego notesu

Aby rozpocząć pracę, możesz użyć przykładowego notesu z galerii przykładowej.

  1. Wybierz obszar roboczy usługi Azure Quantum w Azure Portal.

  2. Wybierz pozycję Notesy.

  3. Wybierz pozycję Galeria przykładów.

  4. Wybierz przykład, którego chcesz użyć, a następnie wybierz pozycję Kopiuj do moich notesów.

    Zrzut ekranu przedstawiający przykładową galerię Jupyter Notebook przedstawiającą sposób kopiowania notesu w galerii.

Przykładowy notes można znaleźć w obszarze Moje notesy i można teraz uruchomić notes.

Uruchamianie notesu

Aby uruchomić Q# lub kod języka Python w Jupyter Notebook, wykonaj następujące kroki.

  1. Wybierz obszar roboczy usługi Azure Quantum w Azure Portal.

  2. Wybierz pozycję Notesy.

  3. Wybierz notes w obszarze Moje notesy.

  4. Wybierz komórkę, którą chcesz uruchomić, i wybierz ikonę przebiegu , aby uruchomić kod w komórce, lub wybierz pozycję Uruchom wszystko , aby uruchomić wszystkie komórki w notesie.

    Zrzut ekranu przedstawiający notes Jupyter przedstawiający sposób jego uruchamiania.

Tworzenie nowego notesu

Wykonaj następujące kroki, aby utworzyć nową Jupyter Notebook przy użyciu języka Q# Python lub języka Python.

  1. Wybierz obszar roboczy usługi Azure Quantum w Azure Portal.

  2. Wybierz pozycję Notesy.

  3. Wybierz pozycję Moje notesy i wybierz pozycję Dodaj nowy

    Zrzut ekranu przedstawiający sposób tworzenia nowego notesu Jupyter w Azure Portal.

  4. Wpisz nazwę pliku i wybierz pozycję Utwórz plik.

Pierwsza komórka notesu jest wypełniana automatycznie parametry połączenia do obszaru roboczego usługi Azure Quantum.

Zrzut ekranu przedstawiający pierwszą komórkę w nowym notesie języka Python w usłudze Azure Quantum.

Wybierz pozycję + Kod lub + Markdown , aby dodać kod lub komórkę tekstową markdown.

Porada

Notes jest zapisywany automatycznie co 30 sekund. Możesz również ręcznie zapisać, naciskając klawisze CTRL + S.

Przekazywanie notesów

Możesz przekazać jeden lub więcej istniejących notesów Jupyter Notebook do obszaru roboczego usługi Azure Quantum.

Przestroga

Należy przekazywać i uruchamiać tylko notesy Jupyter Notebook z zaufanych źródeł i instalować tylko pakiety z zaufanych źródeł. Notesy w usłudze Azure Quantum chronią Cię przez dane wyjściowe piaskownicy, ale notesy Jupyter Notebooks są tworzone na potrzeby dowolnego wykonywania kodu, dlatego istnieją pewne zagrożenia związane z przekazywaniem lub uruchamianiem notesów z niezaufanego źródła.

  1. Wybierz obszar roboczy usługi Azure Quantum w Azure Portal.

  2. Wybierz pozycję Notesy.

  3. Wybierz pozycję Moje notesy.

  4. Wybierz pozycję Przekaż nowy.

  5. Przeciągnij i upuść pliki notesu lub wybierz pozycję Przeglądaj dla plików i wybierz pliki notesu, które chcesz przekazać.

  6. Jeśli chcesz zastąpić już istniejące pliki, wybierz pozycję Zastąp, jeśli już istnieje.

  7. Wybierz pozycję Przekaż pliki.

    Zrzut ekranu przedstawiający sposób przekazywania notesu do usługi Azure Quantum.

Po przekazaniu notesów można je znaleźć w obszarze Moje notesy.

Uwaga

Jeśli przekazujesz notes zapisany w innym obszarze roboczym usługi Azure Quantum, może być konieczne zaktualizowanie informacji o połączeniu, takich jak subskrypcja, grupa zasobów, nazwa obszaru roboczego, lokalizacja lub identyfikator zasobu, przed uruchomieniem notesu.

Zarządzanie notesami

Możesz zmienić nazwę, usunąć, zduplikować i pobrać istniejące notesy.

  1. Wybierz obszar roboczy usługi Azure Quantum w Azure Portal.

  2. Wybierz pozycję Notesy.

  3. Wybierz notes w obszarze Moje notesy

  4. Kliknij okienko kontekstowe, czyli ... po prawej stronie nazwy notesu.

  5. Wybierz pozycję Zmień nazwę notesu, Usuń notes, Zduplikowany notes lub Pobierz notes.

    Zrzut ekranu przedstawiający okienko kontekstu notesu w usłudze Azure Quantum.

Izolacja

Notesy Jupyter w obszarze roboczym usługi Azure Quantum są odizolowane od notesów innych użytkowników.

  • Wystąpienie Jupyter Notebook jest hostowane przez usługę Azure Quantum z izolacją na poziomie funkcji hypervisor od wystąpień innych użytkowników.
  • Notesy są przechowywane na połączonym koncie magazynu w ramach subskrypcji.
  • Wystąpienie Jupyter Notebook ma zakres kombinacji i określonego obszaru roboczego. Jeśli odwiedzasz inny obszar roboczy, otrzymasz inne wystąpienie Jupyter Notebook. Jeśli inny użytkownik odwiedza ten sam obszar roboczy, otrzyma inne wystąpienie Jupyter Notebook niż ty.
  • Notesy są ograniczone do Ciebie i określonego obszaru roboczego. Jeśli odwiedzasz inny obszar roboczy, te same notesy nie będą wyświetlane w obszarze Moje notesy. Jeśli inny użytkownik odwiedza ten obszar roboczy, nie będzie widzieć notesów.

Przechowywanie notesów

Notesy Jupyter Są przechowywane na koncie usługi Azure Storage połączonym z obszarem roboczym usługi Azure Quantum.

Uwaga

Po utworzeniu obszaru roboczego usługi Azure Quantum udostępnianie zasobów między źródłami (CORS) jest włączone na połączonym koncie usługi Azure Storage. Jest to wymagane do korzystania z notesów Jupyter Notebook w portalu. Jeśli nie planujesz używania notesów Jupyter Notebook w portalu i nie chcesz włączać mechanizmu CORS dla konta usługi Azure Storage, możesz bezpośrednio edytować konto magazynu, aby usunąć regułę MECHANIZMU CORS. We właściwościach konta magazynu w obszarze Ustawienia wybierz pozycję Udostępnianie zasobów (CORS) i usuń regułę w obszarze Usługa plików. Pamiętaj, że jeśli ponownie otworzysz blok Notesy w obszarze roboczym, reguła zostanie ponownie utworzona automatycznie.

Ograniczenia

Poniżej przedstawiono ograniczenia dotyczące notesów Jupyter Notebook w obszarze roboczym usługi Azure Quantum.

  • Ponieważ jest to bezpłatne, wystąpienie Jupyter Notebook będzie działać do maksymalnie 12 godzin (po tym czasie wystąpienie zostanie usunięte lub ponownie utworzone i będzie konieczne ponowne zainstalowanie wszystkich pakietów niestandardowych).
  • Usługa Azure Quantum może wymagać usunięcia wystąpienia Jupyter Notebook w celu zastosowania poprawek zabezpieczeń lub wprowadzenia zmian awaryjnych. Jeśli to możliwe, przepływ pracy nie zostanie przerwany.
  • Wystąpienia notesów mają wstępnie przydzielone 2 procesory wirtualne i 4 GB pamięci.
  • Bezczynne jądra są przerywane po upływie 30 minut. Po tym czasie należy ponownie uruchomić komórki.
  • Lokalizacja konta magazynu i obszaru roboczego wpłynie na wydajność notesów Jupyter Notebook w obszarze roboczym usługi Azure Quantum. Jeśli to możliwe, spróbuj utworzyć konto magazynu i obszar roboczy w regionie zbliżonym do miejsca, w którym będziesz używać notesów.
  • Nie można jednocześnie otworzyć więcej niż 10 notesów w jednym regionie na subskrypcję. Aby jednocześnie otworzyć ponad 10 notesów, należy wdrożyć obszary robocze w wielu regionach.
  • Jeden użytkownik może otworzyć nie więcej niż pięć notesów jednocześnie w jednym regionie na subskrypcję.

Następne kroki