Przy tworzeniu notatnika wykorzystywane zasoby i biblioteki języka Python są dostępne za pośrednictwem środowiska wykonawczego notatnika. To środowisko wykonawcze jest wczytywane do kontenera notatnika przez administratora witryny. Dostępne są dwa środowiska wykonawcze: standardowe środowisko wykonawcze zawiera interfejs ArcGIS API for Python wraz z setkami innych bibliotek języka Python, a zaawansowane środowisko wykonawcze zawiera wszystkie te same biblioteki oraz dodatkowo pakiet ArcPy i niektóre powiązane biblioteki. To, które środowiska wykonawcze notatników są dostępne, zależy od posiadanych licencji i uprawnień.
Notatka:
Notatniki, które używają zaawansowanego środowiska wykonawczego, mogą uruchamiać interfejs ArcGIS API for Python i wszystkie pozostałe biblioteki wchodzące w skład standardowego środowiska wykonawczego.
Do środowisk wykonawczych przypisywany jest numer wersji na podstawie powiązanej wersji serwera ArcGIS Notebook Server:
| Wersja ArcGIS Notebook Server | Wersja manifestu | Data wycofania |
|---|---|---|
11.3 | 1 czerwca 2030 r. | |
11.2 | 1 listopada 2026 r. | |
11.1 | 1 maja 2029 r. | |
11.0 | 1 sierpnia 2025 r. | |
10.9.1 | 1 grudnia 2027 r. | |
10.9 | 1 czerwca 2024 r. | |
10.8.1 | 1 sierpnia 2026 r. | |
10.7.1 | 1 czerwca 2025 r. |
Na przykład standardowe środowisko wykonawcze dla wersji 11.3 ma nazwę ArcGIS Notebook Server Standard 10.0.
Aby umożliwić użytkownikowi tworzenie notatników, administrator musi przypisać mu niestandardową rolę członka zawierającą odpowiednie uprawnienia. Istnieje jedno uprawnienie do tworzenia notatników przy użyciu standardowego środowiska wykonawczego i inne uprawnienie do tworzenia notatników przy użyciu zaawansowanego środowiska wykonawczego.
Jeśli instytucja ma tylko dostępne standardowe środowisko wykonawcze, a użytkownikowi została przypisana rola zawierająca odpowiednie uprawnienia, można natychmiast rozpocząć tworzenie notatników.
Wybieranie środowiska wykonawczego notatnika
Przy tworzeniu pustego notatnika można dokonać wyboru środowisko wykonawczego, które będzie używane przez notatnik. Lista dostępnych środowisk wykonawczych zależy od posiadanych uprawnień. W przypadku uprawnień Notatniki zaawansowane do wyboru jest środowisko standardowe i zaawansowane, a także wszystkie dostępne środowiska niestandardowe. Środowisko wykonawcze notatnika można też zmienić po jego utworzeniu. W tym celu należy wykonać czynności opisane poniżej.
Notatka:
Jeśli w instytucji są dostępne oba środowiska wykonawcze, a administrator witryny przyznał uprawnienia do tworzenia notatników przy użyciu zaawansowanego środowiska wykonawczego, wszystkie utworzone notatniki będą domyślnie używać zaawansowanego środowiska wykonawczego.
Posiadając odpowiednie uprawnienia, możesz tworzyć notatniki wykorzystujące różne środowiska wykonawcze w konkretnych sytuacjach. Na przykład, gdy tworzysz notatnik w celu udostępnienia go innym twórcom notatników w swojej instytucji, którzy nie mają uprawnienia Notatniki zaawansowane, utwórz go z użyciem standardowego środowiska wykonawczego.
Przy tworzeniu po raz pierwszy notatnika używającego środowiska wykonawczego, które nie było wcześniej wykorzystywane, zostanie dla Ciebie uruchomiony nowy kontener. Kontener ten zawiera standardowe środowisko wykonawcze i jest odseparowany od Twojego pierwszego kontenera (zawierającego zaawansowane środowisko wykonawcze). Upewnij się, że administrator witryny jest o tym poinformowany, dzięki czemu w razie potrzeby jest on w stanie dostosować dostępne zasoby systemu.
Zmienianie środowiska wykonawczego notatnika
Zalecane jest zaktualizowanie środowiska wykonawczego notatnika, gdy jest dostępna nowa wersja, aby korzystać z najnowszych dostępnych bibliotek języka Python. Wykonaj poniższe czynności, aby zmienić środowisko wykonawcze zastosowane dla istniejącego notatnika. Ta procedura wykonywania zadań może zostać wykonana jedynie przez tych członków, którzy mają możliwość tworzenia notatników przy użyciu dowolnego środowiska wykonawczego notatnika.
Notatka:
Przed dokonaniem zmiany środowiska wykonawczego dla notatnika z zaawansowanego na standardowe upewnij się, że notatnik nie korzysta z bibliotek pakietu ArcPy ani innych bibliotek dostępnych tylko w zaawansowanym środowisku wykonawczym notatników. Po wywołaniu w notatniku ze standardowym środowiskiem wykonawczym notatników komórek korzystających z tych bibliotek zostanie wyświetlony błąd.
- Otwórz stronę szczegółów elementów notatnika i kliknij kartę Ustawienia.
W sekcji Notatnik na tej karcie, w obszarze Ustawienia notatnika opcja Środowisko wykonawcze notatnika określa środowisko wykonawcze używane przez notatnik.
- Kliknij listę rozwijalną i wybierz środowisko wykonawcze.
Notatka:
Jeśli nie masz uprawnienia Notatniki zaawansowane, na liście rozwijanej będzie widoczne tylko standardowe środowisko wykonawcze.
- Kliknij przycisk Zapisz, aby potwierdzić.
Teraz notatnik będzie używać standardowego środowiska wykonawczego i będzie mógł być udostępniany tym członkom, którzy mają dostęp do standardowego środowiska wykonawczego. Do hostowania tego notatnika jest uruchamiany drugi kontener. Pakiet ArcPy jest w tym notatniku niedostępny.
Instalowanie modułów podczas sesji
Podczas sesji notatnika autorzy notatników mogą przy użyciu systemu zarządzania pakietami Python udostępniać moduły języka conda lub wersje modułów, które nie znajdują się w żadnym ze środowisk wykonawczych. Zaleca się użycie systemu conda, ponieważ aplikacja ArcGIS Notebooks używa go do zarządzania modułami.
To podejście pozwala zainstalować żądany moduł w czasie trwania sesji notatnika. Po zamknięciu notatnika lub przerwaniu działania kontenera należącego do użytkownika moduł przestaje być dostępny. Aby instalować moduły tą metodą, musisz mieć połączenie internetowe z kanałem conda.
Notatka:
Kanał conda jest uwzględniony w obu środowiskach wykonawczych notatników. Nie jest konieczna jego instalacja.
Aby na przykład zainstalować pakiet scrapy w trakcie sesji, uruchom komórkę notatnika za pomocą jednego z następujących poleceń (w zależności od używanego systemu zarządzania pakietami):
W przypadku systemu zarządzania pakietami conda
!conda install --yes scrapyAby skorzystać z innej wersji modułu języka Python w używanym środowisku wykonawczym notatników, określ w poleceniu numer tej wersji.
Po uruchomieniu polecenia conda trzeba zrestartować jądro, aby nowy pakiet stał się dostępny.
Na przykład pewien pakiet jest dostępny w obu środowiskach wykonawczych notatników w wersji 1.5, ale chcesz użyć narzędzia wprowadzonego w wersji 1.6. Aby udostępnić wersję 1.6 pakietu w trakcie sesji notatnika, uruchom komórkę notatnika za pomocą jednego z poniższych poleceń (w zależności od używanego systemu zarządzania pakietami):
W przypadku systemu zarządzania pakietami conda
!conda install --yes <package name>==1.6