Connettere Databricks alla tua app

Connetti la tua app a Databricks per eseguire notebook, lanciare SQL e gestire pipeline di dati, poi costruisci dashboard, report e app AI basati sui dati del tuo lakehouse.

Ti serve un piano Builder o superiore per usare i connettori nella tua app.

Cosa puoi fare

Trasforma i tuoi dati e i tuoi job in azioni e insight nella tua app.

Esegui notebook e job

Avvia notebook Databricks e job di pipeline di dati dalla tua app.

Esegui SQL

Esegui SQL sul tuo lakehouse e sui SQL warehouse, e mostra i risultati nella tua app.

Costruisci dashboard di analisi

Trasforma le query Databricks in grafici, tabelle e dashboard leggibili dal tuo team.

Prompt di esempio

Esegui un notebook Databricks per elaborare i dati di oggi.

Esegui una query SQL sul mio lakehouse Databricks.

Avvia un job di pipeline di dati in Databricks.

Recupera i risultati da un SQL warehouse Databricks.

Configurare OAuth in Databricks

Serve un admin dell’account Databricks per creare un’applicazione OAuth personalizzata prima di connettere Databricks a Base44.

Ottieni l'URL di callback di Base44

Trovi l’URL di callback di Base44 in Registrare gli URL di callback.

Crea l'applicazione OAuth di Databricks

Segui la guida di Databricks alla creazione di un’applicazione OAuth personalizzata.In Databricks, aggiungi quell’URL di callback come redirect URI e seleziona All APIs.

Genera le tue credenziali

Clicca su Generate a client secret, poi copia il Client ID e il Client Secret. Databricks mostra il Client Secret una sola volta.

Connettere Databricks

Connetti Databricks così la tua app può interrogare i tuoi dati.

Prima di iniziare:

App OAuth di Databricks: fai creare a un admin dell’account Databricks un’applicazione OAuth personalizzata e generare un client secret. Conserva il Client ID e il Client Secret. Consulta Configurare OAuth in Databricks.
URL del workspace Databricks: tieni pronto l’URL del tuo workspace, ad esempio adb-123456789.10.azuredatabricks.net.
Accesso al workspace Base44: devi essere proprietario o admin del workspace per registrare il connettore in Base44.
Accesso a Databricks: ogni persona che si connette deve avere accesso alle risorse del workspace Databricks usate dalla tua app.

Per aggiungere Databricks dalla pagina Connectors:

Clicca su Connectors nella barra laterale del workspace.
Clicca su Add connector.
Cerca Databricks, poi cliccaci sopra.
Inserisci un Connector name.
Inserisci il Client ID e il Client Secret della tua app OAuth di Databricks.
Sotto Scopes, mantieni le impostazioni predefinite. Consulta Scope e permessi.
Sotto Connection Configuration, inserisci il tuo Databricks Workspace URL, ad esempio adb-123456789.10.azuredatabricks.net. Non includere un percorso o una query string.
Clicca su Add Connector.
Apri la tua app e chiedi alla chat AI di aggiungere una funzionalità Databricks.
Autorizza l’account quando richiesto.

La tua app può usare un’unica connessione Databricks condivisa o permettere a ogni persona di collegare il proprio account. Di’ alla chat AI quale preferisci.

Scope e permessi

I tuoi permessi Databricks determinano quali dati e risorse del workspace può usare la tua app.

Base44 aggiunge

all-apis: chiama le API di Databricks
offline_access: aggiorna la connessione senza un nuovo accesso

Tu configuri

Lascia vuoto Additional scopes, a meno che la tua app non abbia bisogno di altro.

Accesso: Databricks limita la connessione ai permessi del workspace già posseduti dall’identità collegata.

Usare Databricks in una funzione backend

Una volta connesso Databricks, le tue funzioni backend possono recuperare un token di accesso e chiamare le API di Databricks. Base44 gestisce il flusso OAuth e l’archiviazione delle credenziali.

Connettore condiviso
Connettore per utenti dell'app

Usa getWorkspaceConnection(connectorId) quando la tua app usa un’unica identità Databricks condivisa.

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) quando ogni persona si connette con la propria identità 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 });
});

Connettori (documentazione per sviluppatori)

Recupera una connessione, leggi i suoi dettagli e chiama l’API del servizio da una funzione backend.

Risoluzione dei problemi

Controlla l’URL del workspace e i permessi Databricks se il connettore non riesce a connettersi o a eseguire query.

L'URL del workspace viene rifiutato

L’host del tuo workspace deve terminare con databricks.com, azuredatabricks.net, cloud.databricks.us o cloud.databricks.mil. Inseriscilo da solo, senza percorso, ad esempio adb-123456789.10.azuredatabricks.net.

Le query falliscono con un errore di permessi

Ogni persona che si connette ha bisogno di CAN_USE sul SQL warehouse interrogato dalla tua app, altrimenti Databricks restituisce PERMISSION_DENIED. Per una connessione per utenti dell’app, Unity Catalog si applica a ogni persona. Quindi la stessa query può restituire righe diverse a persone diverse, o TABLE_OR_VIEW_NOT_FOUND a chi non ha accesso a una tabella.

Una query fallisce senza un ID del warehouse

Databricks non ha un SQL warehouse predefinito, quindi ogni query ha bisogno di un ID del warehouse. Trovalo in Databricks sotto SQL → SQL Warehouses, poi apri il warehouse e copia il suo ID.

Questa pagina è stata tradotta con l’AI. Per le informazioni più accurate e aggiornate, consulta la versione inglese.

Per iniziare

Creare la tua app

Proteggere la tua app

Promuovere la tua app

Connettori

Registro modifiche

Cosa puoi fare

Esegui notebook e job

Esegui SQL

Costruisci dashboard di analisi

Configurare OAuth in Databricks

Connettere Databricks

Scope e permessi

Usare Databricks in una funzione backend

Connettori (documentazione per sviluppatori)

Risoluzione dei problemi

​Cosa puoi fare

Esegui notebook e job

Esegui SQL

Costruisci dashboard di analisi

​Configurare OAuth in Databricks

​Connettere Databricks

​Scope e permessi

​Usare Databricks in una funzione backend

Connettori (documentazione per sviluppatori)

​Risoluzione dei problemi

Cosa puoi fare

Configurare OAuth in Databricks

Connettere Databricks

Scope e permessi

Usare Databricks in una funzione backend

Risoluzione dei problemi