Introdução aos aplicativos Databricks

Este artigo ajuda você a começar a usar os aplicativos Databricks usando um exemplo passo a passo para criar um aplicativo simples em seu espaço de trabalho do Azure Databricks usando um modelo que segue as práticas recomendadas do Azure Databricks.

Este exemplo orienta você:

• Criando um aplicativo a partir de um modelo
• Visualizando o aplicativo após sua implantação
• Copiar o modelo de aplicação para o seu computador para desenvolvimento adicional
• Executando o aplicativo localmente
• Reimplantando o aplicativo em seu espaço de trabalho

No final deste artigo, poderá fazer iterações no seu aplicativo localmente e desdobrar atualizações para o Databricks.

Pré-requisitos

Antes de concluir este tutorial, verifique se o espaço de trabalho do Azure Databricks e o ambiente de desenvolvimento local estão configurados corretamente. Consulte Configurar seu espaço de trabalho e ambiente de desenvolvimento do Databricks Apps.

Etapa 1: Instalar dependências

Abra um terminal e execute os seguintes comandos para:

• Instale as bibliotecas Python exigidas 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 aplicativo.

Etapa 2: Criar o aplicativo

1. No espaço de trabalho Databricks, clique em + Novo>aplicativo na barra lateral esquerda.

2. Em Instalar a partir de um modelo, vá para a aba Gradio.

3. Escolha o modelo Hello world .

   

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

Isso cria um novo aplicativo com base no modelo selecionado e o implanta em seu espaço de trabalho.

Passo 3: Ver a aplicação

Depois de criar um aplicativo, ele é iniciado automaticamente e exibe um URL que você pode usar para visualizá-lo. Exiba a URL do aplicativo e o status da implantação na página Visão geral :

Clique no URL para ver a aplicação:

Passo 4: Copie a aplicação para o seu computador

Depois de criar o aplicativo, você pode baixar o código-fonte para sua máquina local para personalizá-lo.

1. Copie o primeiro comando em Sincronizar os ficheiros:

   

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

   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 chamado 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, você pode modificar app.py para tornar os dados interativos, adicionar um tema ou opções de estilo ou permitir carregamentos de dados.

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

   python app.py
   
   Running on local URL:  http://127.0.0.1:7860
   ...
   

3. Para visualizar o aplicativo, navegue até http://127.0.0.1:7860 em uma janela do navegador.

4. Opcionalmente, utilize o comando databricks apps run-local para executar e depurar a aplicação.

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

   Este 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 ver a aplicação.

   Para definir pontos de interrupção no Visual Studio Code, instale a extensão do depurador Python e vá para Executar>Iniciar Depuração>Anexação Remota.

Etapa 6: reimplantar o aplicativo em seu espaço de trabalho

Para reimplantar o aplicativo, copie o comando em Implantar em Aplicativos Databricks na página de detalhes do aplicativo:

Execute o comando no diretório local gradio-hello-world.

O comando executa-se com sucesso 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 exibir o status da implantação, vá para a página Visão geral do aplicativo.

Próximos passos

Agora que você implantou e personalizou seu primeiro aplicativo, você pode:

• Configure a autorização para gerenciar quem pode acessar e editar seu aplicativo.
• Integre seu aplicativo com os recursos da plataforma Azure Databricks, como segredos do Azure Databricks ou Databricks SQL.
• Partilhe a sua aplicação com outros utilizadores na sua área de trabalho ou na sua organização.
• Explore mais modelos de aplicativos para experimentar diferentes estruturas e recursos.