Über den Databricks Connector
Mit dem Databricks Connector können Sie die in Ihrem Databricks Lakehouse gespeicherten Daten direkt aus Perplexity abfragen. Es integriert Databricks mit den Produktivitätsfunktionen von Perplexity und ermöglicht Ihnen die sofortige Suche und Kombination relevanter Informationen in Ihren Databricks Katalogen, Schemata und Tabellen – ohne manuelle Abfragen oder Kontextwechsel.
Der Databricks Connector ist verfügbar für Perplexity Pro, Perplexity Max, Enterprise Pro, Und Enterprise Max users.
Was macht der Databricks Connector?
Sobald Sie den Databricks-Connector aktiviert haben, können Sie Ihre autorisierten Databricks-Kataloge, Schemata und Tabellen durchsuchen, um auf der Grundlage dieser Daten Antworten bereitzustellen. Der Connector authentifiziert sich mithilfe Ihrer individuellen Databricks-Identität über OAuth, was bedeutet, dass Abfragen unter Ihren nativen Databricks-Berechtigungen ausgeführt werden – kein gemeinsames Dienstkonto erforderlich.
Mit dem Connector können Sie schnell Informationen in Unity Catalog-Tabellen, Delta Lake-Daten und Ansichten finden, ohne manuell SQL schreiben oder zur Databricks-Konsole wechseln zu müssen. Wenn Ihre Databricks-Daten aktualisiert werden, spiegelt der Connector diese Änderungen bei nachfolgenden Abfragen automatisch wider.
Unterstützte Datenobjekte
Der Databricks Connector unterstützt:
-
Tabellen und Ansichten des Unity-Katalogs
-
Delta Lake-Tische
-
Schemata und Kataloge
-
Im Unity-Katalog registrierte externe Tabellen
-
Strukturierte Daten (CSV, JSON, Parquet-gestützte Tabellen)
Derzeit werden unstrukturierte Daten (Bilder, Audio, Video und in Databricks-Volumes gespeicherte Dateien) nicht unterstützt.
Authentifizierung
Der Databricks Connector verwendet OAuth (einzelner Benutzer) Authentifizierung. Jeder Perplexity-Benutzer stellt eine Verbindung mit seinen eigenen Databricks-Anmeldeinformationen her und Abfragen werden unter den nativen Unity Catalog-Berechtigungen dieses Benutzers ausgeführt – es ist kein gemeinsam genutztes Dienstkonto, PAT oder Dienstprinzipal beteiligt.
Das heisst:
-
Der Datenzugriff wird durch die vorhandenen Databricks-Berechtigungen jedes Benutzers geregelt
-
Jede Abfrage enthält einen eindeutigen Audit-Trail pro Benutzer in Databricks
-
Ein Organisationsadministrator konfiguriert die OAuth-App einmal; Einzelne Benutzer authentifizieren sich dann mit ihren eigenen Konten
Notiz: Da OAuth-Tokens an die Databricks-Identität jedes Benutzers gebunden sind, können Benutzer nur Kataloge, Schemata und Tabellen abfragen, auf die sie in Databricks bereits Zugriff haben. Stellen Sie sicher, dass die entsprechenden Unity Catalog-Zuschüsse vorhanden sind, bevor Sie eine Verbindung herstellen.
Steuern, was Perplexity in Databricks tun kann
Der Databricks Connector führt SQL über eine Tool-Oberfläche aus (Quelle: Databricks-Stecker zusammenführen), die einen General enthält execute_sql_statement Werkzeug. Weil execute_sql_statement akzeptiert beliebiges SQL – einschließlich DDL und DML – das Die einzige zuverlässige Möglichkeit, den Schreibschutz zu erzwingen oder die Möglichkeiten von Perplexity auf andere Weise einzuschränken, ist die Ebene des Unity-Katalogs, nicht in der Perplexity-Benutzeroberfläche.
Empfohlenes Muster: Schreibgeschützt über Unity Catalog-Zuschüsse erzwingen.
Da der Connector die Authentifizierung pro Benutzer über OAuth durchführt, werden alle Perplexity-Aktionsversuche unter der Databricks-Identität dieses Benutzers ausgeführt und unterliegen seinen vorhandenen Unity-Katalogberechtigungen. Um die Nutzung schreibgeschützt zu halten, stellen Sie sicher, dass jeder Benutzer (oder die Gruppe, zu der er gehört) nur über Folgendes verfügt:
-
USE CATALOGauf den Katalogen, die sie abfragen sollen -
USE SCHEMAauf den Schemata, die sie abfragen sollen -
SELECTauf den Tabellen und Ansichten, die sie abfragen sollen
Und das ausdrücklich nicht halten MODIFY, CREATE, oder OWN auf diesen Objekten, noch CAN MANAGE auf dem SQL-Warehouse. Wenn Unity Catalog auf diese Weise konfiguriert ist, lehnt Databricks alle Schreibversuche Perplexity für Objekte ab, für die der Benutzer keine Schreibrechte hat, unabhängig davon, welches Tool aufgerufen wird.
Notiz: Perplexity Oberflächen a Werkzeugberechtigungen Panel in den Databricks Connector-Einstellungen, das die verfügbaren Tools auflistet. Heute ist dies bei diesem Gremium der Fall nicht Bereitstellung einer zuverlässigen Lese-/Schreib-/Bearbeitungsdurchsetzung – die Steuerung des Zugriffs auf der Ebene des Unity-Katalogs (oben) ist der richtige Weg, um zu steuern, was Perplexity tun kann.
Datenschutz und Datensicherheit
Wenn der Databricks-Connector mit Perplexity verbunden ist, kann er in Ihrem Namen die folgenden Aktionen ausführen:
-
Führen Sie SQL-Abfragen für Databricks-Daten über SQL Warehouses aus
-
Fragen Sie Unity Catalog-Tabellen, -Ansichten und -Schemas ab
-
Lesen Sie die Metadaten und Daten der Delta Lake-Tabelle
Wenn Sie in Databricks den Zugriff widerrufen oder Berechtigungen entfernen, sind diese Daten in Perplexity sofort nicht mehr zugänglich. Wenn Sie Ihr Databricks-Konto in Perplexity trennen, können Sie wählen, ob Sie zwischengespeicherte Daten behalten oder löschen möchten.
Enterprise-Sicherheit und Kontrolle
Für Enterprise-Organisationen bietet Perplexity SOC 2 Typ II-Zertifizierung, Ende-zu-Ende-Verschlüsselung, strenge Datenschutzmaßnahmen und detaillierte Benutzerzugriffskontrollen. Ihre Databricks-Daten werden niemals für das KI-Training verwendet.
Die Verbindung von Perplexity mit Databricks erfolgt bei a persönliche Ebene — Niemand sonst in Ihrer Organisation kann Ihre Databricks-Daten abfragen. Wenn Sie jedoch Daten mit einem freigegebenen Projekt synchronisieren, kann jeder, der Zugriff auf dieses Projekt hat, es durchsuchen.
Organisationsadministratoren können den Databricks Connector für alle Benutzer aus dem aktivieren oder deaktivieren Berechtigungen Bildschirm rein Organisationseinstellungen. Die Durchsetzung von Lese-/Schreibzugriffen erfolgt auf der Ebene des Unity-Katalogs (siehe Steuern, was Perplexity in Databricks tun kann above).
So aktivieren Sie es
Das Einrichten des Databricks-Connectors ist ein zweiteiliger Prozess: Ein Administrator konfiguriert die OAuth-App einmal für die Organisation und dann authentifiziert sich jeder Benutzer mit seinem eigenen Databricks-Konto.
Teil 1: Admin-Setup – Konfigurieren Sie Databricks für Ihre Organisation
Ein Databricks Workspace-Administrator muss diesen Schritt einmal ausführen. Einzelne Benutzer müssen es nicht wiederholen.
In Organisationseinstellungen → Connectoren → Databricks, sehen Sie einen dreistufigen Einrichtungsbereich mit dem Titel „Konfigurieren Sie Databricks für Ihre Organisation“
-
Schritt 1: OAuth-App verwalten – Klicken OAuth-App verwalten um Perplexity als OAuth-Client in Ihrem Databricks-Projekt zu registrieren. Dadurch wird Perplexity die Berechtigung erteilt, Benutzer über OAuth in Ihrem Projekt zu authentifizieren.
-
Schritt 2: Authentifizieren mit Databricks — Der Administrator authentifiziert sich einmal, um zu überprüfen, ob die Integration durchgängig funktioniert.
-
Schritt 3: Generieren Sie eine Datenkarte (optional) – Erstellen Sie optional eine Datenkarte für die Organisation (siehe Teil 3 unten und). Die Datenkarte verstehen) und ergänzenden Kontext hinzufügen, um die Abfragegenauigkeit zu verbessern.
Notiz: Um diesen Schritt abzuschließen, benötigen Sie Databricks Workspace-Administratorrechte. Wenn Sie sich nicht sicher sind, wie Sie eine OAuth-App in Databricks registrieren, lesen Sie die Databricks OAuth-Dokumentation.
Teil 2: Benutzereinrichtung – Authentifizieren und verbinden
Jeder Benutzer führt die folgenden Schritte unabhängig aus:
-
Gehe zu Connectors in den Einstellungen und suchen Sie die Databricks Connector.
-
Klicken Aktivieren Connector hinzufügen.
-
Klicken Authentifizieren mit Databricks. Sie werden zu Databricks weitergeleitet, um sich mit Ihren eigenen Zugangsdaten anzumelden.
-
Erteilen Sie Perplexity Zugriff auf Ihre Databricks-Daten.
-
Klicken Erlauben um die Einrichtung abzuschließen.
Teil 3: Generieren Sie eine Datenkarte (optional, aber empfohlen)
Nach der Authentifizierung kann Perplexity eine generieren Datenkarte Ihrer Databricks Umgebung. Dies hilft Computer, Ihre Katalogstruktur zu verstehen und Datenfragen genauer zu beantworten.
-
Klicken Datenkarte neu generieren um die Karte jederzeit zu erstellen oder zu aktualisieren.
-
Für beste Ergebnisse auch hinzufügen Ergänzender Kontext – Laden Sie Dateien hoch oder fügen Sie Notizen hinzu, die Ihre Daten beschreiben (z. B. was Schlüsseltabellen darstellen, Geschäftsdefinitionen, gängige Abfragemuster). Dieser zusätzliche Kontext hilft dem Agenten, Ihre Daten richtig zu interpretieren.
-
Klicken Wissen ansehen um zu überprüfen, was Perplexity über Ihre Databricks-Umgebung erfahren hat.
Das Überspringen der Datenkarte führt zu einer geringeren Genauigkeit bei komplexen Datenfragen. Wir empfehlen, es im Rahmen der Ersteinrichtung zu generieren. Erfahren Sie mehr in Die Datenkarte verstehen.
Nutzung verbundener Daten
Sobald die Verbindung hergestellt ist, können Sie auf Ihre Databricks-Daten zugreifen Computer Sitzungen. Erwähnen Sie Kataloge, Schemata oder Tabellen und Perplexity fragt sie im Rahmen mehrstufiger Workflows ab – alles asynchron in einer sicheren Cloud-Sandbox.
Probieren Sie es aus
Sobald die Verbindung hergestellt ist, versuchen Sie, Abfragen wie diese auszuführen:
-
„Fassen Sie die Umsatztrends aus der Q4-Umsatztabelle zusammen und heben Sie wichtige Kennzahlen hervor.“
-
„Alle Kundendatensätze finden, die in den letzten 30 Tagen aktualisiert wurden“
-
„Was sind die leistungsstärksten Produkte basierend auf dem Analyseschema?“
-
„Vergleichen Sie die Pipeline-Daten dieses Quartals mit den Zahlen des Vorquartals.“
Fehlerbehebung
Databricks ist für Ihre Organisation nicht aktiviert
Möglicherweise hat ein Organisationsadministrator den Connector deaktiviert oder die OAuth-App ist möglicherweise noch nicht konfiguriert. Wenden Sie sich zur Bestätigung an den Administrator Ihrer Organisation oder wenden Sie sich an den Perplexity-Support.
OAuth-App nicht konfiguriert
Wenn Benutzern beim Authentifizierungsversuch ein Fehler angezeigt wird, ist die Einrichtung der Administrator-OAuth-App (Teil 1) möglicherweise nicht abgeschlossen. Ein Workspace-Administrator sollte zu Organisationseinstellungen → Connectors → Databricks zurückkehren und den Vorgang abschließen OAuth-App verwalten step.
Der Benutzer kann nach der Verbindung nicht auf bestimmte Tabellen zugreifen
Der Databricks Connector respektiert die vorhandenen Unity Catalog-Berechtigungen jedes Benutzers. Wenn ein Benutzer eine Tabelle, auf die er voraussichtlich zugreifen möchte, nicht abfragen kann, überprüfen Sie, ob dies der Fall ist GRANT wurde im Unity-Katalog angewendet:
-- Grant access to a catalog
GRANT USE CATALOG ON CATALOG my_catalog TO `user@example.com`;
-- Grant access to a schema
GRANT USE SCHEMA ON SCHEMA my_catalog.my_schema TO `user@example.com`;
-- Grant read access to tables
GRANT SELECT ON TABLE my_catalog.my_schema.my_table TO `user@example.com`;
Die Datenkarte ist veraltet oder ungenau
Wenn Perplexity falsche oder veraltete Antworten zu Ihren Databricks-Daten generiert, versuchen Sie es mit einem Klick Datenkarte neu generieren in den Connector-Einstellungen. Sie können auch hinzufügen oder aktualisieren Ergänzender Kontext um dem Agenten eine bessere Anleitung zu Ihrer Datenstruktur zu geben.
Verbindungs- und Authentifizierungsprobleme
-
Stellen Sie sicher, dass die OAuth-App in Ihrem Databricks-Projekt korrekt konfiguriert ist
-
Bestätigen Sie, dass die Umleitungs-URIs von Perplexity in Ihren Databricks OAuth-App-Einstellungen auf der Zulassungsliste stehen
-
Wenn Ihr Projekt IP-Zugriffslisten verwendet, stellen Sie sicher, dass die IPs von Perplexity auf der Zulassungsliste stehen
-
Bitten Sie Benutzer, den Databricks-Connector nach Änderungen der Projektsrichtlinien erneut zu verbinden
Wenn die Probleme nach der Aktualisierung dieser Einstellungen weiterhin bestehen, wenden Sie sich an den Perplexity-Support, um Hilfe zu erhalten.