apps
grupo de comando
Esta informação se aplica a Databricks CLI versões 0.205 e acima. A CLI do Databricks está em pré-visualização pública.
Databricks CLI O uso está sujeito à LicençaDatabricks e à Política de PrivacidadeDatabricks, incluindo qualquer disposição sobre Dados de Uso.
O grupo de comandos apps
dentro do Databricks CLI permite gerenciar aplicativos. Os aplicativos são executados diretamente na instância do Databricks do cliente, integram-se ao uso de dados e ampliam o serviço Databricks, além de permitir que os usuários interajam por meio de um único login. Consulte Aplicativos Databricks.
aplicativos Databricks criam
Crie um novo aplicativo.
databricks apps create NAME [flags]
Argumentos
NAME
O nome do aplicativo. O nome deve conter somente caracteres alfanuméricos minúsculos e hífens. Deve ser único dentro do workspace.
Opções
--budget-policy-id string
ID da política de orçamento do aplicativo.
--description string
A descrição do aplicativo.
--json JSON
As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.
--no-compute
Se verdadeiro, o aplicativo não será iniciado após a criação.
--no-wait
Não espere para atingir o estado ATIVO.
--timeout duration
Tempo máximo para atingir o estado ATIVO (default 20m0s).
Exemplos
O exemplo a seguir cria um aplicativo básico:
databricks apps create my-analytics-app --description "Analytics dashboard app"
O exemplo a seguir cria um aplicativo sem iniciá-lo:
databricks apps create my-data-app --description "Data processing app" --no-compute
O exemplo a seguir cria um aplicativo com um tempo limite personalizado:
databricks apps create my-ml-app --description "Machine learning app" --timeout 30m
aplicativos Databricks excluem
Exclua um aplicativo.
databricks apps delete NAME [flags]
Argumentos
NAME
O nome do aplicativo.
Opções
Exemplos
O exemplo a seguir exclui um aplicativo:
databricks apps delete my-analytics-app
aplicativos databricks implantados
Crie uma implantação de aplicativo para o aplicativo com o nome fornecido.
databricks apps deploy APP_NAME [flags]
Argumentos
APP_NAME
O nome do aplicativo.
Opções
--deployment-id string
O ID exclusivo da implantação.
--json JSON
As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.
--mode AppDeploymentMode
O modo como a implantação irá gerenciar o código-fonte. Valores suportados: AUTO_SYNC
, SNAPSHOT
.
--no-wait
Não espere para alcançar o estado SUCCEEDED.
--source-code-path string
O caminho do sistema de arquivos workspace do código-fonte utilizado para criar a implantação do aplicativo.
--timeout duration
Tempo máximo para atingir o estado SUCCEEDED (default 20m0s).
Exemplos
O exemplo a seguir cria uma implantação com o modo de sincronização automática:
databricks apps deploy my-analytics-app --source-code-path /Workspace/Users/someone@example.com/my-app --mode AUTO_SYNC
O exemplo a seguir cria uma implantação com o modo Snapshot:
databricks apps deploy my-data-app --source-code-path /Workspace/Users/someone@example.com/data-app --mode SNAPSHOT
O exemplo a seguir cria uma implantação com um ID de implantação personalizado:
databricks apps deploy my-ml-app --deployment-id "v1.2.3" --source-code-path /Workspace/Users/someone@example.com/ml-app
os aplicativos databricks obtêm
Obtenha informações sobre o aplicativo com o nome fornecido.
databricks apps get NAME [flags]
Argumentos
NAME
O nome do aplicativo.
Opções
Exemplos
O exemplo a seguir obtém informações sobre o aplicativo:
databricks apps get my-analytics-app
O exemplo a seguir obtém informações do aplicativo no formato JSON:
databricks apps get my-data-app --output json
O exemplo a seguir obtém informações do aplicativo usando um perfil específico:
databricks apps get my-ml-app --profile production
aplicativos Databricks são implantados
Obtenha informações sobre a implantação do aplicativo com o nome e o ID de implantação fornecidos.
databricks apps get-deployment APP_NAME DEPLOYMENT_ID [flags]
Argumentos
APP_NAME
O nome do aplicativo.
DEPLOYMENT_ID
O ID exclusivo da implantação.
Opções
Exemplos
O exemplo a seguir obtém informações de implantação:
databricks apps get-deployment my-analytics-app v1.0.0
O exemplo a seguir obtém informações de implantação no formato JSON:
databricks apps get-deployment my-data-app v2.1.0 --output json
O exemplo a seguir obtém informações de implantação usando um perfil específico:
databricks apps get-deployment my-ml-app latest --profile production
lista de aplicativos databricks
Liste todos os aplicativos no " workspace".
databricks apps list [flags]
Argumentos
Nenhuma
Opções
--page-size int
Limite superior para itens devolvidos.
--page-token string
Tokens de paginação para avançar para a próxima página de aplicativos.
Exemplos
O exemplo a seguir lista todos os aplicativos:
databricks apps list
O exemplo a seguir lista aplicativos com um tamanho de página específico:
databricks apps list --page-size 10
O exemplo a seguir lista aplicativos com paginação:
databricks apps list --page-token "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
implantações de listas de aplicativos do databricks
Liste todas as implantações do aplicativo com o nome fornecido.
databricks apps list-deployments APP_NAME [flags]
Argumentos
APP_NAME
O nome do aplicativo.
Opções
--page-size int
Limite superior para itens devolvidos.
--page-token string
Tokens de paginação para avançar para a próxima página de aplicativos.
Exemplos
O exemplo a seguir lista todas as implantações de um aplicativo:
databricks apps list-deployments my-analytics-app
O exemplo a seguir lista as implantações com um tamanho de página específico:
databricks apps list-deployments my-data-app --page-size 10
aplicativos databricks execução local
Iniciar um aplicativo localmente.
databricks apps run-local [flags]
Argumentos
Nenhuma
Opções
--app-port int
Porta na qual o aplicativo deve ser executado (default 8000).
--debug
Ative o modo de depuração.
--debug-port string
Porta na qual o depurador deve ser executado.
--entry-point string
Especifique o ponto de entrada personalizado com a configuração (arquivo.yml) para o aplicativo. padrão para app.yml
.
--env strings
Defina a variável de ambiente.
--port int
Porta na qual o proxy do aplicativo deve ser executado (default 8001).
--prepare-environment
Prepara o ambiente para executar o aplicativo. Requer instalação de UV.
Exemplos
O exemplo a seguir demonstra a execução de um aplicativo localmente com as configurações d default:
databricks apps run-local
O exemplo a seguir demonstra como executar um aplicativo localmente em uma porta específica:
databricks apps run-local --app-port 9000 --port 9001
Aplicativos Databricks: Introdução
Inicie a última implementação ativa do aplicativo no workspace.
databricks apps start NAME [flags]
Argumentos
NAME
O nome do aplicativo.
Opções
--no-wait
Não espere para atingir o estado ATIVO.
--timeout duration
Tempo máximo para atingir o estado ATIVO (default 20m0s).
Exemplos
O exemplo a seguir demonstra como iniciar um aplicativo:
databricks apps start my-analytics-app
O exemplo a seguir demonstra como iniciar um aplicativo sem aguardar:
databricks apps start my-data-app --no-wait
O exemplo a seguir demonstra como iniciar um aplicativo com um tempo limite personalizado:
databricks apps start my-ml-app --timeout 30m
os aplicativos Databricks param
Interrompa a implantação ativa do aplicativo em workspace.
databricks apps stop NAME [flags]
Argumentos
NAME
O nome do aplicativo.
Opções
--no-wait
Não espere para atingir o estado PARADO.
--timeout duration
Tempo máximo para atingir o estado PARADO (default 20m0s).
Exemplos
O exemplo a seguir interrompe um aplicativo:
databricks apps stop my-analytics-app
O exemplo a seguir interrompe um aplicativo sem esperar:
databricks apps stop my-data-app --no-wait
O exemplo a seguir interrompe um aplicativo com um tempo limite personalizado:
databricks apps stop my-ml-app --timeout 30m
atualização de aplicativos databricks
Atualize o aplicativo com o nome fornecido.
databricks apps update NAME [flags]
Argumentos
NAME
O nome do aplicativo. O nome deve conter somente caracteres alfanuméricos minúsculos e hífens. Deve ser único dentro do workspace.
Opções
--budget-policy-id string
ID da política de orçamento do aplicativo.
--description string
A descrição do aplicativo.
--json JSON
As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.
Exemplos
O exemplo a seguir atualiza a descrição de um aplicativo:
databricks apps update my-analytics-app --description "Updated analytics dashboard"
aplicativos Databricks obtêm níveis de permissão
Obtenha os níveis de permissão do aplicativo.
databricks apps get-permission-levels APP_NAME [flags]
Argumentos
APP_NAME
O aplicativo para o qual obter ou gerenciar permissões.
Opções
Exemplos
O exemplo a seguir obtém níveis de permissão para um aplicativo:
databricks apps get-permission-levels my-analytics-app
aplicativos Databricks obtêm permissões
Obtenha as permissões de um aplicativo. Os aplicativos podem herdar permissões do objeto raiz.
databricks apps get-permissions APP_NAME [flags]
Argumentos
APP_NAME
O aplicativo para o qual obter ou gerenciar permissões.
Opções
Exemplos
O exemplo a seguir obtém permissões para um aplicativo:
databricks apps get-permissions my-analytics-app
O exemplo a seguir obtém permissões usando um perfil específico:
databricks apps get-permissions my-ml-app --profile production
permissões de conjunto de aplicativos do databricks
Defina as permissões do aplicativo.
Define as permissões em um objeto, substituindo as permissões existentes, se elas existirem. Exclui todas as permissões diretas se nenhuma for especificada. Os objetos podem herdar permissões do objeto raiz.
databricks apps set-permissions APP_NAME [flags]
Argumentos
APP_NAME
O aplicativo para o qual obter ou gerenciar permissões.
Opções
--json JSON
As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.
Exemplos
O exemplo a seguir define permissões usando a configuração JSON:
databricks apps set-permissions my-analytics-app --json '{"access_control_list": [{"user_name": "someone@example.com", "permission_level": "CAN_USE"}]}'
permissões de atualização de aplicativos databricks
Atualize as permissões em um aplicativo. Os aplicativos podem herdar permissões do objeto raiz.
databricks apps update-permissions APP_NAME [flags]
Argumentos
APP_NAME
O aplicativo para o qual obter ou gerenciar permissões.
Opções
--json JSON
As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.
Exemplos
O exemplo a seguir atualiza as permissões utilizando a configuração JSON:
databricks apps update-permissions my-analytics-app --json '{"access_control_list": [{"user_name": "someone@example.com", "permission_level": "CAN_MANAGE"}]}'
Bandeiras globais
--debug
Se deve habilitar o registro de depuração.
-h
ou --help
Exibir ajuda para o comando Databricks CLI ou para o grupo de comandos relacionado ou para o comando relacionado.
--log-file
string
Uma string que representa o arquivo no qual a saída logs deve ser gravada. Se este sinalizador não for especificado, o default deverá gravar a saída logs no stderr.
--log-format
Formato
O tipo de formato do log, text
ou json
. O valor de default é text
.
--log-level
string
Uma string que representa o nível de formato do log. Se não for especificado, o nível de formato do log será desativado.
-o, --output
Tipo
O tipo de saída do comando, text
ou json
. O valor de default é text
.
-p, --profile
string
O nome do perfil no arquivo ~/.databrickscfg
a ser utilizado para executar o comando. Se esse sinalizador não for especificado, se existir, o perfil chamado DEFAULT
será usado.
--progress-format
Formato
O formato para exibir o progresso logs: default
, append
, inplace
ou json
-t, --target
string
Se aplicável, o destino do pacote a ser usado