Comece a trabalhar com Databricks Apps

Este artigo ajuda o senhor a começar a usar o Databricks Apps usando um exemplo passo a passo para criar um aplicativo simples em seu ambiente de desenvolvimento local e implantá-lo em seu Databricks workspace. Este exemplo mostra como:

• Criando e testando o aplicativo localmente.
• Depois de testar localmente, use o Databricks CLI para adicionar o aplicativo ao seu Databricks workspace.
• Exibir a página de detalhes do aplicativo em seu workspace.
• Copiar o código-fonte e os artefatos do aplicativo para o site workspace.
• Exibir a saída do aplicativo em seu site workspace.

A Databricks recomenda o uso de um ambiente virtual Python ao desenvolver aplicativos. O exemplo deste artigo usa o pipenv para criar um ambiente virtual. Para saber mais, consulte Ambientes virtuais Python: A Primer.

Esse exemplo também está disponível no site Databricks Apps padrão biblioteca. Consulte Desenvolver aplicativos 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: configurar seu ambiente local

Abra um terminal e execute o seguinte comando para:

• Crie e inicie um ambiente virtual Python.
• 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

pipenv --python 3.11
pipenv shell
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: adicione a fonte e a configuração do seu aplicativo

1. Em um editor de texto ou em seu ambiente de desenvolvimento integrado (IDE) favorito, crie um novo arquivo Python chamado app.py com o seguinte código e salve-o no diretório que o senhor criou:

   Python

   import gradio as gr
   import pandas as pd
   
   data = pd.DataFrame({'x': [x for x in range(30)],
                        'y': [2 ** x for x in range(30)]})
   
   # Display the data with Gradio
   with gr.Blocks(css='footer {visibility: hidden}') as gradio_app:
       with gr.Row():
           with gr.Column(scale=3):
               gr.Markdown('# Hello world!')
               gr.ScatterPlot(value=data, height=400, width=700,
                              container=False, x='x', y='y',
                              y_title='Fun with data', x_title='Apps')
   
   if __name__ == '__main__':
       gradio_app.launch()

2. Em um editor de texto ou IDE, crie um arquivo YAML chamado app.yaml com o seguinte conteúdo no diretório que você criou:

   YAML

   command: ['python', 'app.py']

Etapa 3: teste seu aplicativo localmente

1. Para testar seu aplicativo localmente, abra um terminal e execute python app.py:

   Bash

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

2. Para view o aplicativo:

   • Navegue até http://127.0.0.1:7860 em uma janela do navegador.

     

   • Como alternativa, use o comando databricks apps exec-local para executar e depurar o aplicativo:

     Bash

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

     Isso 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 poder definir pontos de interrupção, no Visual Studio Code, o senhor pode instalar o depurador Python, depois executar > começar depuração e Remote Attach .

Etapa 4: implante o aplicativo em seu workspace

Para criar um novo aplicativo no site workspace e implantar o código do seu ambiente local no site workspace, abra um terminal e execute as etapas a seguir.

1. Execute o seguinte comando para criar o aplicativo em seu site Databricks workspace.

   Bash

   databricks apps create gradio-hello-world

nota

• Você não pode alterar o nome de um aplicativo depois de criá-lo.

• Todos os usuários com acesso ao site Databricks workspace podem view nomes de aplicativos e histórico de implementação.

• Evite incluir informações confidenciais nos nomes dos aplicativos.

• Cada nome de aplicativo deve ser exclusivo no site workspace e só pode conter letras minúsculas, números e hífens.

2. Para view o aplicativo em seu workspace quando o create comando for concluído, na barra lateral, clique em compute , vá para Apps tab e clique no link para seu aplicativo na coluna Name .

   

3. Copie o comando em Sync source files (Sincronizar arquivos de origem) para o Databricks .

4. Em um terminal, navegue até o diretório que contém os arquivos do aplicativo e execute o comando sync copiado.

   Bash

   databricks sync --watch . /Workspace/Users/my-email@org.com/gradio-hello-world
   ...
   Initial Sync Complete

nota

Para excluir arquivos ou diretórios específicos de serem transferidos pelo comando databricks sync, adicione-os a um arquivo .gitignore no diretório local do aplicativo. Por exemplo, para ignorar um ambiente virtual Python localizado no diretório app, adicione seu nome a .gitignore e sync o ignorará durante a transferência.

5. Para view os arquivos sincronizados em seu workspace quando o comando sync for concluído, clique em workspace na barra lateral e vá para o diretório criado para seu aplicativo.

6. Para implantar o aplicativo, execute o seguinte comando em um terminal. Substitua o caminho do código-fonte pelo caminho workspace dos arquivos do aplicativo.

   databricks apps deploy gradio-hello-world \
      --source-code-path /Workspace/Users/my-email@org.com/gradio-hello-world

7. Para view o status da implantação, acesse a página de detalhes do aplicativo.

   

   Para view a saída do aplicativo implantado, clique no link do aplicativo sob o nome do aplicativo na página de detalhes.

Próximas etapas

Para saber como criar aplicativos na UI do Databricks Apps, consulte Desenvolver aplicativos Databricks.