Comece a trabalhar com Databricks Apps

Prévia

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

Este artigo explica como configurar seu ambiente de desenvolvimento local para desenvolver aplicativos e demonstra como criar e implantar seu primeiro aplicativo com um exemplo passo a passo.

Requisitos

Para implantar e executar aplicativos em seu Databricks workspace, o senhor deve garantir que o firewall não bloqueie o domínio *.databricksapps.com.

Para criar aplicativos Databricks localmente e implantá-los em seu Databricks workspace, seu ambiente de desenvolvimento deve atender aos seguintes requisitos:

Python 3.11 ou acima.
O Databricks CLI, versão 0.229.0 ou acima, configurado para acessar seu Databricks workspace. Para instalar ou atualizar e configurar a CLI da Databricks, consulte Instalar ou atualizar a CLI da Databricks e Autenticação para a CLI da Databricks.
O SDK da Databricks para Python. O senhor pode instalar o SDK com pip3:

pip3 install databricks-sdk

Consulte Databricks SDK para Python.
(Opcional) Se o seu aplicativo precisar acessar o Databricks SQL, instale o Databricks SQL Connector for Python. Você pode instalar o conector com pip3:

pip3 install databricks-sql-connector
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. Consulte Ambiente virtual Python.

Escreva e implante seu primeiro aplicativo Databricks

Os passos a seguir orientam o senhor na criação de um aplicativo simples em seu ambiente de desenvolvimento local e na implantação do aplicativo em seu site 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.

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 usar informações confidenciais ao nomear seus aplicativos Databricks.
- Como o nome de um aplicativo Databricks é usado para construir o link para o aplicativo implantado, o nome deve usar apenas caracteres válidos em um URL.
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.

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 <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?