Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Notebook Utilities (NotebookUtils) to wbudowany pakiet ułatwiający wykonywanie typowych zadań w Fabric Notebook. Narzędzia NotebookUtils umożliwiają pracę z systemami plików, uzyskiwanie zmiennych środowiskowych, łączenie notesów i pracę z wpisami tajnymi. Pakiet NotebookUtils jest dostępny w potokach PySpark (Python) Scala, SparkR notebooks i Fabric.
Note
- Nazwa narzędzia MsSparkUtils została oficjalnie zmieniona na NotebookUtils. Istniejący kod pozostaje zgodny z poprzednimi wersjami i nie powoduje żadnych zmian powodujących niezgodność. Zdecydowanie zaleca się uaktualnienie do narzędzia notebookutils, aby zapewnić ciągłą obsługę i dostęp do nowych funkcji. Przestrzeń nazw mssparkutils zostanie wycofana w przyszłości.
- NotebookUtils jest przeznaczony do pracy z platformą Spark 3.4 (środowiskiem uruchomieniowym v1.2) i późniejszymi wersjami. Wszystkie nowe funkcje i aktualizacje będą odtąd wspierane wyłącznie w przestrzeni nazw notebookutils.
Moduły NotebookUtils
NotebookUtils udostępnia następujące moduły. Wybierz moduł, aby wyświetlić szczegółową dokumentację, przykłady kodu i najlepsze rozwiązania.
| Moduł | Namespace | Opis |
|---|---|---|
| Narzędzia systemu plików | notebookutils.fs |
Praca z plikami i katalogami w usługach ADLS Gen2, Azure Blob Storage i Lakehouse Storage. Obejmuje operacje kopiowania, przenoszenia, odczytu, zapisu, usuwania i listy. |
| Instalowanie i odinstalowywanie plików | notebookutils.fs |
Dołącz zdalny magazyn (ADLS Gen2) do węzłów platformy Spark jako lokalne punkty instalacji w celu uzyskania uproszczonego dostępu do plików. |
| Orkiestracja i uruchomienie notatnika | notebookutils.notebook |
Uruchamianie i łączenie notesów łańcuchowych, w tym wykonywanie równoległe z obsługą języka DAG, odwołaniami między obszarami roboczymi i wartościami zakończenia. |
| Zarządzanie notesami | notebookutils.notebook |
Programowe tworzenie, pobieranie, aktualizowanie, usuwanie i wyświetlanie artefaktów notatnika. |
| Narzędzia poświadczeń | notebookutils.credentials |
Uzyskiwanie tokenów dostępu dla usług Azure i pobieranie tajemnic z usługi Azure Key Vault. |
| Narzędzia Lakehouse | notebookutils.lakehouse |
Programowe tworzenie, pobieranie, aktualizowanie i usuwanie elementów oraz tabel usługi Lakehouse, a także zarządzanie nimi z użyciem programowego interfejsu. |
| Kontekst środowiska uruchomieniowego | notebookutils.runtime |
Uzyskaj dostęp do informacji o kontekście sesji, w tym nazwy notatnika, szczegółów przestrzeni roboczej i kontekstu wykonywania. |
| Zarządzanie sesjami | notebookutils.session |
Zatrzymaj sesje interakcyjne i uruchom ponownie interpreter języka Python. |
| Narzędzia funkcji danych użytkownika (UDF) | notebookutils.udf |
Pobieranie i wywoływanie funkcji danych użytkownika z notesów. |
| Narzędzia biblioteki zmiennych | notebookutils.variableLibrary |
Dostęp do centralnie zarządzanych zmiennych i konfiguracji z elementów biblioteki zmiennych. |
Aby uzyskać przegląd wszystkich dostępnych modułów i metod, uruchom polecenie:
notebookutils.help()
Aby uzyskać pomoc dotyczącą określonego modułu, wykonaj polecenie:
notebookutils.fs.help()
notebookutils.notebook.help()
notebookutils.credentials.help()
Znane problemy
- W przypadku korzystania z wersji środowiska uruchomieniowego powyżej wersji 1.2 i uruchamiania
notebookutils.help()wymienione interfejsy API fabricClient i PBIClient nie są jeszcze obsługiwane, ale będą one dostępne w przyszłej wersji.