Jak używać notesów usługi Microsoft Fabric

Notes usługi Microsoft Fabric to podstawowy element kodu służący do tworzenia zadań platformy Apache Spark i eksperymentów uczenia maszynowego. Jest to interaktywna powierzchnia internetowa używana przez analityków danych i inżynierów danych do pisania kodu korzystającego z zaawansowanych wizualizacji i tekstu markdown. Inżynierowie danych piszą kod na potrzeby pozyskiwania danych, przygotowywania danych i przekształcania danych. Analitycy danych używają również notesów do tworzenia rozwiązań uczenia maszynowego, w tym tworzenia eksperymentów i modeli, śledzenia modeli i wdrażania.

Notes usługi Fabric umożliwia:

  • Rozpocznij pracę z zerowym nakładem pracy nad konfiguracją.
  • Łatwe eksplorowanie i przetwarzanie danych przy użyciu intuicyjnego środowiska z małą ilością kodu.
  • Zabezpieczanie danych za pomocą wbudowanych funkcji zabezpieczeń przedsiębiorstwa.
  • Analizowanie danych w formatach pierwotnych (CSV, txt, JSON itp.), przetworzonych formatów plików (parquet, Delta Lake itp.), przy użyciu zaawansowanych funkcji platformy Spark.
  • Wydajniej dzięki ulepszonym funkcjom tworzenia i wbudowanym wizualizacjom danych.

W tym artykule opisano sposób używania notesów w środowiskach nauki o danych i inżynierii danych.

Tworzenie notesów

Możesz utworzyć nowy notes lub zaimportować istniejący notes.

Tworzenie nowego notesu

Podobnie jak w przypadku innych standardowych procesów tworzenia elementów sieci szkieletowej, można łatwo utworzyć nowy notes ze strony głównej usługi Fabric inżynierowie danych ing, obszaru roboczego Nowa opcja lub Utwórz centrum.

Importowanie istniejących notesów

Możesz zaimportować jeden lub więcej istniejących notesów z komputera lokalnego do obszaru roboczego Sieć szkieletowa z inżynierowie danych lub strony głównej Nauka o danych. Notesy sieci szkieletowej rozpoznają standardowe pliki ipynb notesu Jupyter Notebook i pliki źródłowe, takie jak .py, scala i .sql, i odpowiednio tworzą nowe elementy notesu.

Zrzut ekranu przedstawiający miejsce znajdowania opcji notesu w menu Nowy.

Eksportowanie notesu

Notes można wyeksportować do innych standardowych formatów. Notes usługi Synapse można wyeksportować do:

  • Standardowy plik notesu (ipynb), który jest używany do notesów Jupyter.
  • Plik HTML (.html), który można otworzyć bezpośrednio z przeglądarki.
  • Plik języka Python (.py).
  • Plik lateksowy (.tex).

Zrzut ekranu przedstawiający miejsce eksportowania notesu.

Zapisywanie notesu

W sieci szkieletowej notes będzie domyślnie zapisywany automatycznie po otwarciu i edytowaniu; Nie musisz martwić się o utratę zmian kodu. Możesz również użyć polecenia Zapisz kopię , aby sklonować inną kopię w bieżącym obszarze roboczym lub w innym obszarze roboczym.

Zrzut ekranu przedstawiający miejsce zapisania kopii.

Jeśli wolisz ręcznie zapisać notes, możesz przełączyć się na opcję Zapisywanie ręczne , aby mieć lokalną gałąź elementu notesu, a następnie użyć opcji Zapisz lub CTRL+s , aby zapisać zmiany.

Zrzut ekranu przedstawiający miejsce przełączania ręcznego zapisywania.

Możesz również przełączyć się do trybu zapisywania ręcznego, wybierając pozycję Edytuj ->Zapisz opcje ->Manual. Aby włączyć lokalną gałąź notesu, a następnie zapisać go ręcznie, wybierz pozycję Zapisz lub użyj skrótu klawiaturowego Ctrl+s .

Połączenie lakehouses i notesy

Notesy sieci szkieletowej obsługują teraz bliskie interakcje z usługami lakehouse; Możesz łatwo dodać nowy lub istniejący lakehouse z eksploratora Lakehouse.

Możesz przejść do różnych jezior w eksploratorze Lakehouse i ustawić jeden lakehouse jako domyślny, przypinając go. Wartość domyślna jest następnie instalowana w katalogu roboczym środowiska uruchomieniowego i można odczytywać lub zapisywać w domyślnym magazynie lakehouse przy użyciu ścieżki lokalnej.

Zrzut ekranu przedstawiający miejsce przypinania domyślnej usługi Lakehouse.

Uwaga

Musisz ponownie uruchomić sesję po przypięeniu nowego lakehouse lub zmianie nazwy domyślnego lakehouse.

Dodawanie lub usuwanie jeziora

Wybranie ikony X obok nazwy lakehouse spowoduje usunięcie jej z karty notesu, ale element lakehouse nadal istnieje w obszarze roboczym.

Wybierz pozycję Dodaj lakehouse, aby dodać więcej magazynów lakehouse do notesu, dodając istniejący magazyn lub tworząc nowy magazyn lakehouse.

Eksplorowanie pliku lakehouse

Podfolder i pliki w sekcji Tabele i pliki widoku Lake są wyświetlane w obszarze zawartości między listą lakehouse a zawartością notesu. Wybierz różne foldery w sekcji Tabele i pliki , aby odświeżyć obszar zawartości.

Operacje na folderach i plikach

Jeśli wybierzesz plik (.csv, parquet, .txt, .jpg, .png itp.) za pomocą prawym przyciskiem myszy, możesz załadować dane przy użyciu interfejsu API Spark lub Pandas. Nowa komórka kodu jest generowana i wstawiana pod komórką fokusu.

Możesz łatwo skopiować ścieżkę z innym formatem niż wybrany plik lub folder i użyć odpowiedniej ścieżki w kodzie.

Zrzut ekranu przedstawiający menu kontekstowe plików w lakehouse.

Zasoby notesu

Eksplorator zasobów notesu udostępnia system plików podobny do systemu Unix, który ułatwia zarządzanie folderami i plikami. Oferuje on zapisywalną przestrzeń systemu plików, w której można przechowywać małe pliki, takie jak moduły kodu, modele semantyczne i obrazy. Dostęp do nich można łatwo uzyskać za pomocą kodu w notesie tak, jakby pracować z lokalnym systemem plików.

Animowany plik GIF zasobów notesu.

Ten wbudowany folder jest wstępnie zdefiniowanym folderem systemu dla każdego wystąpienia notesu. Zachowuje do 500 MB magazynu w celu przechowywania zależności bieżącego notesu. Są to kluczowe możliwości zasobów notesu:

  • Możesz użyć typowych operacji, takich jak tworzenie/usuwanie, przekazywanie/pobieranie, przeciąganie/upuszczanie, zmienianie nazwy, duplikowanie i wyszukiwanie za pośrednictwem interfejsu użytkownika.
  • Możesz użyć ścieżek względnych, takich jak builtin/YourData.txt na potrzeby szybkiej eksploracji. Metoda mssparkutils.nbResPath ułatwia tworzenie pełnej ścieżki.
  • Zweryfikowane dane można łatwo przenieść do magazynu lakehouse za pośrednictwem opcji Zapisuj do magazynu lakehouse . Sieć szkieletowa ma osadzone zaawansowane fragmenty kodu dla typowych typów plików, które ułatwiają szybkie rozpoczęcie pracy.
  • Te zasoby są również dostępne do użycia w przypadku uruchamiania notesu referencyjnego za pośrednictwem polecenia mssparkutils.notebook.run().

Uwaga

  • Obecnie usługa Fabric obsługuje przekazywanie niektórych typów plików za pośrednictwem interfejsu użytkownika, w tym .py, .whl, .jar, .txt, .json, .yml, .xml, .csv, .html, .png, .jpg i plików .xlsx. Możesz zapisać w folderze wbudowanym z typami plików, które nie znajdują się na liście za pomocą kodu, jednak notesy sieci szkieletowej nie obsługują generowania fragmentów kodu w nieobsługiwanych typach plików.
  • Każdy rozmiar pliku musi być mniejszy niż 50 MB, a wbudowany folder umożliwia łącznie maksymalnie 100 wystąpień plików/folderów.
  • W przypadku używania mssparkutils.notebook.run()mssparkutils.nbResPath polecenia użyj polecenia , aby uzyskać dostęp do docelowego zasobu notesu. Ścieżka względna "builtin/" zawsze wskazuje wbudowany folder notesu głównego.

Współpraca w notesie

Notes usługi Fabric to element współpracy, który obsługuje wielu użytkowników edytując ten sam notes.

Po otwarciu notesu domyślnie wprowadzasz tryb współedytowania, a każda edycja notesu jest zapisywana automatycznie. Jeśli współpracownicy otwierają ten sam notes w tym samym czasie, zobaczysz ich profil, uruchomić dane wyjściowe, wskaźnik kursora, wskaźnik wyboru i edytować ślad. Korzystając z funkcji współpracy, można łatwo wykonać programowanie par, zdalne debugowanie i scenariusze korepetycji.

Zrzut ekranu przedstawiający komórkę kodu z edycją innego użytkownika.

Udostępnianie notesu

Udostępnianie notesu jest wygodnym sposobem współpracy z członkami zespołu. Autoryzowane role obszaru roboczego mogą domyślnie wyświetlać lub edytować/uruchamiać notesy. Notes można udostępnić z przyznanymi określonymi uprawnieniami.

  1. Wybierz pozycję Udostępnij na pasku narzędzi notesu.

    Zrzut ekranu przedstawiający miejsce wybrania pozycji Udostępnij.

  2. Wybierz odpowiednią kategorię osób, które mogą wyświetlić ten notes. Możesz wybrać opcję Udostępnij, Edytuj lub Uruchom uprawnienia dla adresatów.

    Zrzut ekranu przedstawiający miejsce wybierania uprawnień.

  3. Po wybraniu pozycji Zastosuj możesz wysłać notes bezpośrednio lub skopiować link do innych osób. Adresaci mogą następnie otworzyć notes z odpowiednim widokiem przyznanym przez ich poziom uprawnień.

    Zrzut ekranu przedstawiający miejsce tworzenia i wysyłania linku.

  4. Aby dalej zarządzać uprawnieniami notesu, wybierz pozycję Lista>elementów obszaru roboczego Więcej opcji, a następnie wybierz pozycję Zarządzaj uprawnieniami. Na tym ekranie możesz zaktualizować istniejący dostęp do notesu i uprawnienia.

    Zrzut ekranu przedstawiający miejsce zarządzania uprawnieniami w obszarze roboczym.

Dodawanie komentarza do komórki kodu

Komentowanie to kolejna przydatna funkcja dla scenariuszy współpracy. Obecnie sieć szkieletowa obsługuje dodawanie komentarzy na poziomie komórki.

  1. Wybierz przycisk Komentarze na pasku narzędzi notesu lub wskaźnik komentarza komórki, aby otworzyć okienko Komentarze.

    Zrzut ekranu przedstawiający miejsce wybrania pozycji Komentarz.

  2. Wybierz kod w komórce kodu, wybierz pozycję Nowy w okienku Komentarze , dodaj komentarze, a następnie wybierz pozycję Opublikuj komentarz , aby zapisać.

    Zrzut ekranu przedstawiający miejsce wybrania pozycji Nowy.

  3. Jeśli są one potrzebne, znajdź opcje Edytuj komentarz, Rozwiąż wątek i Usuń wątek, wybierając opcję Więcej obok komentarza.

Tagowanie innych osób w komentarzu

"Tagowanie" odnosi się do wzmianki i powiadamiania użytkownika w wątku komentarza, zwiększając współpracę wydajnie na podstawie specyfiki.

  1. Wybierz sekcję kodu w komórce i nowy wątek komentarza.

  2. Wprowadź nazwę użytkownika i wybierz poprawną nazwę na liście sugestii, jeśli chcesz wspomnieć kogoś o dyskusji na temat określonej sekcji.

  3. Udostępnij swoje szczegółowe informacje i opublikuj je.

  4. Zostanie wyzwolone powiadomienie e-mail, a użytkownik kliknie link Otwórz komentarze , aby szybko zlokalizować tę komórkę.

  5. Ponadto autoryzuj i konfiguruj uprawnienia dla użytkowników podczas tagowania osoby, która nie ma dostępu, zapewniając, że zasoby kodu są dobrze zarządzane.

Animowany plik GIF oznaczający inne osoby w komentarzu.

Uwaga

W przypadku elementu komentarza otagowany użytkownik nie otrzyma już powiadomienia e-mail, jeśli zaktualizujesz komentarz w ciągu jednej godziny. Będzie jednak wysyłać powiadomienie e-mail do nowego oznakowanego użytkownika.

Przełączanie trybu notesu

Notesy sieci szkieletowej obsługują dwa tryby, które można łatwo przełączać między: tryb edycji i tryb wyświetlania .

Zrzut ekranu przedstawiający miejsce przełączania trybów.

  • Tryb edycji: możesz edytować i uruchamiać komórki oraz współpracować z innymi osobami w notesie.
  • Tryb wyświetlania: możesz wyświetlać tylko zawartość komórki, dane wyjściowe i komentarze notesu. Wszystkie operacje wprowadzane w notesie są wyłączone.