Comece a trabalhar com Databricks Apps

Prévia

O Databricks Apps está em visualização pública.

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.
Visualizar a saída do aplicativo em seu site workspace.

Antes de seguir o exemplo, certifique-se de que o site Databricks workspace e o ambiente de desenvolvimento local atendam aos requisitos.

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 Como faço para criar um aplicativo na interface do usuário de aplicativos da Databricks?

o passo 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.

pipenv --python 3.11
pipenv shell
pip install gradio
pip install pandas
mkdir <app-dir-name>
cd <app-dir-name>

Substitua <app-dir-name> pelo nome de um diretório local para os arquivos do seu aplicativo, por exemplo, gradio-hello-world.

o passo 2: Adicionar o código-fonte e a configuração de seu aplicativo

Em um editor de texto ou em seu ambiente de desenvolvimento integrado (IDE) favorito, crie um novo arquivo Python com o seguinte código e salve-o no diretório que o senhor criou. Este exemplo usa o nome de arquivo app.py para o arquivo 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()

Em um editor de texto ou IDE, crie um novo arquivo YAML com o conteúdo a seguir e salve-o em um arquivo chamado app.yaml no diretório que você criou:
```
command: [
  "python",
  "<app-name.py>"
]
```
Substitua <app-name.py> pelo nome do arquivo Python que contém o código do aplicativo. Por exemplo, app.py.

o passo 3: Teste seu aplicativo localmente

Para testar o aplicativo localmente, abra um terminal e execute python <app-name.py>, substituindo <app-name.py> pelo nome do arquivo que contém o código do aplicativo.
```
python app.py
Running on local URL:  http://127.0.0.1:7860
...
```
Para view a saída do aplicativo, abra http://127.0.0.1:7860 em uma janela do navegador.

o passo 4: implante o aplicativo em seu workspace

Para criar um novo aplicativo em seu workspace e implantar o código de seu ambiente local para o workspace, abra um terminal e complete os seguintes passos.

Crie o aplicativo em seu site Databricks workspace.
Observação
- O nome atribuído a um aplicativo Databricks não pode ser alterado após a criação do aplicativo, e qualquer usuário com acesso a um Databricks workspace pode ver os nomes e o histórico de implantação de todos os aplicativos Databricks no workspace. Além disso, o nome do aplicativo é incluído nos registros gravados nas tabelas do sistema. Devido a essa visibilidade, o senhor não deve incluir informações confidenciais ao nomear seus aplicativos Databricks.
- O nome deve ser exclusivo no site Databricks workspace que hospeda o aplicativo e deve conter apenas letras minúsculas, números e hífens.
```
databricks apps create <app-name>
```
Substitua <app-name> por um nome para seu aplicativo. Por exemplo, gradio-hello-world.
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.
Sincronize os arquivos de seu ambiente local com o Databricks workspace. O comando para sincronizar os arquivos do seu ambiente local com o workspace, incluindo o caminho workspace para os arquivos, está em Sync source files into Databricks. Clique em para copiar esse comando.
Em um terminal, vá para o diretório que contém os arquivos do aplicativo e execute o comando sync copiado.

Observação

Se houver arquivos ou diretórios específicos no diretório local do aplicativo que o senhor não deseja que sejam transferidos pelo comando databricks sync, adicione esses arquivos ou diretórios a um arquivo .gitignore no diretório local do aplicativo. Por exemplo, se o senhor tiver um diretório de ambiente virtual Python no mesmo diretório do seu aplicativo, adicione o nome do diretório ao arquivo .gitignore e o comando sync ignorará esse diretório ao transferir arquivos.
```
databricks sync --watch . /Workspace/Users/user@databricks.com/gradio-hello-world
...
Initial Sync Complete
```
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.
Para implantar o aplicativo, execute o seguinte comando em um terminal, substituindo <app-path> pelo caminho workspace dos arquivos do aplicativo.

databricks apps deploy gradio-hello-world --source-code-path <app-path>
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óximos passos

Para saber como criar aplicativos na interface do usuário do Databricks Apps, consulte Como criar um aplicativo na interface do usuário do Databricks Apps?