Databricks Sandbox
Beta
Este recurso está em Beta. To enable this recurso preview in the workspace, opt into the Databricks Sandbox setting in the workspace Previews page. See Gerenciar Databricks previews.
O Databricks Sandbox permite executar código não confiável em um ambiente isolado por meio da API REST do Databricks, do SDK ou da CLI do Databricks. O sandbox fornece compute serverless sob demanda para a execução dinâmica de códigos.
Each sandbox includes a persistent home directory. You can stop and começar a sandbox at any time, and the data in your home directory persists.
O sandbox é ideal para:
- Executando um harness de agentes.
- Executando código escrito pelo usuário ou escrito por AI.
- Running background tarefas or workers.
- Launching interactive IDE or SSH sessions.
Prerequisites
-
Your workspace must be in a supported region. See Recursos with limited regional availability.
-
To use the SDK, Python 3.10 or above.
-
To use the Databricks CLI over SSH, install the Databricks CLI and authenticate it with
databricks auth login:Bashdatabricks auth login # authenticate to a Databricks workspace
começar
Para criar uma sandbox e executar código nela, consulte Início rápido do Databricks Sandbox. O início rápido abrange cada maneira de usar uma sandbox:
-
Uma ferramenta sandbox para agentes que você cria com o Agent Bricks CLI.
-
O Databricks SDK para Python, a forma recomendada de trabalhar com sandboxes a partir de código.
-
A CLI do Databricks para conectar a um sandbox via SSH.
-
Omnigent, que pode usar um sandbox como host para sessões de agente.
Compute size
O Databricks Sandbox vem com 4 vCPUs e 8 GB de RAM. This size is not configurable.
Storage
No final do período de testes, o Databricks poderá realizar uma limpeza única dos dados armazenados nos sandboxes. Não armazene nada que você não possa perder.
O Databricks Sandbox vem com armazenamento conectado à rede.
- Os dados no seu diretório inicial (
/home/sandbox-agent) persistem durante todo o ciclo de vida do seu Databricks Sandbox. Mesmo após interromper o seu Databricks Sandbox, os dados no seu diretório inicial ficam disponíveis quando você iniciar a próxima sessão. - Seu diretório inicial pode armazenar até 100 GB. Você não pode alterar esse limite.
- Você pode armazenar até 10 GB fora do seu diretório inicial, mas esses dados serão excluídos quando você parar seu sandbox. Esse limite não se aplica a arquivos em
/Workspaceou/Volumes, que são armazenados no workspace ou volume. Consulte Acessar arquivos e volumes do workspace.
Acessar arquivos e volumes do workspace
Cada sandbox monta arquivos de workspace e volumes do Unity Catalog como diretórios locais. O código e os agentes no sandbox podem ler e gravar esses arquivos com ferramentas de arquivo padrão, como ls, cp ou open() do Python, sem chamar o Databricks SDK ou a Databricks CLI.
Caminho | Conteúdos |
|---|---|
| Arquivos do workspace, como |
| Arquivos em volumes do Unity Catalog. Consulte Trabalhar com arquivos em volumes do Unity Catalog. |
O acesso a esses caminhos usa uma credencial que o Databricks cria para o sandbox, não o token que você usa para chamar o sandbox. As restrições do seu tokens de chamada não se aplicam a esses caminhos. Essa credencial é separada da credencial do Databricks que o código no sandbox usa para chamar as APIs do Databricks. O acesso segue as permissões do workspace e do Unity Catalog da identidade do sandbox:
- Para um sandbox que você cria com o Databricks SDK ou a Databricks CLI, a identidade é o usuário que criou o sandbox.
- Para a ferramenta de sandbox Agent Bricks, a identidade é o usuário que enviou a solicitação, ou o service principal do aplicativo se você configurar a ferramenta com
--auth app. Veja Dar a um agente existente uma ferramenta de sandbox para executar código com segurança.
Essa identidade precisa das seguintes permissões:
- Arquivos de Workspace : permissão para view um arquivo de Workspace para lê-lo e permissão para editá-lo para escrevê-lo.
- Volumes : o privilégio
READ VOLUMEpara ler arquivos eREAD VOLUMEeWRITE VOLUMEpara gravar arquivos, além deUSE CATALOGeUSE SCHEMAno catálogo e esquema pai. Consulte Privilégios para volumes do Unity Catalog.
Os arquivos que você grava em /Workspace ou /Volumes são armazenados no workspace ou volume, não no armazenamento do sandbox, portanto, eles permanecem após você parar ou excluir o sandbox.
/Workspace e /Volumes são os únicos caminhos de dados do workspace montados em um sandbox. A DBFS root e os caminhos de armazenamento em cloud não estão disponíveis como caminhos locais em um sandbox.
Networking
There are no restrictions on network egress from a sandbox, and egress is not configurable.
Credenciais do Databricks
Para que o código em um sandbox possa chamar as APIs do Databricks, cada sandbox recebe provisionamento com uma credencial do Databricks que se autentica como a identidade do sandbox. Para um sandbox que você cria com o Databricks SDK ou Databricks CLI, esse é o usuário que criou o sandbox. Para a ferramenta de sandbox Agent Bricks, é o usuário que enviou a solicitação ou o service principal do aplicativo se você configurar a ferramenta com --auth app. Cada token na credencial é válido por 1 hora e é atualizado automaticamente antes de expirar. A atualização continua por até 24 horas, após as quais a credencial expira. Este tempo de vida da credencial é separado do limite de runtime de 24 horas. A credencial não depende da sua sessão de login, por isso continua funcionando se você sair ou se o seu próprio token expirar.
A credencial é salva como o perfil DEFAULT em ~/.databrickscfg, de modo que o Databricks SDK e o Databricks CLI no sandbox a usem automaticamente.
Imagens personalizadas
Você pode criar um sandbox a partir da sua própria imagem de contêiner armazenada em Artifact Registry, para que cada sandbox comece com seus pacotes, ferramentas e configuração já instalados. Consulte Criar um sandbox a partir de uma imagem personalizada.
Custos de uso
Atualmente, o Databricks não cobra pelo uso desse recurso. No entanto, o custo e os preços de recursos em versão beta estão sujeitos a alterações.
Para obter informações completas sobre o uso do faturamento, consulte Preços do Databricks. A Databricks prevê cobrança de uso de sandbox para:
- Runtime compute : Billed hourly while your Databricks Sandbox is running.
- Armazenamento persistente : você é cobrado pelos dados armazenados em seu diretório pessoal até que o seu Databricks Sandbox seja excluído. O armazenamento gera custos de cobrança enquanto a instância do Databricks Sandbox existir. Para parar de pagar pelo armazenamento, você deve excluir o sandbox.
- Data transfer
Limitações
- As cotas são aplicadas. Por default, você pode ter no máximo 200 sandboxes ativos por usuário (800 no total em todos os estados), e um workspace pode ter no máximo 400 sandboxes ativos (2.000 no total). Para solicitar um aumento, entre em contato com sua equipe de account do Databricks. Consulte Limites de recursos.
- Não é possível conectar-se via SSH a um sandbox que você cria com o Databricks SDK. Para se conectar via SSH, crie o sandbox com a CLI do Databricks. Consulte Use a CLI do Databricks para criar um sandbox.
- Databricks Sandbox is a compute primitive for running code, not a general-purpose Spark runtime. For Spark workloads, use Connect to serverless compute.
- Os endereços IP públicos do seu Databricks Sandbox podem mudar a qualquer momento. A entrada default do sandbox está fechada para todo o tráfego e você não pode alterar isso.
- Alterações fora do seu diretório home não persistem depois que você para um sandbox, exceto para arquivos que você grava em
/Workspaceou/Volumes. Veja Acessar arquivos e volumes do workspace. Para começar todos os sandboxes com os mesmos pacotes e configuração, use uma imagem personalizada. Veja Criar um sandbox a partir de uma imagem personalizada. Para reutilizar arquivos em sessões de um sandbox, armazene-os em seu diretório home. - Uma sandbox pode ser executada por no máximo 24 horas após cada começar. Após 24 horas, o Databricks interrompe a sandbox, incluindo quaisquer comandos e processos em execução em segundo plano. Esse limite se aplica mesmo quando a parada automática por inatividade está desativada com
--no-autostop, e você não pode estendê-lo por meio da CLI ou API do Databricks. Para continuar, começar a sandbox novamente, o que inicia um novo período de 24 horas. Os dados no seu diretório pessoal são mantidos.