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. Escolha o Gradio Hello world padrão.

   

3. 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:

Databricks gera a URL do aplicativo automaticamente com base no nome do aplicativo e no ID workspace . Você não pode alterar o URL depois de criar o aplicativo. Se precisar de um URL diferente, crie um novo aplicativo com um nome diferente. Para mais informações, consulte URL do 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.

1. Copie o comando em Sincronizar os arquivos :

   

2. Em um terminal, navegue até o diretório local gradio-hello-world que você criou e execute o comando copiado:

   Bash

   databricks workspace export-dir /Workspace/Users/my-email@org.com/databricks_apps/gradio-hello-world_2026_02_03-22_34/gradio-hello-world-app .
   
   ...
   Export complete
   
   gradio-hello-world % databricks sync --watch . /Workspace/Users/my-email@org.com/databricks_apps/gradio-hello-world_2026_02_03-22_34/gradio-hello-world-app
   
   ...
   Initial Sync Complete

   O primeiro comando exporta três arquivos do seu workspace para o seu diretório local: app.py, app.yaml e requirements.txt. O segundo comando inicia um processo de sincronização que monitora as alterações nos arquivos locais e as carrega automaticamente para o seu workspace.

   • app.py Contém o código que implementa a funcionalidade e a interface do usuário do aplicativo.
   • app.yaml Define a configuração do aplicativo, incluindo seu ponto de entrada e permissões.
   • requirements.txt Lista os pacotes Python necessários para o 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 "Implantar" para Databricks Apps na página de visão geral do aplicativo:

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

O comando é bem-sucedido com:

JSON

{
  "create_time": "2026-02-03T23:25:38Z",
  "creator": "my-email@org.com",
  "deployment_artifacts": {
    "source_code_path": "/Workspace/Users/4cfd4a36-2cef-4155-88c4-d258ed6d0d91/src/01f10157a60a113e980014bebd5f4a03"
  },
  "deployment_id": "01f10157a60a113e980014bebd5f4a03",
  "mode": "SNAPSHOT",
  "source_code_path": "/Workspace/Users/my-email@org.com/databricks_apps/gradio-hello-world_2026_02_03-22_34/gradio-hello-world-app",
  "status": {
    "message": "App started successfully",
    "state": "SUCCEEDED"
  },
  "update_time": "2026-02-03T23:25:41Z"
}

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.