Pular para o conteúdo principal

Comece a trabalhar com Databricks Apps

Este artigo ajuda o senhor a começar a usar os aplicativos Databricks usando um exemplo passo a passo para criar um aplicativo simples em seu Databricks workspace usando um padrão que segue as práticas recomendadas do Databricks.

Este exemplo mostra como:

  • Criar um aplicativo a partir de um padrão
  • Visualizar o aplicativo depois de implantado
  • Copiar o aplicativo padrão para seu computador para desenvolvimento posterior
  • Executando o aplicativo localmente
  • Reimplante o aplicativo em seu workspace

Ao final deste artigo, o senhor poderá iterar seu aplicativo localmente e implantar atualizações em Databricks.

Pré-requisitos

Antes de concluir este tutorial, certifique-se de que o Databricks workspace e o ambiente de desenvolvimento local estejam configurados corretamente. Consulte Configurar o Databricks Apps workspace e o ambiente de desenvolvimento.

Etapa 1: instalar dependências

Abra um terminal e execute o seguinte comando para:

  • Instale a Python biblioteca exigida pelo aplicativo de exemplo.
  • Crie um diretório local para os arquivos de origem e configuração do seu aplicativo.
Bash
pip install gradio
pip install pandas
mkdir gradio-hello-world
cd gradio-hello-world

gradio-hello-world é o diretório local dos arquivos do seu aplicativo.

Etapa 2: criar o aplicativo

  1. Em seu Databricks workspace, clique em + New > App na barra lateral esquerda.

  2. Em Install from a padrão , acesse o Gradio tab.

  3. Escolha o padrão Hello world .

    Selecione o padrão Hello World

  4. Nomeie o aplicativo como gradio-hello-world e clique em Instalar.

Isso cria um novo aplicativo com base no padrão selecionado e o implanta em seu site workspace.

Etapa 3: visualizar o aplicativo

Depois de criar um aplicativo, ele começa automaticamente e exibe um URL que pode ser usado para visualizá-lo. Visualize o URL do aplicativo e o status da implantação na página Overview (Visão geral) :

visualizar a página de detalhes do aplicativo após a implantação do aplicativo

Clique no URL para acessar view o aplicativo:

exibir a saída do aplicativo hello world localmente

Etapa 4: Copie o aplicativo para seu computador

Depois de criar o aplicativo, o senhor pode fazer o download do código-fonte em seu computador local para personalizá-lo.

  1. Copie o primeiro comando em Sincronizar os arquivos :

    visualizar a página de detalhes do aplicativo após a criação do aplicativo

  2. Em um terminal, navegue até o diretório local gradio-hello-world que o senhor criou e, em seguida, execute o comando sync copiado.

    Bash
    databricks workspace export-dir /Workspace/Users/my-email@org.com/databricks_apps/gradio-hello-world_2025_06_09-18_38/gradio-hello-world-app .

    ...
    Export complete

    O comando copia dois novos arquivos para o diretório com os nomes app.py e app.yaml. app.yaml define a configuração do aplicativo, incluindo seu ponto de entrada e permissões. app.py contém o código que implementa a funcionalidade e a interface do usuário do aplicativo.

Etapa 5: modificar e testar o aplicativo localmente

  1. Opcionalmente, personalize e desenvolva seu aplicativo localmente. Por exemplo, o senhor pode modificar o site app.py para tornar os dados interativos, adicionar um tema ou opções de estilo ou permitir o upload de dados.

  2. Para testar seu aplicativo, execute python app.py:

    Bash
    python app.py

    Running on local URL: http://127.0.0.1:7860
    ...
  3. Para view o aplicativo, navegue até http://127.0.0.1:7860 em uma janela do navegador.

  4. Opcionalmente, use o comando databricks apps execução-local para executar e depurar o aplicativo:

    Bash
    databricks apps run-local --prepare-environment --debug

    Esse comando instala todas as dependências e prepara o ambiente virtual e, em seguida, inicia o aplicativo e o depurador na porta 5678. Navegue até http://localhost:8001 para view o aplicativo.

    Para definir pontos de interrupção no Visual Studio Code, instale a extensão do depurador Python e, em seguida, vá para execução > começar depuração > Remote Attach .

Etapa 6: Reimplante o aplicativo em seu workspace

Para reimplantar o aplicativo, copie o comando em implantado para Databricks Apps na página de detalhes do aplicativo:

Copie o comando para implantar um aplicativo

Execute o comando a partir do diretório local gradio-hello-world.

O comando é bem-sucedido com:

JSON
{
"create_time": "2025-06-09T19:36:50Z",
"creator": "my-email@org.com",
"deployment_artifacts": {
"source_code_path": "/Workspace/Users/1234abcd-5678-90ab-cdef-123456abcdef/src/abcd1234efgh5678ijkl9012mnop3456"
},
"deployment_id": "abcd1234efgh5678ijkl9012mnop3456",
"mode": "SNAPSHOT",
"source_code_path": "/Workspace/Users/my-email@org.com/databricks_apps/gradio-hello-world_2025_06_09-18_38/gradio-hello-world-app",
"status": {
"message": "App started successfully",
"state": "SUCCEEDED"
},
"update_time": "2025-06-09T19:36:51Z"
}

Para view o status da implantação, acesse a página Overview (Visão geral) do aplicativo.

Próximas etapas

Agora que implantou e personalizou seu primeiro aplicativo, o senhor pode:

  • Configure a autorização para gerenciar quem pode acessar e editar seu aplicativo.
  • Integre seu aplicativo ao recurso da plataforma Databricks, como Databricks secrets ou Databricks SQL.
  • Compartilhe seu aplicativo com outros usuários em seu workspace ou em toda a organização.
  • Explore mais padrões de aplicativos para experimentar diferentes estruturas e recursos.