grupo de comandosandbox
O uso da CLI do Databricks está sujeito à Licença do Databricks e ao Aviso de Privacidade do Databricks, incluindo quaisquer disposições de Dados de Uso.
O grupo de comandos sandbox da CLI do Databricks permite criar, configurar e acessar ambientes de sandbox do Databricks.
Ambientes sandbox do Databricks são ambientes de desenvolvimento acessíveis via SSH, apoiados por isolamento de microVM. Cada sandbox é um ambiente pessoal com ferramentas pré-instaladas (Python, Node.js, Rust, e CLI do Databricks) e armazenamento persistente.
Para começar:
databricks auth login --host https://...
databricks sandbox register
databricks sandbox create
databricks sandbox ssh
configuração do sandbox do Databricks
Configurar o nome da sandbox e a política de parada automática.
As configurações de --name, --idle-timeout e --no-autostop são independentes, e você pode passar qualquer combinação.
databricks sandbox config <sandbox-id> [flags]
Argumentos
<sandbox-id>
O ID do sandbox para configurar.
Opções
--name string
Rótulo para o sandbox (máx. 256 bytes). Passar --name= para limpar.
--idle-timeout string
Duração do tempo limite parado. Defina este valor como 0 (ou 0s) para limpá-lo e usar o default do gerenciador (10m). Intervalo válido: de 1m a 24h.
--no-autostop
Quando verdadeiro, este sandbox nunca para automaticamente por parado. Passe --no-autostop=false para reverter.
Exemplos
databricks sandbox config my-sandbox-1234 --name my-project
databricks sandbox config my-sandbox-1234 --idle-timeout 15m
databricks sandbox config my-sandbox-1234 --idle-timeout 1h30m
databricks sandbox config my-sandbox-1234 --idle-timeout 0
databricks sandbox config my-sandbox-1234 --no-autostop
databricks sandbox config my-sandbox-1234 --no-autostop=false
databricks sandbox config my-sandbox-1234 --idle-timeout 30m --no-autostop=false
databricks sandbox criar
Criar um novo ambiente de sandbox.
Cria um ambiente de desenvolvimento pessoal compatível com uma microVM, bloqueia até que o sandbox esteja em execução e imprime a ID do sandbox.
databricks sandbox create [flags]
Opções
--json
Retorne os resultados no formato JSON.
--name string
Rótulo para o sandbox (máx. 256 bytes).
Exemplos
databricks sandbox create
databricks sandbox create --name my-project
databricks sandbox create --json
sandbox default do Databricks
Definir o sandbox default usado por databricks sandbox ssh.
O default é armazenado localmente em ~/.databricks/sandbox.json por perfil. O ID de sandbox é validado em relação ao servidor antes de ser gravado.
databricks sandbox default <sandbox-id> [flags]
Aliases: set-default
Argumentos
<sandbox-id>
O ID do sandbox para definir como default.
Opções
Exemplo
databricks sandbox default my-sandbox-1234
databricks sandbox excluir
Excluir um ambiente de sandbox.
Esta ação encerra e remove permanentemente a sandbox especificada. O comando solicita uma confirmação de forma interativa; use --auto-approve para ignorar o prompt.
databricks sandbox delete <sandbox-id> [flags]
Argumentos
<sandbox-id>
O ID de sandbox a ser excluído.
Opções
--auto-approve
Ignorar o pedido de confirmação interativo.
Exemplos
databricks sandbox delete my-sandbox-1234
databricks sandbox delete my-sandbox-1234 --auto-approve
Lista de sandboxes do Databricks
Liste os ambientes sandbox.
Mostra todos os sandboxes associados à sua account, incluindo o status atual e o ID.
databricks sandbox list [flags]
Opções
--json
Retorne os resultados no formato JSON.
Exemplos
databricks sandbox list
databricks sandbox list --json
Registro do sandbox Databricks
Gere uma chave SSH dedicada para o sandbox e registre-a no serviço.
Este comando:
- Gera uma chave SSH Ed25519 em
~/.ssh/sandbox_ed25519(se não existir). - Registrar a public key no serviço sandbox, rotulado com
--name. - Opcionalmente atualize
~/.ssh/configcom uma entradaHost sandbox-gw.
Após o registro, databricks sandbox ssh usa esta chave automaticamente.
databricks sandbox register [flags]
Opções
--name string
Rótulo para a key registrada (o padrão é o hostname desta máquina). Passe --name= para registrar sem um rótulo.
Exemplos
databricks sandbox register
databricks sandbox register --name my-laptop
SSH do sandbox do Databricks
Acesse via SSH o ambiente sandbox default ou um ambiente específico. Argumentos adicionais após -- são passados diretamente para ssh.
databricks sandbox ssh [sandbox-id] [-- <ssh-args-or-command>...] [flags]
Argumentos
[sandbox-id]
ID de sandbox opcional Se omitido, usa-se o sandbox default.
Opções
--gateway string
Nome de host do gateway do sandbox (detectado automaticamente do perfil se vazio).
--port string
Porta SSH do gateway do Sandbox. default: 2222.
Exemplos
databricks sandbox ssh
databricks sandbox ssh my-sandbox-1234
databricks sandbox ssh -- ls -la /home
databricks sandbox ssh my-sandbox-1234 -- cat /etc/os-release
databricks sandbox ssh -- -L 8080:localhost:8080
databricks sandbox chave SSH
Gerenciar chaves SSH registradas com o serviço de sandbox.
databricks sandbox ssh-key [command]
Comandos disponíveis
databricks sandbox ssh-key list- Listar chaves SSH registradas com o serviço de sandbox.databricks sandbox ssh-key delete- Excluir uma key SSH registrada no serviço de sandbox.
Opções
databricks sandbox lista de chaves SSH
Listar chaves SSH registradas no serviço do sandbox.
Cada linha exibe o hash da key atribuído pelo servidor (usado para excluir a key), o nome fornecido pelo usuário e os carimbos de data/hora de criação e de último uso. A chave registrada localmente (de databricks sandbox register) é marcada quando seu hash corresponde a uma das entradas listadas.
databricks sandbox ssh-key list [flags]
Opções
--json
Retorne os resultados no formato JSON.
Exemplos
databricks sandbox ssh-key list
databricks sandbox ssh-key list --json
excluir key SSH do sandbox Databricks
Excluir uma key SSH registrada com o serviço de sandbox.
O hash da chave é o identificador retornado por databricks sandbox ssh-key list. Após a exclusão, as tentativas de SSH que utilizam a chave privada correspondente não terão sucesso até que a chave seja registrada novamente.
databricks sandbox ssh-key delete <key-hash> [flags]
Argumentos
<key-hash>
A chave hash a ser excluída.
Opções
Exemplo
databricks sandbox ssh-key delete a1b2c3d4e5f6...
databricks sandbox começar
Ative um ambiente de sandbox parado.
Inicializa o micro-VM subjacente e aguarda até que o sandbox atinja o estado de Execução (ou por até 10 minutos). Executar este comando em uma sandbox já em execução não tem efeito.
databricks sandbox start <sandbox-id> [flags]
Argumentos
<sandbox-id>
O ID do sandbox para ativar.
Opções
Exemplo
databricks sandbox start my-sandbox-1234
status do sandbox do Databricks
Exibir o status detalhado de um ambiente de sandbox.
databricks sandbox status <sandbox-id> [flags]
Argumentos
<sandbox-id>
O ID do sandbox a ser inspecionado.
Opções
--json
Retorne os resultados no formato JSON.
Exemplos
databricks sandbox status my-sandbox-1234
databricks sandbox status my-sandbox-1234 --json
Parar databricks sandbox
Parar um ambiente de sandbox em execução.
Encerra o microVM de suporte, mas preserva o registro do sandbox e seu armazenamento persistente. Parar um sandbox já parado não tem efeito.
databricks sandbox stop <sandbox-id> [flags]
Argumentos
<sandbox-id>
O ID de sandbox a ser interrompido.
Opções
Exemplo
databricks sandbox stop my-sandbox-1234
Sinalizadores globais
--debug
Ativar o registro de depuração.
-h ou --help
Exiba ajuda para a CLI do Databricks ou o grupo de comandos relacionado ou o comando relacionado.
--log-file string
Uma string que representa o arquivo no qual os logs de saída devem ser gravados. Se este sinalizador não for especificado, o default é gravar logs de saída em stderr.
--log-format Formato
O tipo de formato de log, text ou json. O valor padrão é text.
--log-level string
Uma cadeia de caracteres que representa o nível do formato de log. Caso não seja especificado, o nível do formato de log é desativado.
-o, --output Tipo
O tipo de saída do comando, text ou json. O valor padrão é text.
-p, --profile string
O nome do perfil no arquivo ~/.databrickscfg a ser usado para executar o comando. Se este sinalizador não for especificado, então, se ele existir, o perfil nomeado DEFAULT será usado.
--progress-format Formato
O formato para exibir logs de progresso: default, append, inplace ou json
-t, --target string
Quando aplicável, o destino do pacote a ser usado