Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Importante
Esse recurso está em Beta. Para habilitar essa pré-visualização no workspace, opte pela configuração Databricks Sandbox na página de Pré-visualizações do workspace. Consulte Gerenciar visualizações do Azure Databricks.
O Databricks Sandbox permite que você execute código não confiável em um ambiente isolado através da API REST, SDK ou CLI do Databricks. O sandbox oferece computação sem servidor, sob demanda, para rodar código dinamicamente.
Cada sandbox inclui um diretório doméstico persistente. Você pode parar e iniciar um sandbox a qualquer momento, e os dados no seu diretório pessoal permanecem.
O sandbox é ideal para:
- Executando um ambiente de agentes.
- Executar código escrito por usuários ou IA.
- Rodando tarefas ou trabalhadores em segundo plano.
- Lançamento de sessões interativas de IDE ou SSH.
Pré-requisitos
Seu workspace deve estar em uma região com suporte. Consulte Recursos com disponibilidade regional limitada.
Para usar o SDK, Python 3.10 ou superior.
Para usar a CLI Databricks via SSH, instale a CLI Databricks e autentique-a com
databricks auth login:databricks auth login # authenticate to a Databricks workspace
Introdução
Para criar um sandbox e rodar código nele, veja o início rápido do Databricks Sandbox. O quickstart cobre cada forma de usar um sandbox:
- Uma ferramenta sandbox para agentes que você constrói com a CLI do Agent Bricks.
- O SDK Databricks para Python, a forma recomendada de trabalhar com sandboxes a partir de código.
- A CLI do Databricks para se conectar a um sandbox via SSH.
Tamanho da computação
O Databricks Sandbox vem com 4 vCPUs e 8 GB de RAM. Esse tamanho não é configurável.
Armazenamento
Warning
Ao final do período Beta, os Databricks podem realizar uma purga única dos dados armazenados em sandboxes. Não guarde nada que você não possa se dar ao luxo de perder.
O Databricks Sandbox vem com armazenamento conectado à rede.
- Os dados no seu diretório inicial (
/home/sandbox-agent) persistem durante toda a vida útil do seu Databricks Sandbox. Mesmo após parar o Databricks Sandbox, os dados no seu diretório pessoal estarão disponíveis quando você iniciar sua próxima sessão. - Seu diretório doméstico pode armazenar até 100 GB. Neste momento, isso não pode ser mudado.
- Você pode armazenar até 10 GB fora do seu diretório principal, mas esses dados são excluídos quando você para o sandbox.
Rede
Não há restrições sobre saída de rede a partir de um sandbox, e a saída não é configurável.
Credenciais do Databricks
Assim, o código em um sandbox pode chamar APIs do Azure Databricks, cada sandbox é provisionado com uma credencial do Azure Databricks que autentica como o usuário que criou o sandbox. 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. A credencial não depende da sua sessão de login, então ela continua funcionando se você sair ou se seu próprio token expirar.
A credencial é salva como o DEFAULT perfil em ~/.databrickscfg, então o SDK Databricks e a CLI Databricks no sandbox a usam automaticamente.
Imagens personalizadas
Você pode criar um sandbox a partir da sua própria imagem de contêiner armazenada no Artifact Registry, então todo sandbox começa com seus pacotes, ferramentas e configuração já instalada. Consulte Como criar uma área restrita a partir de uma imagem personalizada.
Custos de uso
Atualmente, a Databricks não cobra pelo uso desse recurso. No entanto, o custo e o preço dos recursos no Beta podem ser alterados.
Para obter informações completas sobre o uso relacionado ao faturamento, consulte Preços do Databricks. Databricks prevê cobrar pelo uso do sandbox para:
- Computação em execução: Cobrada por hora enquanto seu Databricks Sandbox estiver em execução.
- Armazenamento persistente: Você é cobrado pelos dados armazenados no seu diretório inicial até que seu Databricks Sandbox seja excluído. O armazenamento gera cobrança enquanto a instância Sandbox do Databricks existir. Para parar de pagar pelo armazenamento, você deve deletar o sandbox.
- Transferência de dados
Limitations
- As cotas são aplicadas. Por padrão, você pode ter no máximo 200 sandboxes ativas por usuário (800 no total em todos os estados), e um workspace pode ter no máximo 400 sandboxes ativas (2.000 no total). Para solicitar um aumento, entre em contato com a equipe da conta Azure Databricks. Confira Limites de recursos.
- Você não pode se conectar via SSH a uma área restrita que você criar com o SDK do Databricks. Para conectar via SSH, crie o sandbox com a CLI Databricks. Veja Use a CLI Databricks para criar um sandbox.
- Databricks Sandbox é uma primitiva de computação para execução de código, não um runtime geral do Spark. Para cargas de trabalho do Spark, use Conectar-se à computação sem servidor.
- Os endereços IP públicos do seu Databricks Sandbox podem mudar a qualquer momento. O tráfego de entrada padrão do sandbox está fechado para todo o tráfego, e você não pode mudar isso.
- Mudanças fora do seu diretório pessoal não persistem depois que você para um sandbox. Para começar cada sandbox com os mesmos pacotes e configurações, use uma imagem personalizada. Consulte Como criar uma área restrita a partir de uma imagem personalizada. Para reutilizar arquivos entre sessões de um sandbox, armazene-os no seu diretório home.