Interfejs i kontrolki notesu usługi Databricks

Pasek narzędzi notesu zawiera menu i ikony, których można użyć do zarządzania notesem i edytowania go.

Obok nazwy notesu znajdują się przyciski, które umożliwiają zmianę domyślnego języka notesu i, jeśli notes znajduje się w folderze Usługi Git usługi Databricks, otwórz okno dialogowe Git.

Aby wyświetlić poprzednie wersje notesu, kliknij przycisk "Ostatnia edycja..." po prawej stronie menu.

Zaktualizowany projekt komórki

Ważne

Ta funkcja jest dostępna w publicznej wersji zapoznawczej.

Dostępny jest zaktualizowany projekt komórki. Ta strona zawiera informacje o sposobie używania obu wersji projektu komórki. Aby uzyskać orientację nowego interfejsu użytkownika i odpowiedzi na typowe pytania, zobacz Orientacja do nowego interfejsu użytkownika komórki.

Aby włączyć lub wyłączyć nowy projekt komórki, otwórz stronę ustawień edytora w obszarze roboczym. Na pasku bocznym kliknij pozycję Deweloper. W obszarze Funkcje eksperymentalne przełącz pozycję Nowy interfejs użytkownika komórki.

Komórki notesu

Notesy zawierają kolekcję dwóch typów komórek: komórki kodu i komórki markdown. Komórki kodu zawierają kod możliwy do uruchomienia. Komórki markdown zawierają kod markdown renderowany w tekście i grafikę podczas wykonywania komórki i może służyć do dokumentowania lub ilustrowania kodu. Możesz dodawać lub usuwać komórki do notesu w celu struktury pracy.

Można uruchomić pojedynczą komórkę, grupę komórek lub uruchomić cały notes jednocześnie. Komórka notesu może zawierać co najwyżej 10 MB. Dane wyjściowe komórki notesu są ograniczone do 20 MB.

Ikony i przyciski paska narzędzi notesu

Ikony i przyciski po prawej stronie paska narzędzi są opisane w poniższej tabeli:

Icon	opis
	Uruchom wszystkie komórki lub zatrzymaj wykonywanie. Nazwa tego przycisku zmienia się w zależności od stanu notesu.
	Otwórz selektor obliczeniowy. Gdy notes jest połączony z klastrem lub usługą SQL Warehouse, ten przycisk wyświetla nazwę zasobu obliczeniowego.
	Otwórz harmonogram zadań.
	Otwórz tabele na żywo delty. Ten przycisk jest wyświetlany tylko wtedy, gdy notes jest częścią potoku Delta Live Tables.
	Okno dialogowe Otwieranie uprawnień.

Akcje prawego paska bocznego

Na prawym pasku bocznym notesu jest dostępnych kilka akcji, zgodnie z opisem w poniższej tabeli:

Icon	opis
	Otwórz komentarze notesu.
	Otwórz eksperyment notesu MLflow.
	Otwórz historię wersji notesu.
	Otwórz Eksploratora zmiennych. (Dostępne dla zmiennych języka Python w środowisku Databricks Runtime 12.2 LTS i nowszym).
	Otwórz panel środowiska języka Python. Ten panel zawiera wszystkie biblioteki języka Python dostępne dla notesu, w tym biblioteki o zakresie notesu, biblioteki klastra i biblioteki uwzględnione w środowisku Databricks Runtime. Dostępny tylko wtedy, gdy notes jest dołączony do klastra.

Przeglądanie danych

Ważne

Ta funkcja jest dostępna w publicznej wersji zapoznawczej.

Aby eksplorować tabele i woluminy dostępne do użycia w notesie, kliknij po lewej stronie notesu, aby otworzyć przeglądarkę schematu. Aby uzyskać więcej informacji, zobacz Przeglądanie danych .

Menu akcji komórek

Menu akcji komórki umożliwia wycinanie i kopiowanie komórek, przenoszenie komórek w notesie oraz ukrywanie kodu lub wyników. Menu ma inny wygląd w oryginalnym interfejsie użytkownika i nowym interfejsie użytkownika. Ta sekcja zawiera instrukcje dotyczące obu wersji.

Jeśli asystent usługi Databricks jest włączony w obszarze roboczym, możesz użyć go w komórce kodu, aby uzyskać pomoc lub sugestie dotyczące kodu. Aby otworzyć pole tekstowe Asystenta usługi Databricks w komórce, kliknij ikonę Asystenta usługi Databricks w prawym górnym rogu komórki.

Komórkę między kodem i markdown można łatwo zmienić lub zmienić język komórki kodu przy użyciu przycisku języka komórek w prawym górnym rogu komórki.

Menu akcji komórek (oryginalny interfejs użytkownika)

Z tego menu można również uruchamiać komórki kodu:

Menu akcji komórki zawiera również przyciski, które pozwalają ukryć komórkę lub usunąć komórkę .

W przypadku komórek języka Markdown istnieje również opcja dodania komórki do pulpitu nawigacyjnego. Aby uzyskać więcej informacji, zobacz Pulpity nawigacyjne w notesach.

Praca z komórkami w nowym interfejsie użytkownika

Poniższy zrzut ekranu opisuje ikony wyświetlane w prawym górnym rogu komórki notesu:

Selektor języka: wybierz język komórki.

Asystent usługi Databricks: włączanie lub wyłączanie Asystenta usługi Databricks w celu uzyskania sugestii dotyczących kodu w komórce.

Fokus komórki: Powiększ komórkę, aby ułatwić edycję.

Menu Wyświetl akcje komórki: otwórz menu akcji komórki. Opcje w tym menu są nieco inne dla komórek kodu i języka Markdown.

Aby uruchomić komórki kodu w nowym interfejsie użytkownika, kliknij strzałkę w dół w lewym górnym rogu komórki kodu.

Po uruchomieniu komórki po prawej stronie menu uruchamiania komórki zostanie wyświetlone powiadomienie pokazujące czas ostatniego uruchomienia komórki i czas trwania przebiegu. Umieść kursor nad powiadomieniem, aby uzyskać więcej szczegółów.

Aby dodać komórkę Markdown lub komórkę zawierającą wyniki tabelaryczne do pulpitu nawigacyjnego, wybierz pozycję Dodaj do pulpitu nawigacyjnego z menu akcji komórek. Aby uzyskać więcej informacji, zobacz Pulpity nawigacyjne w notesach.

Aby usunąć komórkę, kliknij ikonę kosza po prawej stronie komórki. Ta ikona jest wyświetlana tylko po umieszczeniu kursora na komórce.

Aby dodać komentarz do kodu w komórce, zaznacz kod. Po prawej stronie komórki zostanie wyświetlona ikona komentarza. Kliknij ikonę, aby otworzyć pole komentarza.

Aby przenieść komórkę w górę lub w dół, kliknij i przytrzymaj na zewnątrz lewego górnego rogu komórki, a następnie przeciągnij komórkę do nowej lokalizacji. Możesz również wybrać pozycję Przenieś w górę lub Przenieś w dół z menu akcji komórki.

Tworzenie komórek

Notesy mają dwa typy komórek: kod i markdown. Zawartość komórek markdown jest renderowana w kodzie HTML. Na przykład ten fragment kodu zawiera znaczniki dla nagłówka poziomu jeden:

%md ### Libraries
Import the necessary libraries.

renderuje, jak pokazano:

Tworzenie komórki (oryginalny interfejs użytkownika)

Aby utworzyć nową komórkę w oryginalnym interfejsie użytkownika, umieść kursor na komórce u góry lub u dołu i kliknij ikonę . Możesz również użyć menu komórki notesu: kliknij i wybierz pozycję Dodaj komórkę powyżej lub Dodaj komórkę poniżej.

W przypadku komórki kodu wystarczy wpisać kod do komórki. Aby utworzyć komórkę markdown, wybierz pozycję Markdown z przycisku języka komórki lub wpisz %md w górnej części komórki.

Tworzenie komórki (nowy interfejs użytkownika)

Aby utworzyć nową komórkę w nowym interfejsie użytkownika, umieść kursor na komórce w górnej lub dolnej części. Kliknij pozycję Kod lub Tekst , aby utworzyć odpowiednio kod lub komórkę markdown.

Wycinanie, kopiowanie i wklejanie komórek

Istnieje kilka opcji wycinania i kopiowania komórek. Jeśli używasz przeglądarki Safari, dostępne są tylko skróty klawiaturowe.

• W menu akcji komórki w oryginalnym interfejsie użytkownika lub nowym interfejsie użytkownika wybierz pozycję Wytnij komórkę lub Kopiuj komórkę.
• Użyj skrótów klawiaturowych: Command-X lub Ctrl-X , aby wyciąć i Command-C lub Ctrl-C skopiować.
• Użyj menu Edycja w górnej części notesu. Wybierz pozycję Wytnij lub Kopiuj.

Po wycięciu lub skopiowaniu komórek można wkleić te komórki w innym miejscu w notesie, w innym notesie lub w notesie na innej karcie lub w innym oknie przeglądarki. Aby wkleić komórki, użyj skrótu Command-V klawiaturowego lub Ctrl-V. Komórki są wklejane poniżej bieżącej komórki.

Aby cofnąć akcje wycinania lub wklejania, możesz użyć skrótu Command-Z klawiaturowego lub Ctrl-Z opcji menu Edytuj > cofnij wycięte komórki lub Edytuj > cofnij wklej komórki.

Aby zaznaczyć sąsiadujące komórki, kliknij komórkę markdown, a następnie użyj Shift + w górę lub w dół, aby zaznaczyć komórki powyżej lub poniżej. Użyj menu edycji, aby skopiować, wyciąć, wkleić lub usunąć zaznaczone komórki jako grupę. Aby zaznaczyć wszystkie komórki, wybierz pozycję Edytuj wszystkie komórki lub użyj skrótu do trybu polecenia Cmd+A>.

Spis treści notesu

Aby wyświetlić automatycznie wygenerowany spis treści, kliknij ikonę w lewym górnym rogu notesu (między lewym paskiem bocznym a górną komórką). Spis treści jest generowany na podstawie nagłówków języka Markdown używanych w notesie. Jeśli używasz nowego interfejsu użytkownika, komórki z tytułami również są wyświetlane w spisie treści.

Opcje wyświetlania komórek

Istnieją trzy opcje wyświetlania notesów. Użyj menu Widok, aby zmienić opcję wyświetlania.

• Widok standardowy: wyniki są wyświetlane natychmiast po komórkach kodu.
• Tylko wyniki: wyświetlane są tylko wyniki.
• Obok siebie: obok siebie są wyświetlane komórki kodu i wyników.

W nowym interfejsie użytkownika akcje są dostępne z ikon w rynnie komórki (obszar po prawej i lewej stronie komórki). Aby na przykład przenieść komórkę w górę lub w dół, użyj kropek uchwytu w lewym rynnie. Aby usunąć komórkę, użyj ikony kosza w prawej rynnie.

Aby ułatwić edytowanie, kliknij ikonę trybu koncentracji uwagi, aby wyświetlić komórkę o pełnej szerokości. Aby zamknąć tryb koncentracji uwagi, kliknij pozycję . Można również powiększyć wyświetlaną szerokość komórki, wyłączając układ wyśrodkowany widok>.

Aby automatycznie sformatować wszystkie komórki w notesie do standardowych długości linii branżowych i odstępów, wybierz pozycję Edytuj > notes formatu.

Numery wierszy i poleceń

Aby wyświetlić lub ukryć numery wierszy lub numery poleceń, wybierz pozycję Numery wierszy lub Numery poleceń z menu Widok . W przypadku numerów wierszy można również użyć skrótu klawiaturowego Control+L.

Jeśli włączysz numery wierszy lub poleceń, usługa Databricks zapisze preferencje i wyświetli je we wszystkich innych notesach dla tej przeglądarki.

Numery wierszy i poleceń (oryginalny interfejs użytkownika)

Numery poleceń powyżej komórek łączą się z tym konkretnym poleceniem. Jeśli klikniesz numer polecenia dla komórki, zaktualizuje on adres URL, aby był zakotwiczony w tym poleceniu. Aby uzyskać link adresu URL do określonego polecenia w notesie, kliknij prawym przyciskiem myszy numer polecenia i wybierz polecenie Kopiuj adres łącza.

Numery wierszy i poleceń (nowy interfejs użytkownika)

Numery wierszy są domyślnie wyłączone w nowym interfejsie użytkownika. Aby je włączyć, wybierz pozycję Wyświetl > numery wierszy. Gdy komórka jest w stanie błędu, numery wierszy są wyświetlane niezależnie od zaznaczenia.

Aby przełączyć numery poleceń, wybierz pozycję Wyświetl > numery poleceń.

Nowy interfejs użytkownika nie zawiera linków numeru polecenia komórki. Aby uzyskać link adresu URL do określonego polecenia w notesie, kliknij , aby otworzyć tryb koncentracji uwagi, a następnie skopiuj adres URL z paska adresu przeglądarki. Aby zamknąć tryb koncentracji uwagi, kliknij pozycję .

Dodawanie tytułu komórki

Aby dodać tytuł do komórki przy użyciu oryginalnego interfejsu użytkownika, wybierz pozycję Pokaż tytuł z menu akcji komórki.

Aby dodać tytuł do komórki przy użyciu nowego interfejsu użytkownika, wykonaj jedną z następujących czynności:

• Kliknij numer komórki wyświetlany w środku górnej części komórki i wpisz tytuł.
• Wybierz pozycję Dodaj tytuł z menu akcji komórek.

W nowym interfejsie użytkownika komórki z tytułami są wyświetlane w spisie treści notesu.

Wyświetlanie notesów w trybie ciemnym

Możesz wyświetlać notesy w trybie ciemnym. Aby włączyć lub wyłączyć tryb ciemny, wybierz pozycję Wyświetl > motyw i wybierz pozycję Jasny motyw lub Motyw ciemny.

Ukrywanie i pokazywanie zawartości komórki

Zawartość komórki składa się z kodu komórki i wyników generowanych przez uruchomienie komórki. Kod komórki i wynik można ukryć i pokazać przy użyciu menu akcji komórki w prawym górnym rogu komórki.

Aby uzyskać powiązane funkcje, zobacz Zwijane nagłówki.

Ukryj i pokaż zawartość komórki (oryginalny interfejs użytkownika)

Aby ukryć kod komórki lub wyniki, kliknij i wybierz pozycję Ukryj kod lub Ukryj wynik. Możesz również wybrać , aby wyświetlić tylko pierwszy wiersz komórki.

Aby wyświetlić ukryty kod komórki lub wyniki, kliknij przycisk Pokaż łącza:

Ukryj i pokaż zawartość komórki (nowy interfejs użytkownika)

Aby ukryć kod komórki lub wyniki, kliknij menu kebab w prawym górnym rogu komórki i wybierz pozycję Ukryj kod lub Ukryj wynik. Możesz również wybrać pozycję Zwiń komórkę , aby wyświetlić tylko pierwszy wiersz komórki. Aby rozwinąć zwiniętą komórkę, wybierz pozycję Rozwiń komórkę.

Aby wyświetlić ukryty kod komórki lub wyniki, kliknij ikonę pokaż: .

Zwijane nagłówki

Komórki, które pojawiają się po komórkach zawierających nagłówki markdown, można zwinąć do komórki nagłówka. Aby rozwinąć lub zwinąć komórki po komórkach zawierających nagłówki markdown w notesie, wybierz pozycję Zwiń wszystkie nagłówki z menu Widok . W pozostałej części tej sekcji opisano sposób rozwijania lub zwijania podzbioru komórek.

Aby uzyskać powiązane funkcje, zobacz Ukrywanie i pokazywanie zawartości komórki.

Rozwijanie i zwijanie nagłówków (oryginalny interfejs użytkownika)

Na obrazie przedstawiono konfigurację MLflow na poziomie dwóch poziomów z następującymi dwoma komórkami zwiniętymi do niego.

Aby rozwinąć i zwinąć nagłówki, kliknij pozycję + i -.

Rozwiń i zwiń nagłówki (nowy interfejs użytkownika)

Na obrazie przedstawiono konfigurację MLflow na poziomie dwóch poziomów z następującymi dwoma komórkami zwiniętymi do niego.

Aby rozwinąć i zwinąć nagłówki, umieść kursor na komórce Markdown. Kliknij strzałkę wyświetlaną po lewej stronie komórki.

Zasoby obliczeniowe dla notesów

W tej sekcji omówiono opcje zasobów obliczeniowych notesu. Możesz uruchomić notes w klastrze usługi Databricks lub w przypadku poleceń SQL, możesz również użyć usługi SQL Warehouse — typu obliczeń zoptymalizowanego pod kątem analizy SQL.

Dołączanie notesu do klastra

Do dołączenia notesu do klastra potrzebne jest uprawnienie CAN ATTACH TO cluster-level.

Ważne

Jeśli notes jest dołączony do klastra, każdy użytkownik z uprawnieniem CAN RUN w notesie ma niejawne uprawnienia dostępu do klastra.

Aby dołączyć notes do klastra, kliknij selektor obliczeniowy na pasku narzędzi notesu i wybierz klaster z menu rozwijanego.

W menu jest wyświetlany wybór klastrów, które były ostatnio używane lub które są aktualnie uruchomione.

Aby wybrać spośród wszystkich dostępnych klastrów, kliknij pozycję Więcej.... Kliknij nazwę klastra, aby wyświetlić menu rozwijane, a następnie wybierz istniejący klaster.

Możesz również utworzyć nowy klaster , wybierając pozycję Utwórz nowy zasób... z menu rozwijanego.

Ważne

Dołączony notes zawiera zdefiniowane następujące zmienne platformy Apache Spark.

Klasa	Nazwa zmiennej
SparkContext	sc
SQLContext/HiveContext	sqlContext
SparkSession (Spark 2.x)	spark

Nie twórz elementu SparkSession, SparkContextlub SQLContext. W ten sposób doprowadzi to do niespójnego zachowania.

Używanie notesu z usługą SQL Warehouse

Gdy notes jest dołączony do usługi SQL Warehouse, można uruchamiać komórki SQL i Markdown. Jeśli uruchomisz komórkę w dowolnym innym języku (takim jak Python lub R), wystąpi błąd. Komórki SQL wykonywane w usłudze SQL Warehouse są wyświetlane w historii zapytań usługi SQL Warehouse. Użytkownik, który uruchomił zapytanie, może wyświetlić profil zapytania z notesu, klikając upłynął czas u dołu danych wyjściowych.

Uruchamianie notesu wymaga magazynu SQL Pro lub Bezserwerowego. Musisz mieć dostęp do obszaru roboczego i usługi SQL Warehouse.

Aby dołączyć notes do usługi SQL Warehouse , wykonaj następujące czynności:

1. Kliknij selektor obliczeniowy na pasku narzędzi notesu. W menu rozwijanym są wyświetlane zasoby obliczeniowe, które są aktualnie uruchomione lub które były ostatnio używane. Magazyny SQL są oznaczone jako .

2. Z menu wybierz usługę SQL Warehouse.

   Aby wyświetlić wszystkie dostępne magazyny SQL, wybierz pozycję Więcej... z menu rozwijanego. Zostanie wyświetlone okno dialogowe z zasobami obliczeniowymi dostępnymi dla notesu. Wybierz pozycję SQL Warehouse, wybierz magazyn, którego chcesz użyć, a następnie kliknij przycisk Dołącz.

   

Możesz również wybrać usługę SQL Warehouse jako zasób obliczeniowy notesu SQL podczas tworzenia przepływu pracy lub zaplanowanego zadania.

Ograniczenia usługi SQL Warehouse

Aby uzyskać więcej informacji, zobacz Znane ograniczenia dotyczące notesów usługi Databricks.

Odłączanie notesu

Aby odłączyć notes od zasobu obliczeniowego, kliknij selektor obliczeniowy na pasku narzędzi notesu i umieść kursor na dołączonym klastrze lub usłudze SQL Warehouse na liście, aby wyświetlić menu boczne. Z menu bocznego wybierz pozycję Odłącz.

Notesy można również odłączyć od klastra przy użyciu karty Notesy na stronie szczegółów klastra.

Po odłączeniu notesu kontekst wykonywania zostanie usunięty, a wszystkie obliczone wartości zmiennych zostaną wyczyszczone z notesu.

Napiwek

Usługa Azure Databricks zaleca odłączenie nieużywanych notesów od klastrów. Zwalnia to miejsce na dysku.

Korzystanie z terminalu internetowego i interfejsu wiersza polecenia usługi Databricks

Aby otworzyć terminal internetowy w notesie, kliknij u dołu prawego paska bocznego.

Korzystanie z interfejsu wiersza polecenia usługi Databricks w terminalu internetowym

Począwszy od środowiska Databricks Runtime 15.0, możesz użyć interfejsu wiersza polecenia usługi Databricks z poziomu terminalu internetowego w notesie.

Wymagania

• Notes musi być dołączony do klastra w trybie dostępu współużytkowanego pojedynczego użytkownika lub Bez izolacji.
• Interfejs wiersza polecenia nie jest dostępny w obszarach roboczych włączonych dla usługi Private Link.

Zainstalowany interfejs wiersza polecenia jest zawsze najnowszą wersją. Uwierzytelnianie jest oparte na bieżącym użytkowniku.

Nie można użyć interfejsu wiersza polecenia z komórki notesu. Polecenia, takie jak %sh databricks ... w notesie, nie działają w środowisku Databricks Runtime 15.0 lub nowszym.