Pular para o conteúdo principal

Comece a trabalhar com Databricks Apps

info

Visualização

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.
  • Exibir 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?

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

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

    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 novo arquivo YAML com o conteúdo a seguir e salve-o em um arquivo chamado app.yaml no diretório que você criou:

    YAML
    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.

Etapa 3: teste seu aplicativo localmente

  1. 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.

    Bash
    python app.py
    Running on local URL: http://127.0.0.1:7860
    ...
  2. Para view a saída do aplicativo, abra http://127.0.0.1:7860 em uma janela do navegador.

    exibir a saída do aplicativo hello world localmente

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. Crie o aplicativo em seu site Databricks workspace.
nota
  • 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.

Bash
databricks apps create <app-name>

Substitua <app-name> por um nome para seu aplicativo. Por exemplo, gradio-hello-world. 2. Para view o aplicativo em seu workspace quando o create comando for concluído, na barra lateral, clique em ícone de computação compute , vá para Apps tab e clique no link para seu aplicativo na coluna Name .

visualizar a página de detalhes do aplicativo após a criação do aplicativo 3. Sincronize os arquivos de seu ambiente local com o Databricks workspace. O comando para sincronizar os arquivos de seu ambiente local com o workspace, incluindo o caminho workspace para os arquivos, está em Sync source files into Databricks . Clique em Ícone de cópia para copiar esse comando.

  1. Em um terminal, vá para o diretório que contém os arquivos do aplicativo e execute o comando sync copiado.
nota

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.

Bash
databricks sync --watch . /Workspace/Users/user@databricks.com/gradio-hello-world
...
Initial Sync Complete
  1. Para view os arquivos sincronizados em seu workspace quando o comando sync for concluído, clique em ícone do workspace workspace na barra lateral e vá para o diretório criado para seu aplicativo.

  2. 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>

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

    visualizar a página de detalhes do aplicativo após a implantação 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.

    Link para o aplicativo implantado

Próximas etapas

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?