Conectar Databricks a tu app

Conecta tu app a Databricks para ejecutar notebooks, lanzar SQL y gestionar pipelines de datos. Después crea paneles, informes y apps de IA sobre los datos de tu lakehouse.

Necesitas un plan Builder o superior para usar conectores en tu app.

Qué puedes hacer

Convierte tus datos y jobs en acciones e información útil en tu app.

Ejecutar notebooks y jobs

Lanza notebooks y jobs de pipelines de datos de Databricks desde tu app.

Ejecutar SQL

Ejecuta SQL en tu lakehouse y tus SQL warehouses, y muestra los resultados en tu app.

Crear paneles de analítica

Convierte las consultas de Databricks en gráficos, tablas y paneles que tu equipo pueda leer.

Prompts de ejemplo Describe en el chat de IA el notebook, job o consulta, qué lo activa y los campos dinámicos. Por ejemplo:

Ejecuta un notebook de Databricks para procesar los datos de hoy.

Ejecuta una consulta SQL en mi lakehouse de Databricks.

Lanza un job de pipeline de datos en Databricks.

Obtén los resultados de un SQL warehouse de Databricks.

Muestra el estado de mis últimos jobs de Databricks en un dashboard.

Configurar OAuth en Databricks

Un administrador de la cuenta de Databricks debe crear una aplicación OAuth personalizada antes de que conectes Databricks a Base44.

Obtén la URL de callback de Base44

Obtén la URL de callback de Base44 en Registrar URLs de callback.

Crea la aplicación OAuth de Databricks

Sigue la guía de Databricks para crear una aplicación OAuth personalizada.En Databricks, añade esa URL de callback como URI de redirección y selecciona All APIs.

Genera tus credenciales

Haz clic en Generate a client secret y copia el Client ID y el Client Secret. Databricks muestra el Client Secret una sola vez.

Conectar Databricks

Conecta Databricks para que tu app pueda consultar tus datos.

Antes de empezar:

App OAuth de Databricks: Pide a un administrador de la cuenta de Databricks que cree una aplicación OAuth personalizada y genere un client secret. Guarda su ID de cliente y su Secreto del cliente. Consulta Configurar OAuth en Databricks.
Databricks Workspace URL: Ten a mano la URL de tu propio workspace de Databricks. Cópiala desde tu navegador mientras tienes la sesión iniciada en ese workspace.
Acceso al workspace de Base44: Debes ser propietario o administrador del workspace para registrar el conector en Base44.
Acceso a Databricks: Cada persona que se conecta necesita acceso a los recursos del workspace de Databricks que usa tu app.

Para añadir Databricks desde la página Connectors:

Haz clic en Conectores en la barra lateral de tu workspace.
Haz clic en Agregar conector.
Busca Databricks y haz clic en él.
Introduce un Nombre del conector.
Introduce el ID de cliente y el Secreto del cliente de tu app OAuth de Databricks.
Mantén los valores predeterminados en Scopes. Selecciona sql si tu app ejecuta SQL. Consulta Alcances y permisos.
En Configuración de conexión, introduce tu propia Databricks Workspace URL, por ejemplo https://dbc-xxxxxxxx-xxxx.cloud.databricks.com. Termina en .databricks.com, .azuredatabricks.net, .cloud.databricks.us o .cloud.databricks.mil. Cópiala desde tu navegador, sin ruta ni cadena de consulta, y no introduzcas databricks.com ni accounts.cloud.databricks.com.
Haz clic en Agregar conector.
Abre tu app en el editor de apps.
Pide al chat de IA que añada una función de Databricks.
Autoriza la cuenta cuando se te pida.

Tu app puede usar una conexión compartida de Databricks o dejar que cada persona conecte su propia cuenta. Dile al chat de IA qué prefieres.

Alcances y permisos

Tus permisos de Databricks determinan qué datos y recursos del workspace puede usar tu app.

Base44 añade

all-apis: Llama a las API de Databricks
offline_access: Actualiza la conexión sin volver a iniciar sesión

Tú configuras

sql: Ejecuta consultas SQL en SQL warehouses de Databricks. Selecciónalo en Scopes si tu app ejecuta SQL.
Deja Alcances adicionales vacío salvo que tu app necesite más.

Acceso: Databricks limita la conexión a los permisos que ya tiene la identidad conectada en el workspace.

Usar Databricks en una función de backend

Una vez conectado Databricks, tus funciones de backend pueden obtener un token de acceso y llamar a las API de Databricks. Base44 gestiona el flujo OAuth y el almacenamiento de credenciales.

Conector compartido
Conector para usuarios de la app

Usa getWorkspaceConnection(connectorId) cuando tu app use una sola identidad compartida de 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 });
});

Usa getCurrentAppUserConnection(connectorId) cuando cada persona se conecte con su propia identidad de 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 (documentación para desarrolladores)

Obtén una conexión, lee sus datos y llama a la API del servicio desde una función de backend.

Solución de problemas

Revisa la URL de tu workspace y tus permisos de Databricks si el conector no puede conectarse o ejecutar consultas.

Se rechaza la URL del workspace

El host de tu workspace debe terminar en .databricks.com, .azuredatabricks.net, .cloud.databricks.us o .cloud.databricks.mil. Introdúcelo solo, sin ruta, por ejemplo adb-123456789.10.azuredatabricks.net.

Las consultas fallan con un error de permisos

Cada persona que se conecta necesita CAN_USE en el SQL warehouse que consulta tu app, o Databricks devuelve PERMISSION_DENIED. En una conexión de usuario de la app, Unity Catalog se aplica por persona. Así, la misma consulta puede devolver filas distintas para personas distintas, o TABLE_OR_VIEW_NOT_FOUND para alguien sin acceso a una tabla.

Una consulta falla sin un ID de warehouse

Databricks no tiene un SQL warehouse predeterminado, así que cada consulta necesita un ID de warehouse. Encuéntralo en Databricks en SQL → SQL Warehouses, abre el warehouse y copia su ID.

Esta página fue traducida con IA. Para obtener la información más precisa y actualizada, consulta la versión en inglés.

Empezando

Creando tu app

Protegiendo tu app

Promocionando tu app

Conectores

Registro de cambios

Qué puedes hacer

Ejecutar notebooks y jobs

Ejecutar SQL

Crear paneles de analítica

Configurar OAuth en Databricks

Conectar Databricks

Alcances y permisos

Usar Databricks en una función de backend

Conectores (documentación para desarrolladores)

Solución de problemas

​Qué puedes hacer

Ejecutar notebooks y jobs

Ejecutar SQL

Crear paneles de analítica

​Configurar OAuth en Databricks

​Conectar Databricks

​Alcances y permisos

​Usar Databricks en una función de backend

Conectores (documentación para desarrolladores)

​Solución de problemas

Qué puedes hacer

Configurar OAuth en Databricks

Conectar Databricks

Alcances y permisos

Usar Databricks en una función de backend

Solución de problemas