Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Importante
Questa funzionalità è in versione beta. Per abilitare questa anteprima di funzionalità nello spazio di lavoro, opta per l'impostazione Sandbox Databricks nella pagina Anteprime dello spazio di lavoro. Vedere Gestire le anteprime di Azure Databricks.
Databricks Sandbox ti permette di eseguire codice non affidabile in un ambiente isolato tramite l'API REST di Databricks, SDK o la CLI di Databricks. Il sandbox fornisce potenza di calcolo serverless, su richiesta, per eseguire il codice in modo dinamico.
Ogni sandbox include una directory home persistente. Puoi fermarti e avviare un sandbox in qualsiasi momento, e i dati nella tua cartella domestica persistono.
Il sandbox è ideale per:
- Uso un imbracatore per agenti.
- Esecuzione di codice scritto dagli utenti o dall'IA.
- Esecuzione di attività o processi di lavoro in background.
- Lancio di sessioni interattive IDE o SSH.
Prerequisiti
L'area di lavoro deve trovarsi in un'area supportata. Consulta Funzionalità con disponibilità regionale limitata.
Per usare l'SDK, Python 3.10 o superiore.
Per utilizzare la CLI Databricks su SSH, installa la CLI Databricks e autenticala con
databricks auth login:databricks auth login # authenticate to a Databricks workspace
Get started
Per creare un sandbox ed eseguire codice al suo interno, vedi Databricks Sandbox quickstart. Il quickstart copre ogni modo per usare un sandbox:
- Uno strumento sandbox per agenti che costruisci con la CLI di Agent Bricks.
- L'SDK di Databricks per Python, il modo consigliato per lavorare con sandbox dal codice.
- La CLI Databricks, per collegarsi a un sandbox tramite SSH.
Dimensioni di calcolo
Il Sandbox di Databricks è dotato di 4 vCPU e 8 GB di RAM. Questa dimensione non è configurabile.
Storage
Avvertimento
Al termine del periodo Beta, Databricks potrebbe effettuare una purga unica dei dati memorizzati in sandbox. Non conservare nulla che non puoi permetterti di perdere.
Databricks Sandbox è dotato di storage collegato alla rete.
- I dati nella directory home (
/home/sandbox-agent) persistono per tutta la durata della sandbox Databricks. Anche dopo aver arrestato il tuo Databricks Sandbox, i dati nella tua directory Home sono disponibili quando avvii la sessione successiva. - La tua directory home può memorizzare fino a 100 GB. Non puoi cambiare questo limite.
- Puoi memorizzare fino a 10 GB fuori dalla directory di casa, ma questi dati vengono cancellati quando chiudi il sandbox. Questo limite non si applica ai file sotto
/Workspaceo/Volumes, che sono memorizzati nell'area di lavoro o nel volume. Vedi Accedere ai file e ai volumi dell'area di lavoro.
Accedi ai file e ai volumi dell'area di lavoro
Ogni sandbox monta file di spazio di lavoro e volumi di Unity Catalog come directory locali. Il codice e gli agenti nella sandbox possono leggere e scrivere questi file con strumenti standard per file, come ls, cp, o Pythonopen(), senza chiamare l'SDK di Databricks o la CLI di Databricks.
| Percorso | Contenuto |
|---|---|
/Workspace |
File di spazio di lavoro, come /Workspace/Users/<user-name> e /Workspace/Shared. Vedi Interagire programmaticamente con i file dell'area di lavoro. |
/Volumes/<catalog>/<schema>/<volume> |
File nei volumi di Unity Catalog. Consultare Usare i file nei volumi del catalogo Unity. |
L'accesso a questi percorsi utilizza un'credenziale creata da Azure Databricks per il sandbox, non il token che usi per chiamare il sandbox. Le restrizioni sul token di chiamata non si applicano a questi percorsi. Questa credenziale è separata dalla credenziale Databricks che il codice nella sandbox utilizza per chiamare le API di Azure Databricks. L'accesso segue l'area di lavoro e i permessi del Catalogo Unity dell'identità della sandbox:
- Per una sandbox che crei con l'SDK Databricks o la CLI Databricks, l'identità è l'utente che ha creato la sandbox.
- Per lo strumento sandbox Agent Bricks, l'identità è l'utente che ha inviato la richiesta, oppure il principale di servizio dell'app se si configura lo strumento con
--auth app. Vedi Assegnare a un agente esistente uno strumento sandbox per eseguire codice in sicurezza.
Quell'identità necessita dei seguenti permessi:
- File dell'area di lavoro: Permesso per visualizzare un file dell'area di lavoro per leggerlo e permesso per modificarlo per scriverlo.
-
Volumi: Il privilegio
READ VOLUMEper leggere i file, e siaREAD VOLUMEcheWRITE VOLUMEper scrivere i file, piùUSE CATALOGeUSE SCHEMAsul catalogo e sullo schema genitore. Vedere Privilegi per i volumi del catalogo Unity.
I file che scrivi in /Workspace o /Volumes sono memorizzati nell'area di lavoro o nel volume, non nell'archiviazione sandbox, quindi rimangono dopo che interrompi o elimini la sandbox.
/Workspace e /Volumes sono gli unici percorsi dati dell'area di lavoro montati in una sandbox. I percorsi root e cloud storage DBFS non sono disponibili come percorsi locali in un sandbox.
Networking
Non ci sono restrizioni sull'uscita di rete da un sandbox, e l'uscita non è configurabile. L'ingresso diretto all'IP pubblico della sandbox è chiuso a tutto il traffico, e non puoi cambiarlo.
Port forwarding
Per raggiungere un server web, un notebook o un'API in esecuzione in una sandbox dal tuo computer, usa il port forwarding. Il traffico inoltrato passa attraverso l'area di lavoro invece di utilizzare l'IP pubblico della sandbox. Solo il proprietario della sandbox può inoltrare una porta. Per le istruzioni, vedi Inoltrare una porta da una sandbox.
Credenziali Databricks
Quindi il codice in un sandbox può richiamare le API di Azure Databricks, a ogni sandbox viene fornita una credential Azure Databricks che si autentica come identità del sandbox. Per una sandbox che crei con l'SDK o la CLI Databricks, quello è l'utente che ha creato la sandbox. Per lo strumento sandbox Agent Bricks, è l'utente che ha inviato la richiesta, oppure il principale di servizio dell'app se configuri lo strumento con --auth app. Ogni token nella credenziale è valido per 1 ora e viene aggiornato automaticamente prima della scadenza. Il refresh continua per un massimo di 24 ore, dopodiché la credenziale scade. Questa durata della credenziale è separata dal limite di durata di 24 ore. La credenziale non dipende dalla tua sessione di accesso, quindi continua a funzionare se esci o se il tuo token scade.
La credenziale viene salvata come profilo DEFAULT in ~/.databrickscfg, quindi l'SDK Databricks e la CLI Databricks nel sandbox la usano automaticamente.
Immagini personalizzate
Puoi creare un sandbox dalla tua immagine container archiviata in Artifact Registry, così ogni sandbox inizia con i tuoi pacchetti, strumenti e configurazione già installati. Vedi Crea un sandbox da un'immagine personalizzata.
Costi di utilizzo
Databricks attualmente non addebita l'utilizzo di questa funzione. Tuttavia, costi e prezzi delle funzionalità in Beta sono soggetti a variazioni.
Per informazioni complete sull'utilizzo della fatturazione, vedi la tariffazione di Databricks. Databricks prevede la fatturazione dell'utilizzo sandbox per:
- Capacità di calcolo runtime: fatturata su base oraria mentre Databricks Sandbox è in esecuzione.
- Archiviazione persistente: Vieni addebitato per i dati memorizzati nella tua cartella domestica fino a quando il tuo Sandbox Databricks non viene eliminato. Lo storage comporta una fatturazione finché l'istanza Sandbox Databricks esiste. Per smettere di pagare per lo storage, devi eliminare il sandbox.
- Trasferimento dati
Limitazioni
- Le quote vengono applicate. Di default, puoi avere al massimo 200 sandbox attive per utente (800 in totale in tutti gli stati), e uno spazio di lavoro può avere al massimo 400 sandbox attive (2.000 in totale in tutti gli stati). Per richiedere un aumento, contatta il team account di Azure Databricks. Vedere Limiti delle risorse.
- Non puoi connetterti via SSH a un sandbox che crei con l'SDK Databricks. Per connetterti tramite SSH, crea il sandbox con la Databricks CLI. Vedi Usa la CLI Databricks per creare un sandbox.
- Il Sandbox di Databricks è un primitivo di calcolo per l'esecuzione del codice, non un runtime Spark generico. Per i carichi di lavoro di Spark, usa Connect to serverless compute.
- Gli indirizzi IP pubblici del tuo Sandbox Databricks possono cambiare in qualsiasi momento.
- Le modifiche al di fuori della cartella home non persistono dopo l'arresto di una sandbox, tranne per i file sotto cui scrivi
/Workspaceo/Volumes. Vedi Accedere ai file e ai volumi dell'area di lavoro. Per iniziare ogni sandbox con gli stessi pacchetti e configurazioni, usa un'immagine personalizzata. Vedi Crea un sandbox da un'immagine personalizzata. Per riutilizzare file tra le sessioni di un sandbox, memorizzali nella tua cartella principale. - Un sandbox può funzionare per al massimo 24 ore dopo ogni avvio. Dopo 24 ore, Azure Databricks interrompe il sandbox, inclusi i comandi in esecuzione e i processi in background. Questo limite si applica anche quando l'arresto automatico per inattività è disattivato con
--no-autostop, e non puoi estenderlo tramite la CLI o l'API di Databricks. Per continuare, ricominciare il sandbox, che inizia un nuovo periodo di 24 ore. I dati nella tua directory domestica sono conservati.