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

Notatniki Microsoft Fabric to podstawowy element kodu do tworzenia zadań 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.

Z notatnikiem Fabric możesz:

• Rozpocznij bez potrzeby konfiguracji.
• Ł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.
• Pracuj wydajniej dzięki ulepszonym możliwościom tworzenia i wbudowanym wizualizacjom danych.

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

Kontekst zabezpieczeń działającego notebooka

Wykonywanie notatnika może być wyzwalane na trzy różne sposoby w usłudze Fabric, co pozwala na pełną elastyczność w dopasowaniu się do różnych scenariuszy.

• Uruchamianie interakcyjne: użytkownik ręcznie wyzwala wykonywanie za pośrednictwem różnych elementów interfejsu użytkownika lub wywołuje REST API. Proces będzie działać w kontekście zabezpieczeń bieżącego użytkownika.
• Uruchom jako działanie pipeline: Wykonanie jest wyzwalane z pipeline'u usługi Fabric Data Factory. Szczegółowe kroki można znaleźć w działaniu notesu. Wykonanie będzie wykonywane w kontekście użytkownika, który ostatnio zmodyfikował potok.
• Harmonogram: Uruchomienie jest wyzwalane z planu harmonogramu. Wykonanie będzie uruchamiane w kontekście zabezpieczeń użytkownika, który konfiguruje/aktualizuje plan harmonogramu.

Elastyczność tych opcji wykonywania z różnymi kontekstami zabezpieczeń umożliwia spełnienie różnych scenariuszy i wymagań, ale także wymaga, aby podczas projektowania i opracowywania notesu pamiętać o kontekście zabezpieczeń, w przeciwnym razie może to spowodować nieoczekiwane zachowanie, a nawet niektóre problemy z zabezpieczeniami.

Przy pierwszym utworzeniu notesu zostanie wyświetlony komunikat ostrzegawczy przypominający o ryzyku uruchomienia kodu bez jego przeglądania.

Poniżej przedstawiono kilka najlepszych rozwiązań, które ułatwiają uniknięcie problemów z zabezpieczeniami:

• Przed ręcznym uruchomieniem notesu otwórz ustawienia notesu i sprawdź sekcję Szczegóły w panelu Informacje, aby upewnić się, że akceptujesz najświeższą zmianę.
• Przed dodaniem aktywności notatnika do potoku otwórz ustawienia Notatnika i sprawdź sekcję Szczegóły w panelu O programie pod kątem aktualizacji modyfikacji, upewnij się, że akceptujesz najnowsze zmiany. Jeśli nie masz pewności co do najnowszej zmiany, lepiej otwórz Notebook, aby przejrzeć zmianę przed dodaniem jej do pipeline.
• Przed zaktualizowaniem planu harmonogramu otwórz ustawienia Notesu i sprawdź sekcję Szczegóły w panelu O programu, aby znaleźć informacje o aktualizacji modyfikacji. Upewnij się, że akceptujesz najnowsze zmiany. Jeśli nie masz pewności co do najnowszej zmiany, otwórz notes, aby przejrzeć zmianę przed zaktualizowaniem planu harmonogramu.
• Rozdziel obszar roboczy na różne etapy (tworzenie, testowanie, produkcyjny) i kontroluj dostęp w różnych etapach, aby uniknąć problemów z bezpieczeństwem. Dodaj tylko użytkownika, któremu ufasz, do etapu produkcyjnego.

Tworzenie notesów

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

Tworzenie nowego notesu

Podobnie jak w przypadku innych standardowych procesów tworzenia elementów w Fabric, można łatwo utworzyć nowy notes z strony głównej Inżynieria Danych, opcją Nowa w obszarze roboczym lub w Centrum tworzenia.

Importowanie istniejących notatników

Możesz zaimportować jeden lub więcej istniejących notesów z komputera lokalnego, korzystając z opcji na pasku narzędzi obszaru roboczego. Notesy Fabric rozpoznają standardowe pliki notesu Jupyter Notebook .ipynb i pliki źródłowe, takie jak .py, .scala i .sql, i odpowiednio tworzą nowe elementy notesu.

Eksportowanie notesu

Notatnik można wyeksportować do innych standardowych formatów. Notatnik Synapse można wyeksportować do:

Zapisywanie notesu

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

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.

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 .

Łączenie lakehouse i notebooków

Notatniki Fabric teraz obsługują bliskie interakcje z lakehouse; możesz łatwo dodać nowy lub istniejący lakehouse z eksploratora Lakehouse.

Możesz poruszać się między różnymi obiektami lakehouse w eksploratorze Lakehouse i ustawić jeden obiekt jako domyślny, przypinając go. Domyślna wartość jest następnie zamontowana do katalogu roboczego środowiska uruchomieniowego i można odczytywać lub zapisywać do domyślnego lakehouse za pomocą lokalnej ścieżki.

Uwaga

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

Dodawanie lub usuwanie domu nad jeziorem

Wybranie ikony X obok nazwy lakehouse powoduje usunięcie jej z zakładki notesu, ale element lakehouse nadal istnieje w obszarze roboczym.

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

Eksplorowanie pliku lakehouse

Podfoldery i pliki w sekcji Tabele i Pliki widoku Lake są wyświetlane w obszarze zawartości między listą Lakehouse a zawartością notatnika. 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,.pngitp.) prawym kliknięciem 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.

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.

Uwaga

• Maksymalna liczba magazynów zasobów dla folderu wbudowanego i folderu środowiskowego wynosi 500 MB, a rozmiar pojedynczego pliku wynosi do 100 MB. Obie umożliwiają łącznie maksymalnie 100 wystąpień plików/folderów.
• Podczas używania notebookutils.notebook.run(), użyj polecenia notebookutils.nbResPath, aby uzyskać dostęp do docelowego zasobu notesu. Ścieżka względna builtin/ zawsze wskazuje na wbudowany folder notatnika głównego.

Folder zasobów wbudowanych

Folder zasobów wbudowanych jest folderem zdefiniowanym przez system unikatowym dla każdego notesu. Zaleca się używanie wbudowanego folderu zasobów do przechowywania wszystkich danych używanych w bieżącym notesie. Poniżej przedstawiono kluczowe możliwości zasobów laptopa.

• 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 notebookutils.nbResPath ułatwia tworzenie pełnej ścieżki.
• Zweryfikowane dane można łatwo przenieść do lakehouse za pośrednictwem opcji Zapisuj do lakehouse. Fabric osadza bogate fragmenty kodu dla typowych rodzajów plików, aby ułatwić szybkie rozpoczęcie pracy.
• Te zasoby są również dostępne do użycia w przypadku uruchamiania notesu referencyjnego za pomocą notebookutils.notebook.run().

Folder zasobów środowiska

Folder zasobów środowiskowych to udostępnione repozytorium, które usprawnia współpracę pomiędzy wieloma notesami.

• Kartę Zasoby można znaleźć w środowisku i mieć pełne operacje do zarządzania plikami zasobów tutaj. Gdy notatnik jest powiązany z bieżącym środowiskiem, te pliki można udostępniać w wielu notatnikach.

  

• Na stronie Notes można łatwo znaleźć drugi folder główny w obszarze Zasoby dziedziczone ze środowiska dołączonego.

  

• Można również pracować na plikach/folderach tak samo, jak w folderze Wbudowane zasoby.

• Ścieżka zasobu środowiskowego jest automatycznie dołączana do klastra notatników. Aby uzyskać dostęp do zasobów środowiska, możesz użyć ścieżki względnej /env.

Uwaga

Odczyt/zapis ze ścieżką względną nie działa w sesji wysokiej współbieżności.

Edytor plików

Edytor plików umożliwia wyświetlanie i edytowanie plików bezpośrednio w folderze zasobów notesu i folderze zasobów środowiska w notesie. Obsługiwane typy plików to CSV, TXT, HTML, YML, PY, SQL i inne. Za pomocą edytora plików można łatwo uzyskiwać dostęp do i modyfikować pliki w notesie, obsługuje wyróżnianie słów kluczowych i zapewnia niezbędną usługę językową podczas otwierania i edytowania plików kodu, takich jak .py i .sql.

• Dostęp do tej funkcji można uzyskać za pomocą opcji "Wyświetl i edytuj" w menu plików. Dwukrotne kliknięcie pliku jest szybszym sposobem.

  

• Zmiana zawartości w edytorze plików musi zostać zapisana ręcznie, klikając przycisk Zapisz lub skrót klawiaturowy: Ctrl+S, edytor plików nie obsługuje automatycznego zapisywania.

• tryb notatnika wpływa również na edytor plików. Możesz wyświetlać tylko pliki, ale nie można ich edytować, jeśli jesteś w trybie notesu bez uprawnień do edycji.

Uwaga

Poniżej przedstawiono pewne ograniczenia dotyczące edytora plików.

• Limit rozmiaru pliku wynosi 1 MB.
• Te typy plików nie są obsługiwane do wyświetlania i edytowania: .xlsx i parquet.

Współpracuj w notesie

Notatnik Fabric to narzędzie współpracy, które pozwala wielu użytkownikom edytować ten sam notatnik.

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, wyniki uruchomienia, wskaźnik kursora, wskaźnik wyboru i ślad edytowania. Korzystając z funkcji współpracy, można łatwo wykonać programowanie w parach, zdalne debugowanie i nauczanie.

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. Możesz udostępnić notatnik z określonymi uprawnieniami.

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

   

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

   

3. Po wybraniu Zastosuj możesz wysłać notatnik bezpośrednio lub skopiować link do innych osób. Adresaci mogą następnie otworzyć notatnik z widokiem odpowiadającym ich poziomowi uprawnień.

   

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.

   

Dodawanie komentarza do komórki kodu

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

1. Wybierz przycisk Komentarze na pasku narzędzi notatnika lub wskaźnik komentarza w komórce, aby otworzyć panel Komentarze.

   

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

   

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, co efektywnie zwiększa współpracę na temat szczegółów.

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

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

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

4. Gdy powiadomienie e-mail zostanie wysłane, 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.

Uwaga

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

Historia wersji

Ważne

Ta funkcja jest dostępna w wersji zapoznawczej.

Historia wersji pozwala łatwo zarządzać wersjami zmian w notatniku w czasie rzeczywistym. Obsługuje ona śledzenie historii i zarządzanie notesami z niezawodnymi wbudowanymi funkcjami kontroli wersji, co jest szczególnie przydatne w przypadku współpracy z wieloma współautorami w tym samym notesie.

1. Aby uzyskać dostęp do historii wersji, użyj globalnego paska narzędzi notesu.

   

2. Notatnik obsługuje dwa sposoby tworzenia punktów kontrolnych.

   • Ręczny punkt kontrolny: możesz ręcznie utworzyć nową wersję , aby rejestrować kamienie milowe rozwoju, zapewniając elastyczność zarządzania wersjami notatnika.

     

   • Punkt kontrolny systemu: te punkty kontrolne są tworzone automatycznie co 5 minut na podstawie interwału czasu edycji przez system notesów, zapewniając, że praca jest spójnie zapisywana i wersjonowana. Rekordy modyfikacji można znaleźć na liście osi czasu punktów kontrolnych systemu.

3. Możesz kliknąć na checkpoint, aby otworzyć widok różnic, który wyróżnia różnice między wybranym checkpointem a bieżącą wersją na żywo, w tym różnice w zawartości komórek, wynikach działania komórek i metadanych. Wersja tego punktu kontrolnego może być zarządzana indywidualnie w menu "więcej opcji".

   

4. Możesz zarządzać wersją z menu rozwijanego punktu kontrolnego, jeśli chcesz zachować poprzednią wersję, kliknij Przywróć z punktu kontrolnego i zastąp bieżący notes lub użyj Zapisz jako kopię, aby utworzyć jego kopię w nowym notesie.

   

Uwaga

• Znane ograniczenie: gdy wielu współpracowników edytuje, jeśli jeden z nich kliknie przycisk Przywróć, a następnie wybierze opcję Powrót do notatnika, notatnik nie zostanie natychmiast przywrócony z punktu kontrolnego. Na pasku komunikatów zostanie wyświetlony monit o wyświetlenie zmian. Kliknij przycisk Wyświetl zmiany i wybierz opcję Zachowaj zapisaną wersję , aby zakończyć przywracanie.
• Punkty kontrolne systemu wygasną po upływie 1 roku.

Przełącznik trybu notatnika

Notesy sieci szkieletowej obsługują cztery tryby, które można łatwo przełączać: tryb programowania, tryb tylko uruchamiania, tryb edycji i tryb wyświetlania. Każdy tryb odpowiada określonej kombinacji uprawnień. Podczas udostępniania notesu innym członkom zespołu można przyznać adresatom odpowiednie uprawnienia. Widzą najlepszy dostępny tryb notesu zgodnie z ich uprawnieniami i mogą przełączać się między trybami, do których mają odpowiednie uprawnienia.

• Tryb deweloperski: wymagane jest uprawnienie do odczytu, wykonywania, zapisu.
• Tryb tylko do uruchamiania: Wymagane uprawnienia do odczytu i wykonywania.
• Tryb edycji: wymagane uprawnienia do odczytu, zapisu.
• Tryb wyświetlania: wymagane uprawnienia do odczytu.

Powiązana zawartość

• Tworzenie i wykonywanie notatników