Desenvolver aplicativos da Databricks

nota

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

Este artigo contém detalhes sobre a criação de dados e aplicativos AI com o Databricks Apps, incluindo como criar e editar aplicativos na interface do usuário, como usar os recursos da plataforma Databricks, como SQL warehouse, secrets e Databricks Jobs, práticas recomendadas para o desenvolvimento de aplicativos e informações importantes para o desenvolvimento de aplicativos usando estruturas compatíveis.

Como faço para criar um aplicativo na interface do usuário de aplicativos da Databricks?

1. Na barra lateral, clique em Novo e selecione Aplicativo no menu.

2. O senhor pode começar com um aplicativo de exemplo completo e pré-construído ou usar seu código-fonte e artefatos.

   • Para começar com um aplicativo de exemplo, selecione o padrão , clique em tab para sua estrutura preferida e selecione na lista de aplicativos.
   • Para criar um aplicativo usando seu código, selecione Personalizado .

   

3. Clique em Avançar .

4. No campo Nome do aplicativo , insira um nome para o aplicativo e, opcionalmente, insira uma descrição.

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.

Se você selecionou Personalizado , clique em Criar aplicativo . Se o senhor selecionou o padrão , configure o recurso necessário e clique em Create and implantado app . Consulte Atribuir recurso da plataforma Databricks a um aplicativo Databricks.

A página de detalhes do aplicativo é exibida depois que o senhor clica em Criar e implantar aplicativo ou Criar aplicativo . Se o senhor selecionou o padrão , o Databricks Apps cria seu aplicativo e, em seguida, implanta o aplicativo, incluindo o código de exemplo do padrão e a configuração necessária para o aplicativo. A página de detalhes do aplicativo mostra:

• O status da criação e implantação do aplicativo.
• As etapas que o senhor pode usar para continuar o desenvolvimento do aplicativo localmente, incluindo a cópia dos artefatos do aplicativo para o seu ambiente local e a sincronização das alterações locais com o site Databricks workspace.

Se o senhor selecionou Personalizado , a Databricks Apps cria o aplicativo. Como é necessário adicionar o código e os artefatos do aplicativo, o aplicativo deve ser implantado como uma etapa separada. A página de detalhes do aplicativo mostra:

• O status da criação do aplicativo.
• As etapas para sincronizar o código e os artefatos do aplicativo do seu ambiente de desenvolvimento local com o Databricks workspace e implantar o aplicativo.

Para saber como configurar um ambiente de desenvolvimento local, criar ou atualizar o código e a configuração de seu aplicativo localmente e sincronizar e implantar o aplicativo em seu Databricks workspace, consulte Get começar with Databricks Apps. 5. Se o senhor selecionou o padrão e deseja copiar os artefatos do aplicativo do site workspace para o ambiente de desenvolvimento local, poderá usar o site Databricks CLI:

Bash

databricks workspace export-dir <workspace-path> <target-path>

Substituir:

• <workspace-path> com o caminho para o diretório de arquivos workspace que contém o código e os artefatos do seu aplicativo.
• <target-path> com um caminho em seu ambiente local para copiar os arquivos.

Atribua o recurso da plataforma Databricks a um aplicativo Databricks

nota

Para usar o Databricks SQL, a entidade de serviço precisa ter acesso a um SQL warehouse e a todas as tabelas acessadas por consultas.

Para usar os recursos da plataforma Databricks, como Databricks SQL, Databricks Jobs, Mosaic AI Model Serving e Databricks secrets, adicione esses recursos ao seu aplicativo como recurso. O senhor pode adicionar recurso ao criar ou editar um aplicativo.

1. No cartão Criar novo aplicativo ou Editar aplicativo , clique em Configurações avançadas > + Adicionar recurso e selecione o tipo de recurso.

   

2. Dependendo do tipo de recurso, preencha os campos necessários para configurar o recurso, inclusive o campo recurso key . Esse key é usado posteriormente para fazer referência ao recurso.

3. Clique em Salvar .

4. Adicione uma entrada para o recurso no arquivo de configuração app.yaml usando o recurso SQL warehouse key. Como isso faz referência à origem do valor do parâmetro e não ao valor real, use valueFrom em vez de value.

   YAML

   env:
     - name: 'DATABRICKS_WAREHOUSE_ID'
       valueFrom: 'sql-warehouse'

5. Para fazer referência ao recurso no código do aplicativo, use o valor do campo name (DATABRICKS_WAREHOUSE_ID neste exemplo) para fazer referência ao valor configurado em key.

   Python

   import os
   
   os.getenv('DATABRICKS_WAREHOUSE_ID')

Para ver mais exemplos de uso de recurso com aplicativos, incluindo SQL warehouse e servindo modelo de endpoint, consulte os exemplos de padrão quando o senhor cria um aplicativo e Usando segredos para armazenar informações confidenciais para um aplicativo Databricks.

Veja os detalhes de um aplicativo Databricks

Para view a página de detalhes de um aplicativo Databricks:

1. Clique em Calcular na barra lateral.
2. Vá para Apps tab.
3. Na coluna Nome , clique no nome do aplicativo.
4. A Visão geral tab é exibida com detalhes sobre o aplicativo, incluindo o status, o local de implantação e qualquer recurso associado.
   • Para acessar o histórico de implementação do aplicativo, vá para Deployments tab.
   • Para acessar view o logs do aplicativo, vá para os registros tab.
   • Para view o ambiente de tempo de execução do aplicativo, incluindo a variável de ambiente e o pacote instalado, acesse Environment tab.

Configurar permissões para seu aplicativo Databricks

Para gerenciar as permissões do aplicativo, o senhor deve ter a permissão CAN MANAGE ou IS OWNER. Para acessar o aplicativo, o usuário deve ter permissões CAN_USE ou CAN_MANAGE no aplicativo. A menos que um usuário exija a permissão CAN_MANAGE em um aplicativo, a Databricks recomenda atribuir apenas a permissão CAN_USE.

1. Na página de detalhes do aplicativo, clique em Permissões .
2. Em Permissions Settings (Configurações de permissões ), selecione o menu suspenso Select User, Group or entidade de serviço e, em seguida, selecione um usuário, grupo, entidade de serviço ou todos os usuários do site workspace.
3. Selecione uma permissão no dropdown de permissões.
4. Clique em Adicionar e, em seguida, clique em Salvar .

Como manter o estado do seu aplicativo Databricks

Qualquer estado que seu aplicativo mantenha na memória é perdido quando ele é reiniciado. Se seu aplicativo exigir a manutenção do estado entre as reinicializações, armazene o estado externamente. Por exemplo, seu aplicativo pode usar Databricks SQLworkspace arquivos ou Unity Catalog volumes para manter o estado.

Registro em log do seu aplicativo Databricks

nota

Para view fazer login na UI do Databricks Apps ou com o URL do aplicativo, seu aplicativo deve log para stdout e stderr.

Para view a saída padrão e o erro padrão de um aplicativo, na página de detalhes do aplicativo, clique em logs tab. Veja os detalhes de um aplicativo Databricks.

O senhor também pode acessar view a saída padrão e o erro padrão logs no link <appurl>/logz. Por exemplo, se o URL do seu aplicativo for https://my-app-1234567890.my-instance.databricksapps.com, o senhor poderá acessar view o logs em https://my-app-1234567890.my-instance.databricksapps.com/logz. Para encontrar o URL do aplicativo, acesse a página de detalhes do aplicativo.

Especificando dependências de biblioteca para seu aplicativo Databricks

Se o seu aplicativo exigir Python biblioteca diferente do pacote instalado automaticamente com a implantação, use um arquivo requirements.txt para definir essa biblioteca. Se um pacote em seu arquivo requirements.txt duplicar um dos pacotes instalados automaticamente, a versão em seu requirements.txt substituirá o pacote instalado automaticamente.

Para obter a lista de pacotes e versões instalados como parte da implantação do aplicativo, consulte Python biblioteca instalada.

Cabeçalhos HTTP passados para os aplicativos da Databricks

Os seguintes cabeçalhos X-Forwarded-* são transmitidos do proxy reverso do Databricks Apps para os aplicativos:

cabeçalho	Descrição
X-Forwarded-Host	O host ou domínio original solicitado pelo cliente.
X-Forwarded-Preferred-Username	O nome de usuário fornecido pelo IdP.
X-Forwarded-User	O identificador de usuário fornecido pelo IdP.
X-Forwarded-Email	O usuário email fornecido pelo IdP.
X-Real-Ip	O endereço IP do cliente que fez a solicitação original.
X-Request-Id	O UUID da solicitação.

Uso de segredos para armazenar informações confidenciais em um aplicativo Databricks

Databricks recomenda o uso de segredos para armazenar informações confidenciais, como credenciais de autenticação. Para saber mais sobre como usar segredos, consulte gerenciar segredos.

Para usar um segredo com seu aplicativo:

1. Configure o segredo como um recurso de aplicativo.

   

2. Adicione uma entrada para o segredo no arquivo de configuração app.yaml do aplicativo.

   YAML

   env:
     - name: 'API_TOKEN'
       valueFrom: 'api-token-value'

3. Para fazer referência ao segredo no código do aplicativo, use o valor do campo name (API_TOKEN neste exemplo) para se referir ao valor configurado em key.

Python

token = os.getenv('API_TOKEN')