Databricks Sandbox

Ważna

Ta funkcja jest dostępna w wersji beta. Aby włączyć podgląd tej funkcji w obszarze roboczym, włącz ustawienie Databricks Sandbox na stronie Podglądy obszaru roboczego. Zobacz Zarządzanie wersjami zapoznawczami usługi Azure Databricks.

Databricks Sandbox pozwala uruchamiać niezaufany kod w izolowanym środowisku przez Databricks REST API, SDK lub Databricks CLI. Sandbox zapewnia bezserwerowe, na żądanie obliczenia do dynamicznego uruchamiania kodu.

Każdy sandbox zawiera trwały katalog macierzysty. W dowolnym momencie możesz zatrzymać i ponownie uruchomić sandbox, a dane w katalogu domowym są zachowywane.

Piaskownica jest idealna do:

  • Prowadzenie uprzęży agenta.
  • Wykonywanie kodu napisanego przez użytkownika lub AI.
  • Uruchamianie zadań w tle lub procesów roboczych.
  • Uruchamianie interaktywnych sesji IDE lub SSH.

Wymagania wstępne

Wprowadzenie

Aby utworzyć piaskownicę i uruchomić w niej kod, zobacz quickstart Databricks Sandbox. Quickstart obejmuje każdy sposób korzystania z sandboxa:

  • Narzędzie sandboxowe do tworzenia agentów za pomocą Agent Bricks CLI.
  • Databricks SDK dla Pythona, polecany sposób pracy z piaskownicami za pomocą kodu.
  • Databricks CLI, aby połączyć się z piaskownicą przez SSH.

Rozmiar obliczeniowy

Databricks Sandbox jest wyposażony w 4 vCPU i 8 GB RAM. Ten rozmiar nie da się konfigurować.

Magazyn

Warning

Pod koniec okresu beta Databricks może przeprowadzić jednorazowe czyszczenie danych przechowywanych w piaskownicach. Nie przechowuj niczego, czego nie możesz sobie pozwolić stracić.

Databricks Sandbox jest wyposażony w pamięć masową podłączoną do sieci.

  • Dane w twoim katalogu domowym (/home/sandbox-agent) są zachowywane przez cały okres istnienia środowiska Databricks Sandbox. Nawet po zamknięciu Databricks Sandbox, dane w katalogu domowym są dostępne przy rozpoczęciu kolejnej sesji.
  • Twój katalog domowy może przechowywać do 100 GB. Nie możesz zmienić tego limitu.
  • Możesz przechowywać do 10 GB poza swoim katalogiem domowym, ale te dane są usuwane, gdy zamykasz sandbox. Ten limit nie dotyczy plików pod /Workspace lub /Volumes, które są przechowywane w przestrzeni roboczej lub woluminie. Zobacz Uzyskiwanie dostępu do plików i woluminów w przestrzeni roboczej.

Dostęp do plików i woluminów przestrzeni roboczej

Każdy sandbox montuje pliki workspace i tomy Unity Catalog jako lokalne katalogi. Kod i agenci w piaskownicy mogą odczytywać i zapisywać te pliki za pomocą standardowych narzędzi plikowych, takich jak ls, cp lub Python open(), bez wywoływania Databricks SDK lub Databricks CLI.

Ścieżka Spis treści
/Workspace Pliki przestrzeni roboczej, takie jak /Workspace/Users/<user-name> i /Workspace/Shared. Zobacz Programatyczna interakcja z plikami przestrzeni roboczej.
/Volumes/<catalog>/<schema>/<volume> Pliki w woluminach Unity Catalog. Zobacz Praca z plikami w woluminach katalogu Unity.

Dostęp do tych ścieżek korzysta z uwierzytelniania tworzonego przez Azure Databricks dla sandboxu, a nie tokena, którego używasz do wywołania sandboxu. Ograniczenia dotyczące tokena wywołującego nie dotyczą tych ścieżek. To poświadczenie jest odrębne od poświadczenia Databricks, którego kod w piaskownicy używa do wywoływania interfejsów API Azure Databricks. Dostęp podąża za uprawnieniami przestrzeni roboczej i katalogu Unity dotyczącymi tożsamości sandboxu:

  • W sandboxie, który tworzysz za pomocą Databricks SDK lub Databricks CLI, tożsamość to użytkownik, który stworzył sandbox.
  • W narzędziu piaskownicy Agent Bricks tożsamością jest użytkownik, który wysłał żądanie, lub jednostka usługi aplikacji, jeśli skonfigurujesz narzędzie za pomocą --auth app. Zobacz Daj istniejącemu agentowi narzędzie sandbox do bezpiecznego wykonywania kodu.

Ta tożsamość wymaga następujących uprawnień:

  • Pliki workspace: Uprawnienia do przeglądania pliku workspace w celu jego odczytu oraz uprawnienia do edycji w celu zapisu.
  • Woluminy: Przywilej READ VOLUME do odczytu plików oraz zarówno WRITE VOLUME, jak i READ VOLUME do zapisu plików, a ponadto USE CATALOG i USE SCHEMA w katalogu nadrzędnym i schemacie. Zobacz Uprawnienia dla woluminów Unity Catalog.

Pliki zapisane w lokalizacji /Workspace lub /Volumes są przechowywane w przestrzeni roboczej lub woluminie, a nie w pamięci masowej sandboxa, więc pozostają po zatrzymaniu lub usunięciu sandboxa.

/Workspace i /Volumes są jedynymi ścieżkami danych w przestrzeni roboczej zamontowanymi w piaskownicy. Główny katalog DBFS i ścieżki magazynu w chmurze nie są dostępne jako ścieżki lokalne w piaskownicy.

Sieć

Nie ma ograniczeń dotyczących wyjścia z sieci z piaskownicy, a wyjście nie jest konfigurowalne. Bezpośredni dostęp do publicznego IP sandboxa jest zamknięty dla całego ruchu i nie da się tego zmienić.

Przekierowywanie portów

Aby uzyskać dostęp do serwera WWW, notebooka lub API działającego w piaskownicy z Twojego komputera, użyj przekierowania portów. Przekazywany ruch przechodzi przez przestrzeń roboczą zamiast korzystać z publicznego IP piaskownicy. Tylko właściciel sandboxa może przekierować port. Instrukcje znajdziesz w sekcji Przekaż port z piaskownicy.

Poświadczenia Databricks

Aby kod w piaskownicy mógł wywoływać API Azure Databricks, każdy sandbox jest wyposażony w poświadczenie Azure Databricks, które uwierzytelnia się jako tożsamość sandboxa. W przypadku sandboxa, który tworzysz za pomocą Databricks SDK lub Databricks CLI, to jest użytkownik, który utworzył sandbox. W przypadku narzędzia sandbox Agent Bricks jest to użytkownik, który wysłał żądanie, lub podmiot usługowy aplikacji, jeśli skonfigurujesz narzędzie za pomocą --auth app. Każdy token w poświadczeniu jest ważny przez 1 godzinę i jest automatycznie odświeżany przed wygaśnięciem. Odświeżanie trwa do 24 godzin, po czym poświadczenie wygasa. Ten okres ważności poświadczenia jest oddzielny od 24-godzinnego limitu czasu działania. Poświadczenie nie zależy od sesji logowania, więc działa dalej, jeśli się wylogujesz lub Twój własny token wygaśnie.

Dane uwierzytelniające są zapisywane jako DEFAULT profil w ~/.databrickscfg, więc Databricks SDK oraz Databricks CLI w piaskownicy używają go automatycznie.

Obrazy niestandardowe

Możesz stworzyć piaskownicę z własnego obrazu kontenera zapisanego w Artifact Registry, więc każdy sandbox zaczyna się z zainstalowanymi pakietami, narzędziami i konfiguracją. Zobacz Utwórz piaskownicę z obrazu niestandardowego.

Koszty użytkowania

Databricks obecnie nie pobiera opłat za korzystanie z tej funkcji. Jednak koszty i ceny funkcji w wersji beta mogą ulec zmianie.

Aby uzyskać pełne informacje o użyciu na potrzeby rozliczeń, zobacz Cennik Databricks. Databricks przewiduje wykorzystanie sandboxa rozliczeniowego dla:

  • Obliczenia w czasie działania: Rozliczane godzinowo, gdy działa Databricks Sandbox.
  • Trwała pamięć: Jesteś obciążany za dane przechowywane w twoim katalogu do momentu usunięcia Databricks Sandbox. Opłaty za magazyn danych są naliczane tak długo, jak istnieje instancja Databricks Sandbox. Aby przestać płacić za przechowywanie, musisz usunąć piaskownicę.
  • Transfer danych

Limitations

  • Kwoty są egzekwowane. Domyślnie można mieć maksymalnie 200 aktywnych piaskownic na użytkownika (łącznie 800 we wszystkich stanach), a przestrzeń robocza może mieć maksymalnie 400 aktywnych piaskownic (łącznie 2 000). Aby poprosić o zwiększenie, skontaktuj się z zespołem konta Azure Databricks. Zobacz Limity zasobów.
  • Nie możesz połączyć się przez SSH z piaskownicą, którą tworzysz za pomocą Databricks SDK. Aby połączyć się przez SSH, utwórz sandbox za pomocą Databricks CLI. Zobacz Użyj CLI Databricks do utworzenia piaskownicy.
  • Databricks Sandbox to podstawowy element środowiska obliczeniowego do uruchamiania kodu, a nie uniwersalne środowisko uruchomieniowe Spark. Dla obciążeń Spark użyj Connect to serverless compute.
  • Publiczne adresy IP Twojego Databricks Sandbox mogą się zmienić w dowolnym momencie.
  • Zmiany poza twoim katalogiem domowym nie są zachowywane po zatrzymaniu sandboxu, z wyjątkiem plików, które zapisujesz pod /Workspace lub /Volumes. Zobacz Uzyskiwanie dostępu do plików i woluminów w przestrzeni roboczej. Aby rozpocząć każdy sandbox z tymi samymi pakietami i konfiguracją, użyj niestandardowego obrazu. Zobacz Utwórz piaskownicę z obrazu niestandardowego. Aby ponownie używać plików w sesjach jednego sandboxu, przechowuj je w swoim katalogu domowym.
  • Sandbox może działać maksymalnie 24 godziny po każdym starcie. Po 24 godzinach Azure Databricks zatrzymuje sandbox, w tym wszystkie działające polecenia i procesy działające w tle. To ograniczenie obowiązuje nawet wtedy, gdy automatyczne zatrzymanie z powodu nieaktywności jest wyłączone za pomocą --no-autostop, i nie można go rozszerzyć przez Databricks CLI lub API. Aby kontynuować, uruchom piaskownicę od nowa, co rozpocznie nowy 24-godzinny okres. Dane w Twoim katalogu domowym są przechowywane.