> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Databricks

> Verbinde Databricks über deinen eigenen OAuth-Client mit Langdock.

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](https://docs.langdock.com/de/admin/manage-integrations/integration-setup-guides/databricks.md).

## 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](https://docs.langdock.com/de/admin/security/static-ip-configuration.md).
* 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](https://docs.databricks.com/aws/en/integrations/enable-disable-oauth#enable-custom-oauth-applications-using-the-databricks-ui).

**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](https://docs.langdock.com/de/admin/manage-integrations/bring-your-own-oauth.md) 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](https://docs.langdock.com/de/using-langdock/integrations/connections.md) 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](https://docs.langdock.com/de/admin/manage-integrations/manage-action-level-scopes.md), wenn nötig. Ergebnisse können im Chat und im Modellkontext erhalten bleiben. Prüfe die [Bedingungen zur Datenverarbeitung](https://docs.langdock.com/de/admin/compliance-and-governance/legal-compliance.md).

## Fehlerbehebung

| Problem | Was du prüfen kannst |
| - | - |
| Redirect-URL wird abgelehnt | Kopiere die exakte URL aus Langdock und prüfe Host, Pfad und abschließenden Schrägstrich. Warte nach Änderungen bis zu 30 Minuten. |
| `invalid_client` oder Anmeldung schlägt fehl | Prüfe, ob Client-ID und Secret zur selben aktiven App gehören und die Verbindung die standardmäßige HTTPS-Adresse des Workspace nutzt. |
| `403` oder eine Ressource fehlt | Prüfe **Get connected identity**, die Rechte für Workspace und Ressource sowie **CAN USE** für SQL oder **CAN RUN** für Genie. Wenn die Identitätsprüfung fehlschlägt, prüfe auch die Workspace URL und Scopes. |
| Token abgelaufen oder Zugriff entzogen | [Autorisiere](https://docs.langdock.com/de/using-langdock/integrations/connections.md#oauth-verbindungen-neu-autorisieren) die Verbindung erneut. Wenn App oder Scopes geändert wurden, prüfe den aktiven Client und verbinde das Konto erneut. |
| Abfrage läuft noch oder Ausgang einer Aktion ist unklar | Prüfe mit **Get SQL result** die vorhandene Statement-ID oder prüfe das Objekt beziehungsweise **Query History** in Databricks, bevor du eine Aktion wiederholst. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.