Zarządzaj formatem notatnika Databricks

Domyślnie notesy w usłudze Databricks są tworzone w formacie .ipynb (IPython lub Jupyter). Możesz również użyć formatu źródłowego.

Nadal można importować i eksportować notesy w różnych formatach. Zobacz Importowanie i eksportowanie notesów usługi Databricks.

formaty notatników

Usługa Databricks obsługuje tworzenie i edytowanie notesów w dwóch formatach: IPYNB (wartość domyślna) i źródło.

Pliki źródłowe, w tym notesy, można zarządzać przy użyciu folderów Git. W folderach Git są obsługiwane tylko niektóre typy zasobów usługi Databricks. Format ma wpływ na sposób, w jaki notesy są zatwierdzane w repozytoriach zdalnych, zgodnie z opisem w poniższej tabeli.

Format źródła notatnika Opis
przesłać źródło Podstawowy format, który przechwytuje tylko kod źródłowy z sufiksem sygnalizujący język kodu, taki jak .py, .scala, .r i .sql.
IPYNB (Jupyter) Format, który przechwytuje kod źródłowy, środowisko notesu, definicje wizualizacji, widżety i opcjonalne wyniki. Notatnik IPYNB może zawierać kod w dowolnym języku obsługiwanym przez notatniki Databricks, niezależnie od części py w .ipynb. Przy użyciu formatu IPYNB możesz opcjonalnie kontrolować dane wyjściowe notesu wraz z notesem.

Format IPYNB obsługuje również lepsze środowisko wyświetlania notesów usługi Databricks w zdalnych repozytoriach Git. Jeśli używasz GitHub lub GitLab, możesz włączyć funkcje, które zapewniają ulepszone różnice notesów w żądaniach ściągnięcia, co ułatwia wyświetlanie i przeglądanie kodu zmian w notesie.

Aby dowiedzieć się więcej o obsłudze GitHub dla rozbudowanych różnic w notatnikach IPYNB, zobacz Feature Preview: Rich Jupyter Notebook Diffs. Aby dowiedzieć się więcej na temat obsługi porównań w notesach IPYNB w GitLab, zobacz pliki Jupyter Notebook.

Aby odróżnić notesy formatu źródłowego od zwykłych plików Python, Scala i SQL, Azure Databricks dodaje komentarz "Databricks notebook source" na początku notesów Python, Scala i SQL. Ten komentarz gwarantuje, że Azure Databricks poprawnie analizuje plik jako notes, a nie plik skryptu.

Zmienianie domyślnego ustawienia formatu notesu

Notesy IPYNB są formatem domyślnym podczas tworzenia nowego notesu na Azure Databricks.

Aby zmienić domyślny format źródła Azure Databricks, zaloguj się do obszaru roboczego Azure Databricks, kliknij swój profil w prawym górnym rogu strony, a następnie kliknij pozycję Settings i przejdź do Developer. Zmień domyślny format notatnika w ustawieniach edytora pod nagłówkiem .

Zmień domyślny format notatnika w ustawieniach programisty profilu

Konwertuj format notesu

Istniejący notes można przekonwertować na inny format za pomocą interfejsu użytkownika Azure Databricks.

Aby konwertować istniejący notes na inny format:

  1. Otwórz notatnik w obszarze roboczym.

  2. Wybierz pozycję Plik z menu obszaru roboczego, wybierz pozycję Format notesu i wybierz odpowiedni format. Możesz wybrać Jupyter (.ipynb) (zalecane) lub kod źródłowy (.scala, .py, .sql, .r). Bieżący format notesu jest wyszarzony i obok niego znajduje się znacznik wyboru.

    Menu pliku obszaru roboczego, rozwinięte, pokazujące opcję formatu notesu.

Aby uzyskać więcej informacji na temat rodzajów notesów obsługiwanych w Azure Databricks, zobacz Importuj i eksportuj notesy usługi Databricks.

Zarządzanie zatwierdzeniami wyjściowymi notesu IPYNB

Dane wyjściowe to wyniki uruchamiania notesu na platformie usługi Databricks, w tym wyświetlanie tabel i wizualizacje. W przypadku notesów IPYNB w folderach kontrolowanych przez źródło można zarządzać tym, jak dane wyjściowe notesu są zatwierdzane w repozytorium zdalnym.

Zezwalaj na zatwierdzanie danych wyjściowych notatnika .ipynb

Dane wyjściowe można zatwierdzać tylko wtedy, gdy administrator obszaru roboczego włączył tę funkcję. Domyślnie ustawienie administracyjne folderów Git nie zezwala na .ipynb zatwierdzanie danych wyjściowych notesu. Jeśli masz uprawnienia administratora dla obszaru roboczego, możesz zmienić to ustawienie:

  1. Kliknij swoją nazwę użytkownika na górnym pasku obszaru roboczego usługi Azure Databricks i wybierz pozycję Ustawienia.

  2. W sekcji Administrator obszaru roboczego kliknij Development.

  3. W sekcji Repos ustaw Pozwól repos eksportować wyjście IPYNB do Zezwalaj: można włączyć wyjścia IPYNB.

    Konsola administracyjna: zezwalaj folderom Git na eksportowanie danych wyjściowych IPYNB.

Ważny

Gdy uwzględniono wyniki, konfiguracje wizualizacji i pulpitu nawigacyjnego są dołączane do tworzonych .ipynb notatników.

Kontrolowanie zatwierdzania artefaktów wyjściowych notatnika IPYNB

Plik .databricks/commit_outputs konfiguracyjny w twoim repozytorium decyduje, które .ipynb wyniki notebooka są zatwierdzane. Po tym, jak administrator przestrzeni roboczej pozwoli na commity wyjściowe, możesz utworzyć ten plik w oknie Git:

  1. Otwórz okno dialogowe Git dla folderu Git, który zawiera notes .ipynb, ale nie ma pliku .databricks/commit_outputs.

  2. W alercie informacyjnym na górze okna kliknij Create commit_outputs config file.

    Interfejs użytkownika zatwierdzania Notebooka: przycisk Utwórz plik commit_outputs.

Możesz też użyć menu File, aby uwzględnić lub wykluczyć dane wyjściowe dla konkretnego notatnika IPYNB. Jeśli plik konfiguracyjny nie istnieje, Azure Databricks tworzy go podczas dokonywania wyboru. Użyj tej opcji, jeśli zamknąłeś alert w oknie Git.

  1. W menu Plik wybierz Commit notebook outputs. Pozycja menu jest dostępna tylko dla notatników IPYNB w folderze Git po tym, jak administrator obszaru roboczego włączy zatwierdzanie danych wyjściowych.

    Edytor notatników: Zatwierdzaj status i kontrolę wyników notatników.

  2. W oknie Commit outputs configuration wybierz Include Outputs lub Exclude Outputs, a następnie kliknij Zmień.

    okno dialogowe zatwierdzania wyników notesów.

  • Ostatnia aktualizacja o