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. Neste momento, esta não pode ser alterada.
- Você pode armazenar até 10 GB fora do seu diretório inicial, mas esses dados serão excluídos quando você parar o sandbox.
Networking
There are no restrictions on network egress from a sandbox, and egress is not configurable.
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. 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).
- 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. O default ingress do sandbox é fechado para todo o tráfego. Isso não pode ser alterado no momento.
- As alterações fora do seu diretório inicial não persistem depois que você para um sandbox. Para fazer cada sandbox começar com os mesmos pacotes e a mesma configuração, use uma imagem personalizada. Consulte Criar um sandbox a partir de uma imagem personalizada. Para reutilizar arquivos entre sessões de um sandbox, armazene-os no seu diretório inicial.