Zum Hauptinhalt springen
Verbinde Databricks über eine OAuth-App, die deine Organisation registriert. Langdock stellt für diese Integration keinen verwalteten Client bereit. Für eine Verbindung mit Personal Access Token nutze stattdessen Databricks PAT.

Voraussetzungen

  • Einen Databricks Account-Admin für die Registrierung der App und einen Langdock Workspace-Admin für die Konfiguration.
  • Einen Databricks Workspace, bei dem sich Mitglieder anmelden können und den Langdock erreichen kann. Bei einer IP-Freigabeliste beachte die Konfiguration statischer IPs.
  • Zugriff auf die gewünschten Ressourcen. Für direktes SQL brauchst du Unity Catalog und ein zugängliches SQL Warehouse. Für Genie brauchst du Zugriff auf einen Genie Agent und seine Datenquellen.

Integration einrichten

1

Redirect-URL kopieren

Öffne Workspace Einstellungen → Integrationen → Databricks. Klicke unter OAuth-Clients auf Konfiguriere deinen OAuth-Client, um diese Integration zu nutzen und kopiere die Redirect-URL.
2

App in Databricks registrieren

Öffne als Databricks Account-Admin die Account Console für deine Cloud: accounts.cloud.databricks.com für AWS, accounts.azuredatabricks.net für Azure oder accounts.gcp.databricks.com für Google Cloud. Wähle Settings → App connections → Add connection.Gib einen Namen ein, füge die exakte Redirect-URL aus Langdock ein, wähle All APIs unter Access scopes und aktiviere Generate a client secret. Die Account Console lässt offline_access automatisch zu. Lege die Gültigkeitsdauer der Tokens gemäß deinen Sicherheitsrichtlinien fest. Wenn ein Refresh Token abläuft, müssen sich Nutzer erneut anmelden.Kopiere die Client ID und das Client-Secret aus Connection created und bewahre das Secret sicher auf. Databricks zeigt es nur einmal an. Änderungen an der App können bis zu 30 Minuten benötigen. Siehe die Databricks Anleitung zur App-Registrierung.
3

Client in Langdock konfigurieren

Gib die Client-ID und das Client-Secret in Langdock ein. Lass die Scopes all-apis offline_access unverändert: all-apis deckt die APIs der Integration ab, offline_access ermöglicht Refresh Tokens. Der Scope sql allein reicht nicht aus.Gib unter OAuth-Verbindungsdetails die Workspace URL ein, wenn alle denselben Databricks Workspace nutzen sollen. Lass das Feld andernfalls leer, damit Mitglieder ihre URL selbst eingeben. Verwende die standardmäßige HTTPS-Adresse des Workspace ohne eigene Domain oder Port, nicht die URL der Account Console.Lege unter Zugriff fest, wer den Client nutzen kann. Klicke auf Speichern und bestätige. Wenn der Client noch nicht aktiv ist, wähle ihn in der Liste aus und bestätige den Wechsel. Unter Eigenen OAuth-Client verwenden findest du Details zum Gruppenzugriff und zur Auswahl eines Clients.
4

Konto verbinden

Öffne Plugins → Databricks → Verbindung hinzufügen. Wähle den konfigurierten Client und gib deine Workspace URL ein, falls Langdock danach fragt. Melde dich mit deinem Databricks Konto an und bestätige den Zugriff. Prüfe mit Get connected identity, welches Konto verbunden ist.

Berechtigungen und Limits

Databricks nutzt die Identität, die die ausgewählte Verbindung autorisiert hat. Unity Catalog wendet deren Berechtigungen, Zeilenfilter und Spaltenmasken auf geschützte Daten an. Eine vorausgewählte Verbindung nutzt die Identität ihres Besitzers, nicht die der Person im Chat. Für individuellen Zugriff in geteilten Agenten sollte jedes Mitglied ein eigenes Konto verbinden. Vergib für direktes SQL USE CATALOG, USE SCHEMA und SELECT für die vorgesehenen Datenquellen sowie CAN USE für das SQL Warehouse. Für Genie vergib CAN RUN für den Genie Agent und Zugriff auf seine Daten im Unity Catalog. Prüfe die Ausführungsidentität von Jobs und gespeicherten Abfragen, da sie vom verbundenen Konto abweichen kann. Run SQL query akzeptiert eine einzelne lesende Abfrage und verlangt eine Bestätigung. Dabei können Rechenkosten anfallen. Andere Aktionen können Änderungen vornehmen. Vergib nur die benötigten Rechte und schränke Aktionen in Langdock ein, wenn nötig. Ergebnisse können im Chat und im Modellkontext erhalten bleiben. Prüfe die Bedingungen zur Datenverarbeitung.

Fehlerbehebung