Używaj Shared Serverless do folderów i pakietów Git

W trybie Shared Serverless notatniki i pliki w tym samym folderze lub pakiecie Git udostępniają serwerless obliczenia oraz środowisko Python w edytorze. Aby dostosować środowisko, dodaj plik pyproject.toml w katalogu głównym folderu. Aby dołączyć notatnik lub plik, postępuj zgodnie z instrukcjami dotyczącymi folderów Git lub Declarative Automation Bundles.

Requirements

• Twoja przestrzeń robocza musi spełniać wymagania dotyczące obliczeń bezserwerowych.
• Otwórz swój folder Git lub pakiet w edytorze folderów Git lub edytorze pakietów Git. Zobacz Tworzenie i zarządzanie folderami Git oraz Pakiety autorów w obszarze roboczym.
• Shared Serverless wymaga środowiska bezserwerowego w wersji 5 lub nowszej.

Współdzielone obliczenia i środowisko

• Notesy i pliki w tym samym folderze lub pakiecie Git udostępniają obliczenia i środowisko Python w edytorze. Opcjonalny pyproject.toml plik w korzeniu folderu definiuje środowisko współdzielone.
• Tylko notatniki i pliki znajdujące się w powiązanym folderze Git lub pakiecie mogą dołączyć do wspólnego zasobu obliczeniowego.
• Współdzielone zasoby obliczeniowe są izolowane według użytkownika. Tylko użytkownik, który jako pierwszy dołączy notatnik lub plik do wspólnego zasobu obliczeniowego, może na nim uruchamiać obciążenia.
• Wykonywanie Notebooków pozostaje odizolowane. Zmienne Python zdefiniowane w jednym notesie nie są dostępne w innym notesie.
• Terminal webowy otwarty z dołączonego notatnika lub pliku działa na tym samym zasobie obliczeniowym.

Używaj współdzielonego Serverless w folderach Git

Używaj Shared Serverless, aby pracować z notatnikami i plikami w folderze Git.

Dołącz notesy i pliki w edytorze folderów Git

1. W pasku bocznym workspace kliknij Workspace i przejdź do folderu Git.

2. Kliknij Otwórz w edytorze.

3. Otwórz notatnik lub plik w folderze Git.

4. Kliknij menu rozwijane w trybie obliczeniowym.

5. Wybierz Współdzielony Serverless.

   

6. Uruchom notatnik lub plik, aby rozpocząć zasób obliczeniowy.

Aby użyć tego samego compute z innego notatnika lub pliku, otwórz go w tym samym folderze Git i wybierz Shared Serverless.

Współpraca przez Git

Databricks zaleca, aby każdy współpracownik sklonował repozytorium do folderu Git w swoim osobistym folderze workspace. Każdy współautor otrzymuje wtedy osobny zasób obliczeniowy i środowisko dla swojego klonu repozytorium.

Korzystaj z gałęzi, commitów, pushów i pullów, aby wymieniać zmiany za pośrednictwem zdalnego repozytorium Git. Zobacz Współpraca w folderach Git.

Używaj Shared Serverless w pakietach

Użyj Shared Serverless, aby pracować z notesami i plikami w pakiecie w workspace. Korzeń wiązki zawiera databricks.yml i może zawierać pyproject.toml plik definiujący środowisko współdzielone.

Dołącz notebooki i pliki w edytorze pakietów

1. Na pasku bocznym obszaru roboczego kliknij Workspace i przejdź do pakietu.
2. Po prawej stronie nazwy pakietu kliknij Otwórz w edytorze.
3. Otwórz notes lub plik w pakiecie.
4. Kliknij menu rozwijane w trybie obliczeniowym.
5. Wybierz Współdzielony Serverless.
6. Uruchom notatnik lub plik, aby rozpocząć zasób obliczeniowy.

Aby użyć tego samego compute z innego notatnika lub pliku, otwórz go w tym samym pakiecie i wybierz Shared Serverless.

Aby współpracować przez Git, każdy współpracownik powinien sklonować repozytorium do folderu Git w swoim osobistym folderze workspace. Zobacz Współpracuj przez Git.

Zarządzaj środowiskiem za pomocą pyproject.toml

Shared Serverless wykorzystuje plik pyproject.toml w folderze Git lub w katalogu głównym pakietu do zarządzania zależnościami języka Python dla projektu. Standardowe notebooki bezserwerowe wykorzystują zależności skonfigurowane dla każdego notebooka w panelu Środowisko.

Utwórz plik główny pyproject.toml i ustaw jego wersję środowiska serverless przed zarządzaniem jego zależnościami. Zobacz Stwórz i edytuj pyproject.toml. Możesz wtedy dodawać zależności za pomocą poleceń notatnika lub edytować plik bezpośrednio.

Używaj poleceń notatnika

1. Otwórz notatnik dołączony do Shared Serverless.

2. Uruchom %uv add <package>, aby dodać zależność do głównego pliku pyproject.toml. Na przykład:

   %uv add cowsay
   

Polecenie aktualizuje pyproject.toml, uv.lock, oraz środowisko współdzielone. Nie musisz uruchamiać %uv sync po %uv add. Użyj %uv sync, aby zastosować zmiany wprowadzone bezpośrednio w pyproject.toml.

Stwórz i edytuj pyproject.toml

1. Otwórz notes dołączony do Shared Serverless.

2. Otwórz boczny panel Środowisko .

3. Na karcie zarządzanej przez pyproject.toml kliknij Utwórz pyproject.toml, aby utworzyć plik główny. Jeśli plik już istnieje, kliknij Zobacz pyproject.toml. Plik otwiera się w edytorze.

   

4. Edytuj dependencies listę. Zachowaj wygenerowaną [tool.databricks.environment] sekcję lub dodaj ją, jeśli jej brakuje. Ustaw environment_version na obsługiwaną wersję (5 i nowszą). Na przykład:

   [project]
   name = "my-project"
   version = "0.1.0"
   dependencies = [
     "simplejson==3.18.1",
   ]
   
   [tool.databricks.environment]
   environment_version = "5"
   

5. Kliknij Zastosuj u góry edytora plików pyproject.toml.

   

Zaktualizowane środowisko jest dostępne dla notatników i plików dołączonych do tego samego wspólnego zasobu obliczeniowego. Aby sprawdzić środowisko, otwórz panel boczny Środowiska . Zobacz Konfiguruj środowisko bezserwerowe , aby uzyskać informacje o wersjach środowisk bezserwerowych i zainstalowanych zależnościach.

Zaplanuj laptop

Gdy zaplanujesz notatnik powiązany z Shared Serverless z folderu Git lub edytora pakietów, Azure Databricks używa pliku głównego pyproject.toml jako środowiska projektu zadania, jeśli taki plik istnieje. Wdroż pakiet, jak opisano w poniższych krokach.

1. W folderze lub edytorze pakietów Git otwórz notebook powiązany z Shared Serverless.
2. Jeśli folder Git lub pakiet Git zawiera plik główny pyproject.toml, sprawdź, czy deklaruje zależności wymagane przez zadanie.
3. Kliknij pozycję Harmonogram.
4. Z listy rozwijanej Compute wybierz bezserwerowe zasoby obliczeniowe.
5. Skonfiguruj harmonogram i kliknij Utwórz.

Po kliknięciu Stwórz sprawdź konfigurację zadania:

• Folder Git: Jeśli folder Git ma plik pyproject.toml root, sprawdź, czy Project environment w konfiguracji zadania wskazuje na niego. Aby zmienić wybór, zobacz Konfigurowanie środowiska dla zadań zadania.

• Pakiet: Edytor pakietów otwiera wygenerowany plik zadania YAML w folderze resources/ .

  1. Jeśli pakiet zawiera plik główny pyproject.toml, sprawdź, czy project_environment w sekcji spec środowiska wskazuje na niego względem wygenerowanego pliku YAML. Zobacz Konfiguruj środowisko projektu w pakiecie.
  2. Wdróż pakiet, aby stworzyć zadanie.

  Harmonogramy są domyślnie wstrzymywane w trybie deweloperskim. Zobacz Deklaratywne tryby wdrażania pakietów automatyzacji.

Opcje planowania notesów znajdziesz w artykule Tworzenie i zarządzanie zaplanowanymi zadaniami notesów.

Limitations

• Współdzielenie zasobów obliczeniowych jest ograniczone do bezserwerowych zasad użycia. Notatniki i pliki w tym samym folderze lub pakiecie Git, które stosują różne zasady korzystania, są przypisywane do oddzielnych zasobów obliczeniowych zamiast współdzielić jeden.

Dodatkowe zasoby

• Bezserwerowe przetwarzanie dla notebooków
• Konfiguracja środowiska bezserwerowego
• Tworzenie folderów Git i zarządzanie nimi
• Uruchamiaj polecenia powłoki w terminalu webowym
• Pakiety automatyzacji deklaratywnej