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.
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
-
Em seu Databricks workspace, clique em + New > App na barra lateral esquerda.
-
Em Install from a padrão , acesse o Gradio tab.
-
Escolha o padrão Hello world .
-
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) :
Clique no URL para acessar view o aplicativo:
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.
-
Copie o primeiro comando em Sincronizar os arquivos :
-
Em um terminal, navegue até o diretório local
gradio-hello-world
que o senhor criou e, em seguida, execute o comandosync
copiado.Bashdatabricks workspace export-dir /Workspace/Users/my-email@org.com/databricks_apps/gradio-hello-world_2025_06_09-18_38/gradio-hello-world-app .
...
Export completeO comando copia dois novos arquivos para o diretório com os nomes
app.py
eapp.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
-
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. -
Para testar seu aplicativo, execute
python app.py
:Bashpython app.py
Running on local URL: http://127.0.0.1:7860
... -
Para view o aplicativo, navegue até
http://127.0.0.1:7860
em uma janela do navegador. -
Opcionalmente, use o comando databricks apps execução-local para executar e depurar o aplicativo:
Bashdatabricks 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:
Execute o comando a partir do diretório local gradio-hello-world
.
O comando é bem-sucedido com:
{
"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.