Konfiguruj swój projekt Databricks

Rozszerzenie IDE Databricks oferuje widok Configuration w ramach rozszerzenia, który pozwala łatwo konfigurować i aktualizować ustawienia dla projektu Databricks. Funkcje te obejmują lokalne ustawienia folderów, instalację narzędzi AI, selektor wdrożenia docelowej przestrzeni roboczej, łatwą konfigurację uwierzytelniania i obliczeń, synchronizację folderów w przestrzeni roboczej oraz proste kroki do aktywacji wirtualnego środowiska Python niezbędnych do debugowania.

Widok Configuration w rozszerzeniu IDE Databricks jest dostępny po utworzeniu lub migracji projektu do projektu Databricks. Zobacz Utwórz nowy projekt usługi Databricks.

Uwaga

Wcześniejsze wersje rozszerzenia IDE Databricks definiowały ustawienia konfiguracyjne w pliku JSON projektu, a zmienne środowiskowe były ustawiane w terminalu. W wersji wydania konfiguracja projektu i środowiska znajduje się w plikach databricks.yml i databricks.env .

Jeśli Twój projekt jest Databricks Asset Bundle, UI rozszerzenia Databricks udostępnia również Eksplorator zasobów pakietu i Widok zmiennych pakietu do zarządzania zasobami i zmiennymi pakietów. Zobacz funkcje Bundle i explorer.

Ustaw lokalny folder

Aby wybrać inny lokalny folder dla swojego projektu Databricks, kliknij ikonę trybiki powiązanej z wpisem Local Folder w widoku Konfiguracja .

Instaluj i używaj narzędzi AI

Ważna

Ta funkcja jest dostępna w wersji beta.

Sekcja narzędzi AI w widoku Konfiguracja pozwala zainstalować narzędzia AI, dzięki czemu twoi agenci programistyczne skutecznie współpracują z Azure Databricks. Rozszerzenie sprawdza, czy narzędzia AI są zainstalowane w globalnym lub projektowym zakresie, w tym instalacjach wykonanych przez Azure Databricks CLI, i aktualizuje wyświetlany status. Więcej informacji o narzędziach AI można znaleźć w artykule Umiejętności agentów dla asystentów kodowania AI i aitools grupy dowodzenia.

Aby zainstalować narzędzia AI:

  1. W widoku Konfiguracja rozszerzenia kliknij Install AI tools.
  2. Podążaj za instrukcjami, aby wybrać teleskop i narzędzia do wykonania instalacji.

Gdy narzędzia AI są zainstalowane, obok narzędzi AI pojawia się zielona ikona robota. Narzędzia AI automatycznie aktualizują się do najnowszej wersji.

Narzędzia AI do rozszerzenia Databricks

Aby odinstalować narzędzia AI, kliknij prawym przyciskiem myszy narzędzia AI i wybierz Odinstaluj narzędzia AI.

Zmienianie docelowego obszaru roboczego wdrożenia

Aby wybrać lub przełączyć cel wdrożenia dla projektu usługi Databricks (na przykład aby przełączyć się z docelowego dev na docelowy prod):

  1. W widoku Configuration rozszerzenia Databricks kliknij ikonę trybicy (Wybierz cel pakietu zasobów Databricks) powiązaną z Targetem.

    Wybierz element docelowy pakietu

  2. W palecie poleceń , wybierz żądany cel wdrożenia.

Po skonfigurowaniu celu zostanie wyświetlony host i tryb wdrożenia. Aby uzyskać informacje na temat trybów wdrażania deklaratywnych pakietów automatyzacji, zobacz Tryby wdrażania deklaratywnych pakietów automatyzacji.

Host obszaru roboczego można zmienić, modyfikując ustawienie docelowe workspace w databricks.yml pliku konfiguracji skojarzonym z projektem. Zobacz cele.

Uwaga

Następujące funkcje rozszerzenia IDE Databricks są dostępne tylko wtedy, gdy docelowy tryb wdrożenia jest rozwijany:

  • Używanie dołączonego klastra programistycznego na potrzeby zadań pakietu
  • Synchronizowanie plików folderów obszaru roboczego
  • Wybieranie interaktywnego klastra programistycznego

Konfigurowanie profilu usługi Databricks dla projektu

Podczas tworzenia projektu usługi Databricks lub konwertowania projektu jako projektu usługi Databricks należy skonfigurować profil zawierający ustawienia uwierzytelniania używane do nawiązywania połączenia z usługą Databricks. Jeśli chcesz zmienić używany profil uwierzytelniania, kliknij ikonę koła zębatego skojarzonego z AuthType w widoku Konfiguracja .

Aby uzyskać więcej informacji o uwierzytelnianiu rozszerzenia Databricks IDE, zobacz Ustaw autoryzację dla rozszerzenia Databricks IDE.

Wybieranie zasobów obliczeniowych na potrzeby uruchamiania kodu i zadań

Korzystając z rozszerzenia IDE Databricks, możesz wybrać serwerless, wybrać istniejący klaster Azure Databricks lub utworzyć nowy klaster Azure Databricks do uruchamiania kodu i zadań. Po nawiązaniu połączenia z obliczeniami wyświetlany jest identyfikator klastra, wersja środowiska Databricks Runtime, twórca, stan i tryb dostępu. Możesz również uruchomić i zatrzymać klaster, a następnie przejść bezpośrednio do szczegółów strony klastra.

Napiwek

Jeśli nie chcesz czekać na uruchomienie klastra zadań, zaznacz Zastąp klaster zadań w pakiecie tuż poniżej wyboru klastra, aby użyć wybranego klastra do uruchamiania zadań pakietu w trybie deweloperskim. Nie jest to dostępne, jeśli używasz bezserwerowych obliczeń.

Korzystaj z rozwiązań bezserwerowych

Przetwarzanie bezserwerowe jest zarządzane przez usługę Azure Databricks. Po uruchomieniu obciążeń na obliczeniach bezserwerowych usługa Azure Databricks automatycznie przydziela niezbędne zasoby obliczeniowe i zarządza nimi.

  1. W widoku Konfiguracja kliknij Wybierz obliczenia lub ikonę zębatego (Konfiguruj obliczenia).

    Configure compute

  2. W palety poleceńwybierz pozycję Bezserwerowa.

    wybór bezserwerowego przetwarzania

Korzystanie z istniejącego klastra

Jeśli masz istniejący klaster usługi Azure Databricks, którego chcesz użyć:

  1. W widoku Konfiguracja kliknij Wybierz obliczenia lub ikonę zębatego (Konfiguruj obliczenia).

  2. W Palecie Poleceńwybierz klaster, którego chcesz użyć.

Tworzenie nowego klastra

Jeśli nie masz istniejącego klastra usługi Azure Databricks lub chcesz utworzyć nowy klaster:

  1. W widoku Konfiguracja kliknij Wybierz obliczenia lub ikonę zębatego (Konfiguruj obliczenia).

  2. W palecie poleceń kliknij pozycję Utwórz nowy klaster.

  3. Po wyświetleniu monitu o otwarcie zewnętrznej witryny internetowej (obszaru roboczego usługi Azure Databricks) kliknij przycisk Otwórz.

  4. Jeśli zostanie wyświetlony monit, zaloguj się do obszaru roboczego usługi Azure Databricks.

  5. Postępuj zgodnie z instrukcjami, aby utworzyć klaster.

    Uwaga

    Usługa Databricks zaleca utworzenie klastra Personal Compute. Dzięki temu można natychmiast rozpocząć uruchamianie obciążeń, minimalizując obciążenie związane z zarządzaniem obliczeniami.

  6. Po utworzeniu i uruchomieniu klastra wróć do programu Visual Studio Code.

  7. W widoku Konfiguracja , obok klastra, kliknij ikonę zębatki (Konfiguruj obliczenia).

    Konfigurowanie ikony klastra 3

    W Palecie poleceń kliknij klaster, który chcesz użyć.

Zsynchronizuj folder obszaru roboczego z Databricks

Możesz zsynchronizować zdalny folder roboczego Databricks powiązany z Twoim projektem Databricks, klikając ikonę synchronizacji (Start synchronization) powiązaną z Remote Folder w widoku Configuration rozszerzenia Databricks.

Uwaga

Rozszerzenie IDE Databricks działa wyłącznie z katalogami przestrzeni roboczych, które sam tworzy w sobie. Nie można użyć istniejącego katalogu obszaru roboczego w projekcie, chyba że został utworzony przez rozszerzenie.

Aby przejść do widoku obszaru roboczego w usłudze Databricks, kliknij ikonę linku zewnętrznego (Otwórz link zewnętrznie) skojarzoną z Folderem Zdalnym.

Rozszerzenie określa folder obszaru roboczego usługi Azure Databricks do użycia na podstawie ustawienia file_path w mapowaniu wiązanej z projektem konfiguracji pakietu workspace. Zobacz obszar roboczy.

Uwaga

Rozszerzenie IDE Databricks wykonuje tylko jednokierunkową, automatyczną synchronizację zmian plików z lokalnego projektu Visual Studio Code do powiązanego folderu workspace w zdalnym obszarze pracy Azure Databricks. Pliki w tym zdalnym katalogu obszaru roboczego mają być przejściowe. Nie inicjuj zmian tych plików z obszaru roboczego zdalnego, ponieważ te zmiany nie zostaną zsynchronizowane z powrotem do projektu lokalnego.

Szczegóły dotyczące funkcji synchronizacji katalogów w przestrzeni roboczej dla wcześniejszych wersji rozszerzenia Databricks IDE można znaleźć w artykule Wybierz katalog przestrzeni roboczej dla rozszerzenia Databricks IDE.

Rozpocznij tunel SSH

Ważna

Ta funkcja jest dostępna w wersji beta.

Możesz uruchomić tunel SSH z rozszerzenia IDE Databricks, aby otworzyć zdalną sesję deweloperską na obliczeniach Azure Databricks. Pozwala to edytować pliki i uruchamiać kod bezpośrednio na zdalnym komputerze z Visual Studio Code.

  1. Aby rozpocząć tunel SSH, kliknij przycisk Start tunelu SSH w widoku tunelu SSH w rozszerzeniu.

  2. Następnie wybierz klasyczne lub serwerowe obliczenia, aby się połączyć do:

    • Klaster: Wybór klastrów pokazuje tylko klastry korzystające z dedykowanego (jednoużytkownikowego) trybu dostępu. Jeśli masz już wybrany klaster dla jednego użytkownika w lokalnej sesji Visual Studio Code, ten klaster jest wcześniej wybrany do połączenia SSH.
    • Serwerless: Jeśli nie wybierzesz klastra, tunel domyślnie łączy się z serwerless-computment.

Gdy uruchamiasz tunel, nowa instancja Visual Studio Code otwiera się w tym samym IDE, którego obecnie używasz. Sesja zdalna domyślnie otwiera twój folder domowy (users/username@databricks.com) i automatycznie wyświetla konkretny plik, który aktywnie edytowałeś. Uwierzytelnianie jest wstępnie skonfigurowane, więc nie musisz się ponownie logować, aby połączyć się z sesją zdalną.

Konfigurowanie środowiska języka Python i usługi Databricks Connect

Sekcja Środowisko języka Python w widoku Konfiguracja umożliwia łatwą konfigurację wirtualnego środowiska deweloperskiego języka Python i instalację programu Databricks Connect na potrzeby uruchamiania i debugowania kodu i komórek notesu. Środowiska wirtualne języka Python zapewniają, że projekt korzysta z zgodnych wersji pakietów python i Python (w tym przypadku pakietu Databricks Connect).

Aby skonfigurować wirtualne środowisko Python dla swojego projektu, w widoku Configuration rozszerzenia:

  1. Kliknij czerwony element Aktywuj środowisko wirtualne w obszarze Środowisko języka Python.
  2. W palecie poleceń wybierz pozycję Venv lub Conda.
  3. Wybierz zależności, które chcesz zainstalować, jeśli istnieją.

Aby zmienić środowiska, kliknij ikonę koła zębatego (Zmień wirtualne środowisko) skojarzone z Aktywnym Środowiskiem.

Aby uzyskać informacje o instalacji Databricks Connect, który umożliwia uruchamianie i debugowanie kodu oraz notatników w Visual Studio Code, zobacz Debug code using Databricks Connect dla rozszerzenia Databricks IDE.