Databricks mit deiner App verbinden

Verbinde deine App mit Databricks, um Notebooks auszuführen, SQL auszuführen und Datenpipelines zu verwalten. Baue dann Dashboards, Berichte und KI-Apps auf deinen Lakehouse-Daten auf.

Du benötigst einen Builder-Tarif oder höher, um Connectors in deiner App zu nutzen.

Was du tun kannst

Mach aus deinen Daten und Jobs Aktionen und Erkenntnisse in deiner App.

Notebooks und Jobs ausführen

Starte Databricks-Notebooks und Datenpipeline-Jobs aus deiner App.

SQL ausführen

Führe SQL gegen dein Lakehouse und deine SQL-Warehouses aus und zeige die Ergebnisse in deiner App an.

Analyse-Dashboards bauen

Verwandle Databricks-Abfragen in Diagramme, Tabellen und Dashboards für dein Team.

Beispiel-Prompts Beschreibe im KI-Chat das Notebook, den Job oder die Abfrage, was die Aktion auslöst, und alle dynamischen Felder. Zum Beispiel:

Führe ein Databricks-Notebook aus, um die heutigen Daten zu verarbeiten.

Führe eine SQL-Abfrage auf meinem Databricks-Lakehouse aus.

Starte einen Datenpipeline-Job in Databricks.

Hole Ergebnisse aus einem Databricks SQL Warehouse.

Zeige den Status meiner neuesten Databricks-Jobs in einem Dashboard an.

OAuth in Databricks einrichten

Ein Databricks-Kontoadmin muss eine eigene OAuth-Anwendung erstellen, bevor du Databricks mit Base44 verbindest.

Die Base44-Callback-URL abrufen

Die Base44-Callback-URL findest du unter Callback-URLs registrieren.

Die Databricks-OAuth-Anwendung erstellen

Folge der Anleitung von Databricks zum Erstellen einer eigenen OAuth-Anwendung.Füge in Databricks diese Callback-URL als Redirect-URI hinzu und wähle All APIs.

Deine Zugangsdaten generieren

Klicke auf Generate a client secret und kopiere dann die Client ID und das Client Secret. Databricks zeigt das Client Secret nur einmal an.

Databricks verbinden

Verbinde Databricks, damit deine App deine Daten abfragen kann.

Bevor du beginnst:

Databricks-OAuth-App: Lass einen Databricks-Kontoadmin eine eigene OAuth-Anwendung erstellen und ein Client Secret generieren. Bewahre die Client-ID und das Client-Geheimnis auf. Siehe OAuth in Databricks einrichten.
Databricks-Workspace-URL: Halte die URL deines eigenen Databricks-Workspace bereit. Kopiere sie aus deinem Browser, während du in diesem Workspace angemeldet bist.
Base44-Workspace-Zugriff: Du musst Workspace-Owner oder Admin sein, um den Connector in Base44 zu registrieren.
Databricks-Zugriff: Jede Person, die sich verbindet, braucht Zugriff auf die Ressourcen im Databricks-Workspace, die deine App nutzt.

So fügst du Databricks über die Seite Connectors hinzu:

Klicke in der Seitenleiste deines Workspaces auf Konnektoren.
Klicke auf Connector hinzufügen.
Suche nach Databricks und klicke darauf.
Gib einen Connector name ein.
Gib die Client-ID und das Client-Geheimnis aus deiner Databricks-OAuth-App ein.
Behalte unter Scopes die Standardwerte bei. Wähle sql, wenn deine App SQL ausführt. Siehe Scopes und Berechtigungen.
Gib unter Verbindungskonfiguration deine eigene Databricks Workspace URL ein, zum Beispiel https://dbc-xxxxxxxx-xxxx.cloud.databricks.com. Sie endet auf .databricks.com, .azuredatabricks.net, .cloud.databricks.us oder .cloud.databricks.mil. Kopiere sie ohne Pfad und Query-String aus deinem Browser. Gib nicht databricks.com oder accounts.cloud.databricks.com ein.
Klicke auf Konnektor hinzufügen.
Öffne deine App im App-Editor.
Bitte den KI-Chat, eine Databricks-Funktion hinzuzufügen.
Autorisiere das Konto, wenn du dazu aufgefordert wirst.

Deine App kann eine gemeinsame Databricks-Verbindung nutzen oder jede Person ihr eigenes Konto verbinden lassen. Sag dem KI-Chat, was du möchtest.

Scopes und Berechtigungen

Deine Databricks-Berechtigungen bestimmen, welche Daten und Workspace-Ressourcen deine App nutzen kann.

Base44 fügt hinzu

all-apis: Ruft Databricks-APIs auf
offline_access: Erneuert die Verbindung ohne erneute Anmeldung

Du konfigurierst

sql: Führt SQL-Abfragen auf Databricks SQL Warehouses aus. Wähle ihn unter Scopes, wenn deine App SQL ausführt.
Lass Zusätzliche Bereiche leer, sofern deine App nicht mehr benötigt.

Zugriff: Databricks beschränkt die Verbindung auf die bestehenden Workspace-Berechtigungen der verbundenen Identität.

Databricks in einer Backend-Funktion nutzen

Sobald Databricks verbunden ist, können deine Backend-Funktionen ein Zugriffstoken abrufen und Databricks-APIs aufrufen. Base44 übernimmt den OAuth-Flow und die Speicherung der Zugangsdaten.

Gemeinsamer Connector
App-Nutzer-Connector

Verwende getWorkspaceConnection(connectorId), wenn deine App eine gemeinsame Databricks-Identität nutzt.

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 });
});

Verwende getCurrentAppUserConnection(connectorId), wenn sich jede Person mit ihrer eigenen Databricks-Identität verbindet.

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 });
});

Connectors (Entwicklerdokumentation)

Rufe eine Verbindung ab, lies ihre Details und rufe die API des Dienstes aus einer Backend-Funktion auf.

Fehlerbehebung

Prüfe deine Workspace-URL und deine Databricks-Berechtigungen, wenn der Connector keine Verbindung herstellen oder keine Abfragen ausführen kann.

Die Workspace-URL wird abgelehnt

Dein Workspace-Host muss auf .databricks.com, .azuredatabricks.net, .cloud.databricks.us oder .cloud.databricks.mil enden. Gib ihn allein ein, ohne Pfad, zum Beispiel adb-123456789.10.azuredatabricks.net.

Abfragen schlagen mit einem Berechtigungsfehler fehl

Jede Person, die sich verbindet, braucht CAN_USE für das SQL-Warehouse, das deine App abfragt. Sonst gibt Databricks PERMISSION_DENIED zurück. Bei einer App-Nutzer-Verbindung gilt Unity Catalog pro Person. Dieselbe Abfrage kann also für verschiedene Personen unterschiedliche Zeilen liefern. Für jemanden ohne Zugriff auf eine Tabelle kommt TABLE_OR_VIEW_NOT_FOUND zurück.

Eine Abfrage schlägt ohne Warehouse-ID fehl

Databricks hat kein Standard-SQL-Warehouse. Jede Abfrage braucht daher eine Warehouse-ID. Du findest sie in Databricks unter SQL → SQL Warehouses. Öffne das Warehouse und kopiere seine ID.

Diese Seite wurde mit KI übersetzt. Die genauesten und aktuellsten Informationen findest du in der englischen Version.

Erste Schritte

App erstellen

App absichern

App bewerben

Konnektoren

Änderungsprotokoll

Was du tun kannst

Notebooks und Jobs ausführen

SQL ausführen

Analyse-Dashboards bauen

OAuth in Databricks einrichten

Databricks verbinden

Scopes und Berechtigungen

Databricks in einer Backend-Funktion nutzen

Connectors (Entwicklerdokumentation)

Fehlerbehebung

​Was du tun kannst

Notebooks und Jobs ausführen

SQL ausführen

Analyse-Dashboards bauen

​OAuth in Databricks einrichten

​Databricks verbinden

​Scopes und Berechtigungen

​Databricks in einer Backend-Funktion nutzen

Connectors (Entwicklerdokumentation)

​Fehlerbehebung

Was du tun kannst

OAuth in Databricks einrichten

Databricks verbinden

Scopes und Berechtigungen

Databricks in einer Backend-Funktion nutzen

Fehlerbehebung