Conectando o Databricks ao seu app

Conecte seu app ao Databricks para executar notebooks, rodar SQL e gerenciar pipelines de dados. Depois, crie painéis, relatórios e apps de IA com base nos dados do seu lakehouse.

Você precisa de um Plano Builder ou superior para usar conectores no seu app.

O que você pode fazer

Transforme seus dados e jobs em ações e insights no seu app.

Executar notebooks e jobs

Dispare notebooks e jobs de pipelines de dados do Databricks a partir do seu app.

Executar SQL

Execute SQL no seu lakehouse e nos SQL warehouses e mostre os resultados no seu app.

Criar painéis de análise

Transforme consultas do Databricks em gráficos, tabelas e painéis que sua equipe pode ler.

Prompts de exemplo Descreva no chat de IA o notebook, o job ou a consulta, o que o dispara e os campos dinâmicos. Por exemplo:

Execute um notebook do Databricks para processar os dados de hoje.

Execute uma consulta SQL no meu lakehouse do Databricks.

Dispare um job de pipeline de dados no Databricks.

Busque os resultados de um SQL warehouse do Databricks.

Mostre o status dos meus jobs mais recentes do Databricks em um painel.

Configurando o OAuth no Databricks

Você precisa que um admin da conta do Databricks crie um aplicativo OAuth personalizado antes de conectar o Databricks à Base44.

Obtenha a callback URL da Base44

Obtenha a callback URL da Base44 em Registrando callback URLs.

Crie o aplicativo OAuth do Databricks

Siga o guia do Databricks para criar um aplicativo OAuth personalizado.No Databricks, adicione essa callback URL como redirect URI e selecione All APIs.

Gere suas credenciais

Clique em Generate a client secret e copie o Client ID e o Client Secret. O Databricks mostra o Client Secret apenas uma vez.

Conectando o Databricks

Conecte o Databricks para que seu app possa consultar seus dados.

Antes de começar:

App OAuth do Databricks: Peça a um admin da conta do Databricks para criar um aplicativo OAuth personalizado e gerar um client secret. Guarde o ID do cliente e o Segredo do cliente. Veja Configurando o OAuth no Databricks.
Databricks Workspace URL: Tenha em mãos a URL do seu próprio workspace do Databricks. Copie-a do navegador enquanto estiver conectado a esse workspace.
Acesso ao workspace da Base44: Você precisa ser dono ou admin do workspace para registrar o conector na Base44.
Acesso ao Databricks: Cada pessoa que se conecta precisa de acesso aos recursos do workspace do Databricks que seu app usa.

Para adicionar o Databricks pela página Connectors:

Clique em Conectores na barra lateral do seu workspace.
Clique em Adicionar conector.
Pesquise Databricks e clique no resultado.
Insira um Nome do conector.
Insira o ID do cliente e o Segredo do cliente do seu app OAuth do Databricks.
Mantenha os padrões em Escopos. Selecione sql se seu app executa SQL. Veja Escopos e permissões.
Insira sua própria Databricks Workspace URL em Configuração de conexão, por exemplo https://dbc-xxxxxxxx-xxxx.cloud.databricks.com. Ela termina em .databricks.com, .azuredatabricks.net, .cloud.databricks.us ou .cloud.databricks.mil. Copie-a do navegador, sem caminho nem query string, e não insira databricks.com nem accounts.cloud.databricks.com.
Clique em Adicionar conector.
Abra seu app no editor do app.
Peça ao chat de IA para adicionar um recurso do Databricks.
Autorize a conta quando solicitado.

Seu app pode usar uma conexão compartilhada do Databricks ou deixar cada pessoa conectar a própria conta. Diga ao chat de IA qual opção você quer.

Escopos e permissões

Suas permissões do Databricks determinam quais dados e recursos do workspace seu app pode usar.

A Base44 adiciona

all-apis: Chama as APIs do Databricks
offline_access: Atualiza a conexão sem um novo login

Você configura

sql: Executa consultas SQL nos SQL warehouses do Databricks. Selecione-o em Escopos se seu app executa SQL.
Deixe Escopos adicionais vazio, a menos que seu app precise de mais.

Acesso: O Databricks limita a conexão às permissões que a identidade conectada já tem no workspace.

Usando o Databricks em uma função de backend

Depois que o Databricks está conectado, suas funções de backend podem obter um token de acesso e chamar as APIs do Databricks. A Base44 cuida do fluxo OAuth e do armazenamento das credenciais.

Conector compartilhado
Conector de usuário do app

Use getWorkspaceConnection(connectorId) quando seu app usa uma identidade compartilhada do Databricks.

import { createClientFromRequest } from "npm:@base44/sdk@0.8.44";

Deno.serve(async (req) => {
  const base44 = createClientFromRequest(req);
  const connectorId = "YOUR_CONNECTOR_ID";

  const { accessToken, connectionConfig } =
    await base44.asServiceRole.connectors.getWorkspaceConnection(connectorId);

  const baseUrl = connectionConfig.host.startsWith("https://")
    ? connectionConfig.host
    : `https://${connectionConfig.host}`;

  // Use accessToken and baseUrl to call the Databricks REST API.
  return Response.json({ workspaceUrl: baseUrl });
});

Use getCurrentAppUserConnection(connectorId) quando cada pessoa se conecta com a própria identidade do Databricks.

import { createClientFromRequest } from "npm:@base44/sdk@0.8.44";

Deno.serve(async (req) => {
  const base44 = createClientFromRequest(req);
  const user = await base44.auth.me();

  if (!user) {
    return Response.json({ error: "Unauthorized" }, { status: 401 });
  }

  const connectorId = "YOUR_CONNECTOR_ID";
  const { accessToken, connectionConfig } =
    await base44.asServiceRole.connectors.getCurrentAppUserConnection(connectorId);

  const baseUrl = connectionConfig.host.startsWith("https://")
    ? connectionConfig.host
    : `https://${connectionConfig.host}`;

  // Use accessToken and baseUrl for the signed-in person's Databricks requests.
  return Response.json({ workspaceUrl: baseUrl });
});

Conectores (documentação para desenvolvedores)

Obtenha uma conexão, leia os detalhes dela e chame a API do serviço a partir de uma função de backend.

Solução de problemas

Verifique a URL do workspace e as permissões do Databricks se o conector não conseguir se conectar ou executar consultas.

A URL do workspace é rejeitada

O host do seu workspace precisa terminar em .databricks.com, .azuredatabricks.net, .cloud.databricks.us ou .cloud.databricks.mil. Insira-o sozinho, sem caminho, por exemplo adb-123456789.10.azuredatabricks.net.

As consultas falham com um erro de permissão

Cada pessoa que se conecta precisa de CAN_USE no SQL warehouse que seu app consulta. Caso contrário, o Databricks retorna PERMISSION_DENIED. Em uma conexão de usuário do app, o Unity Catalog é aplicado por pessoa. Assim, a mesma consulta pode retornar linhas diferentes para pessoas diferentes, ou TABLE_OR_VIEW_NOT_FOUND para alguém sem acesso a uma tabela.

Uma consulta falha sem um ID de warehouse

O Databricks não tem um SQL warehouse padrão, então toda consulta precisa de um ID de warehouse. Encontre-o no Databricks em SQL → SQL Warehouses, abra o warehouse e copie o ID dele.

Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a versão em inglês.

Começando

Criando seu app

Protegendo seu app

Promovendo seu app

Conectores

Registro de alterações

O que você pode fazer

Executar notebooks e jobs

Executar SQL

Criar painéis de análise

Configurando o OAuth no Databricks

Conectando o Databricks

Escopos e permissões

Usando o Databricks em uma função de backend

Conectores (documentação para desenvolvedores)

Solução de problemas

​O que você pode fazer

Executar notebooks e jobs

Executar SQL

Criar painéis de análise

​Configurando o OAuth no Databricks

​Conectando o Databricks

​Escopos e permissões

​Usando o Databricks em uma função de backend

Conectores (documentação para desenvolvedores)

​Solução de problemas

O que você pode fazer

Configurando o OAuth no Databricks

Conectando o Databricks

Escopos e permissões

Usando o Databricks em uma função de backend

Solução de problemas