Pular para o conteúdo principal

apps grupo de comando

nota

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).

Bandeiras globais

Exemplos

O exemplo a seguir cria um aplicativo básico:

Bash
databricks apps create my-analytics-app --description "Analytics dashboard app"

O exemplo a seguir cria um aplicativo sem iniciá-lo:

Bash
databricks apps create my-data-app --description "Data processing app" --no-compute

O exemplo a seguir cria um aplicativo com um tempo limite personalizado:

Bash
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

Bandeiras globais

Exemplos

O exemplo a seguir exclui um aplicativo:

Bash
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).

Bandeiras globais

Exemplos

O exemplo a seguir cria uma implantação com o modo de sincronização automática:

Bash
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:

Bash
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:

Bash
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

Bandeiras globais

Exemplos

O exemplo a seguir obtém informações sobre o aplicativo:

Bash
databricks apps get my-analytics-app

O exemplo a seguir obtém informações do aplicativo no formato JSON:

Bash
databricks apps get my-data-app --output json

O exemplo a seguir obtém informações do aplicativo usando um perfil específico:

Bash
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

Bandeiras globais

Exemplos

O exemplo a seguir obtém informações de implantação:

Bash
databricks apps get-deployment my-analytics-app v1.0.0

O exemplo a seguir obtém informações de implantação no formato JSON:

Bash
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:

Bash
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.

Bandeiras globais

Exemplos

O exemplo a seguir lista todos os aplicativos:

Bash
databricks apps list

O exemplo a seguir lista aplicativos com um tamanho de página específico:

Bash
databricks apps list --page-size 10

O exemplo a seguir lista aplicativos com paginação:

Bash
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.

Bandeiras globais

Exemplos

O exemplo a seguir lista todas as implantações de um aplicativo:

Bash
databricks apps list-deployments my-analytics-app

O exemplo a seguir lista as implantações com um tamanho de página específico:

Bash
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.

Bandeiras globais

Exemplos

O exemplo a seguir demonstra a execução de um aplicativo localmente com as configurações d default:

Bash
databricks apps run-local

O exemplo a seguir demonstra como executar um aplicativo localmente em uma porta específica:

Bash
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).

Bandeiras globais

Exemplos

O exemplo a seguir demonstra como iniciar um aplicativo:

Bash
databricks apps start my-analytics-app

O exemplo a seguir demonstra como iniciar um aplicativo sem aguardar:

Bash
databricks apps start my-data-app --no-wait

O exemplo a seguir demonstra como iniciar um aplicativo com um tempo limite personalizado:

Bash
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).

Bandeiras globais

Exemplos

O exemplo a seguir interrompe um aplicativo:

Bash
databricks apps stop my-analytics-app

O exemplo a seguir interrompe um aplicativo sem esperar:

Bash
databricks apps stop my-data-app --no-wait

O exemplo a seguir interrompe um aplicativo com um tempo limite personalizado:

Bash
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.

Bandeiras globais

Exemplos

O exemplo a seguir atualiza a descrição de um aplicativo:

Bash
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

Bandeiras globais

Exemplos

O exemplo a seguir obtém níveis de permissão para um aplicativo:

Bash
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

Bandeiras globais

Exemplos

O exemplo a seguir obtém permissões para um aplicativo:

Bash
databricks apps get-permissions my-analytics-app

O exemplo a seguir obtém permissões usando um perfil específico:

Bash
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.

Bandeiras globais

Exemplos

O exemplo a seguir define permissões usando a configuração JSON:

Bash
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.

Bandeiras globais

Exemplos

O exemplo a seguir atualiza as permissões utilizando a configuração JSON:

Bash
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