Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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
Obszar roboczy musi znajdować się w obsługiwanym regionie. Zobacz funkcje o ograniczonej dostępności regionalnej.
Aby korzystać z SDK, Python 3.10 lub nowszy.
Aby korzystać z Databricks CLI przez SSH, zainstaluj Databricks CLI i uwierzytelnij go za pomocą
databricks auth login:databricks auth login # authenticate to a Databricks workspace
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
/Workspacelub/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 VOLUMEdo odczytu plików oraz zarównoWRITE VOLUME, jak iREAD VOLUMEdo zapisu plików, a ponadtoUSE CATALOGiUSE SCHEMAw 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
/Workspacelub/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.