environments grupo de comandos
Esta informação aplica-se às versões 0.205 e acima Databricks CLI . A CLI do Databricks está em versão prévia pública.
O uso CLI Databricks está sujeito à LicençaDatabricks e ao Aviso de PrivacidadeDatabricks, incluindo qualquer fornecimento de Dados de Uso.
O grupo de comandos environments dentro da CLIDatabricks permite gerenciar recursos de ambiente. A API de Ambientes fornece recursos de gerenciamento para diferentes tipos de ambientes, incluindo ambientes base em nível workspaceque definem a versão do ambiente e as dependências a serem usadas em Notebooks e Jobs serverless .
ambientes databricks criar-workspace-ambiente-base
Criar um novo ambiente base workspace . Trata-se de uma operação de longa duração que gera, de forma assíncrona, um ambiente materializado para otimizar a resolução de dependências.
databricks environments create-workspace-base-environment DISPLAY_NAME [flags]
Argumentos
DISPLAY_NAME
Nome legível para humanos do ambiente base workspace .
Opções
--base-environment-type BaseEnvironmentType
O tipo de ambiente base (CPU ou GPU). Valores suportados: CPU, GPU
--filepath string
O caminho dos arquivos workspace ou dos volumes Unity Catalog para o arquivo YAML do ambiente.
--json JSON
As strings JSON embutidas ou o @caminho para o arquivo JSON com o corpo da requisição.
--name string
O nome do recurso do ambiente base workspace .
--no-wait
Não espere atingir o estado DONE .
--request-id string
Um identificador único para esta solicitação.
--timeout duration
Tempo máximo necessário para atingir o estado DONE .
--workspace-base-environment-id string
O ID a ser usado para o ambiente base workspace , que se tornará o componente final do nome do recurso.
Exemplos
O exemplo a seguir cria um ambiente base workspace de CPU:
databricks environments create-workspace-base-environment "My Python Env" --base-environment-type CPU --filepath /Workspace/environments/env.yaml
ambientes databricks excluir-workspace-ambiente-base
Excluir um ambiente base workspace . A exclusão de um ambiente base pode afetar o Notebook e o Job vinculados. Esta operação é irreversível.
databricks environments delete-workspace-base-environment NAME [flags]
Argumentos
NAME
Obrigatório. Nome do recurso do ambiente base workspace a ser excluído. Formato: workspace-base-environments/{workspace_base_environment}.
Opções
Exemplos
O exemplo a seguir exclui um ambiente base workspace :
databricks environments delete-workspace-base-environment workspace-base-environments/my-env-id
ambientes databricks obter-default-workspace-base-environment
Obtenha a configuração default do ambiente base workspace . Retorna as configurações default atuais do ambiente base para compute em CPU e GPU.
databricks environments get-default-workspace-base-environment NAME [flags]
Argumentos
NAME
Um nome de recurso estático para o ambiente base workspace default . Formato: default-workspace-base-environment.
Opções
Exemplos
O exemplo a seguir obtém o ambiente base workspace default :
databricks environments get-default-workspace-base-environment default-workspace-base-environment
ambientes databricks get-operações
Obtenha o status de uma operação de longa duração. Os clientes podem usar esse método para consultar o resultado das operações.
databricks environments get-operation NAME [flags]
Argumentos
NAME
O nome do recurso de operações.
Opções
Exemplos
O exemplo a seguir obtém o status de uma operação de longa duração:
databricks environments get-operation operations/1234567890
ambientes do Databricks obter-workspace-ambiente-base
Obtenha um ambiente base workspace pelo nome.
databricks environments get-workspace-base-environment NAME [flags]
Argumentos
NAME
Obrigatório. O nome do recurso do ambiente base workspace a ser recuperado. Formato: workspace-base-environments/{workspace_base_environment}.
Opções
Exemplos
O exemplo a seguir obtém um ambiente base workspace :
databricks environments get-workspace-base-environment workspace-base-environments/my-env-id
Lista de ambientes do Databricks -workspace- ambientes base
Liste todos os ambientes base do workspace workspace.
databricks environments list-workspace-base-environments [flags]
Argumentos
Nenhuma
Opções
--page-size int
O número máximo de ambientes a serem retornados por página.
--page-token string
Tokens de página para paginação.
Exemplos
O exemplo a seguir lista todos os ambientes base workspace :
databricks environments list-workspace-base-environments
refreshde ambientes do Databricks -workspace- ambiente base
Atualizar o ambiente materializado para um ambiente base workspace . Trata-se de uma operação de longa duração que regenera o ambiente materializado de forma assíncrona. O ambiente materializado existente permanece disponível até expirar.
databricks environments refresh-workspace-base-environment NAME [flags]
Argumentos
NAME
Obrigatório. O nome do recurso do ambiente base workspace a ser refresh. Formato: workspace-base-environments/{workspace_base_environment}.
Opções
--no-wait
Não espere atingir o estado DONE .
--timeout duration
Tempo máximo necessário para atingir o estado DONE .
Exemplos
O exemplo a seguir atualiza um ambiente base workspace :
databricks environments refresh-workspace-base-environment workspace-base-environments/my-env-id
atualização-default-workspace-base-environment databricks environments
Atualize a configuração default do ambiente base workspace . Define os ambientes base especificados como o workspace padrão para compute de CPU e/ou GPU.
databricks environments update-default-workspace-base-environment NAME UPDATE_MASK [flags]
Argumentos
NAME
O nome do recurso deste recurso único. Formato: default-workspace-base-environment.
UPDATE_MASK
Máscara de campo que especifica quais campos devem ser atualizados. Caminhos de campo válidos: cpu_workspace_base_environment, gpu_workspace_base_environment. Use * para atualizar todos os campos.
Opções
--cpu-workspace-base-environment string
O ambiente base workspace default para compute de CPU.
--gpu-workspace-base-environment string
O ambiente base default workspace para compute GPU.
--json JSON
As strings JSON embutidas ou o @caminho para o arquivo JSON com o corpo da requisição.
--name string
O nome do recurso deste recurso único.
Exemplos
O exemplo a seguir define o ambiente base default workspace da CPU:
databricks environments update-default-workspace-base-environment default-workspace-base-environment cpu_workspace_base_environment --cpu-workspace-base-environment workspace-base-environments/my-cpu-env
atualização de ambientes do Databricks -workspace- ambiente base
Atualizar um ambiente base workspace existente. Trata-se de uma operação de longa duração que regenera o ambiente materializado de forma assíncrona. O ambiente materializado existente permanece disponível até expirar.
databricks environments update-workspace-base-environment NAME DISPLAY_NAME [flags]
Argumentos
NAME
O nome do recurso do ambiente base workspace . Formato: workspace-base-environments/{workspace_base_environment}.
DISPLAY_NAME
Nome legível para humanos do ambiente base workspace .
Opções
--base-environment-type BaseEnvironmentType
O tipo de ambiente base (CPU ou GPU). Valores suportados: CPU, GPU
--filepath string
O caminho dos arquivos workspace ou dos volumes Unity Catalog para o arquivo YAML do ambiente.
--json JSON
As strings JSON embutidas ou o @caminho para o arquivo JSON com o corpo da requisição.
--name string
O nome do recurso do ambiente base workspace .
--no-wait
Não espere atingir o estado DONE .
--timeout duration
Tempo máximo necessário para atingir o estado DONE .
Exemplos
O exemplo a seguir atualiza um ambiente base workspace :
databricks environments update-workspace-base-environment workspace-base-environments/my-env-id "Updated Python Env" --filepath /Workspace/environments/updated-env.yaml
Bandeiras globais
--debug
Ativar ou não o registro de depuração.
-h ou --help
Exibir ajuda para a CLI Databricks , o grupo de comandos relacionado ou o comando específico.
--log-file string
Uma sequência de caracteres representando o arquivo no qual logs de saída serão gravados. Se essa opção não for especificada, o default é gravar logs de saída em stderr.
--log-format Formato
O tipo de formato de log, text ou json. O valor default é text.
--log-level string
Uma sequência de caracteres representando o nível de formato log . Caso não seja especificado, o nível de formato log será desativado.
-o, --output Tipo
O tipo de saída do comando, text ou json. O valor default é 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 existir, o perfil denominado DEFAULT será usado.
--progress-format Formato
O formato para exibir logs de progresso é: default, append, inplace ou json
-t, --target string
Se aplicável, o pacote de destino a ser usado.