Connexion de Perplexity avec Databricks

À propos du connecteur Databricks

Le connecteur Databricks vous permet d’interroger directement depuis Perplexity les données stockées dans votre Databricks Lakehouse. Il intègre Databricks aux fonctionnalités de productivité de Perplexity, vous permettant de rechercher et de combiner instantanément des informations pertinentes dans vos catalogues, schémas et tables Databricks, sans requêtes manuelles ni changement de contexte.

Le connecteur Databricks est disponible aux utilisateurs de Perplexity Pro, Perplexity Max, Enterprise Pro et Enterprise Max.

Que fait le connecteur Databricks ?

Une fois activé, le connecteur Databricks vous permet d’effectuer des recherches dans les catalogues, schémas et tables Databricks auxquels vous êtes autorisé afin de fournir des réponses basées sur ces données. Le connecteur s’authentifie à l’aide de votre identité Databricks individuelle via OAuth, ce qui signifie que les requêtes s’exécutent avec vos autorisations Databricks natives — aucun compte de service partagé n’est requis.

Vous pouvez utiliser le connecteur pour trouver rapidement des informations dans les tables Unity Catalog, les données Delta Lake et les vues, sans écrire manuellement de SQL ni passer à la console Databricks. Lorsque vos données Databricks sont mises à jour, le connecteur reflète automatiquement ces changements lors des requêtes suivantes.

Objets de données pris en charge

Le connecteur Databricks prend en charge :

Tables et vues Unity Catalog
Tables Delta Lake
Schémas et catalogues
Tables externes enregistrées dans Unity Catalog
Données structurées (tables CSV, JSON, Parquet)

Pour le moment, les données non structurées (images, audio, vidéo et fichiers stockés dans Databricks Volumes) ne sont pas prises en charge.

Authentification

Le connecteur Databricks utilise l’authentification OAuth (utilisateur individuel) . Chaque utilisateur Perplexity se connecte avec ses propres identifiants Databricks, et les requêtes s’exécutent avec les autorisations natives Unity Catalog de cet utilisateur — aucun compte de service partagé, PAT ou principal de service n’est impliqué.

Cela signifie :

L’accès aux données est régi par les autorisations Databricks existantes de chaque utilisateur
Chaque requête conserve une piste d’audit claire par utilisateur dans Databricks
Un administrateur de l’organisation configure l’application OAuth une seule fois ; les utilisateurs individuels s’authentifient ensuite avec leurs propres comptes

Remarque : Étant donné que les jetons OAuth sont liés à l’identité Databricks de chaque utilisateur, les utilisateurs ne pourront interroger que les catalogues, schémas et tables auxquels ils ont déjà accès dans Databricks. Veillez à ce que les autorisations Unity Catalog appropriées soient en place avant la connexion.

Contrôler ce que Perplexity peut faire dans Databricks

Le connecteur Databricks exécute du SQL via une surface d’outils (issue du Merge Databricks connector) qui inclut un outil général execute_sql_statement . Comme execute_sql_statement accepte du SQL arbitraire — y compris DDL et DML — la seule manière fiable d’imposer un mode lecture seule ou autrement de restreindre ce que Perplexity peut faire est au niveau de Unity Catalog, et non dans l’interface Perplexity.

Schéma recommandé : appliquer le mode lecture seule via les autorisations Unity Catalog.

Comme le connecteur s’authentifie par utilisateur via OAuth, chaque action que Perplexity tente d’exécuter s’effectue sous l’identité Databricks de cet utilisateur et est soumise à ses autorisations Unity Catalog existantes. Pour conserver une utilisation en lecture seule, veillez à ce que chaque utilisateur (ou le groupe auquel il appartient) dispose uniquement de :

USE CATALOG sur les catalogues que vous souhaitez lui faire interroger
USE SCHEMA sur les schémas que vous souhaitez lui faire interroger
SELECT sur les tables et vues que vous souhaitez lui faire interroger

Veillez également à ce qu’ils ne disposent explicitement pas de MODIFY, CREATE ni OWN sur ces objets, ni de CAN MANAGE sur l’entrepôt SQL. Avec Unity Catalog configuré de cette manière, Databricks rejettera toute tentative d’écriture de Perplexity sur des objets pour lesquels l’utilisateur n’a pas les privilèges d’écriture, quel que soit l’outil utilisé.

Remarque : Perplexity affiche un panneau Autorisations des outils dans les paramètres du connecteur Databricks qui répertorie les outils disponibles. À ce jour, ce panneau ne fournit pas de contrôle fiable des actions de lecture, d’écriture ou de modification : gérer l’accès au niveau Unity Catalog (ci-dessus) est la bonne manière de contrôler ce que Perplexity peut faire.

Confidentialité et sécurité des données

Lorsqu’il est connecté à Perplexity, le connecteur Databricks peut effectuer les actions suivantes en votre nom :

Exécuter des requêtes SQL sur des données Databricks via des SQL Warehouses
Interroger les tables, vues et schémas Unity Catalog
Lire les métadonnées et les données des tables Delta Lake

Si vous révoquez l’accès ou supprimez des autorisations dans Databricks, ces données deviennent immédiatement inaccessibles depuis Perplexity. Si vous déconnectez votre compte Databricks dans Perplexity, vous pouvez choisir de conserver ou de supprimer les données mises en cache.

Sécurité et contrôle de niveau entreprise

Pour les organisations Enterprise, Perplexity propose la certification SOC 2 Type II, un chiffrement de bout en bout, des mesures strictes de confidentialité des données et des contrôles d’accès utilisateur granulaires. Vos données Databricks ne sont jamais utilisées pour l’entraînement de l’IA.

La connexion de Perplexity à Databricks se fait au niveau personnel — aucune autre personne de votre organisation ne peut interroger vos données Databricks. En revanche, si vous synchronisez des données vers un Project partagé, toute personne ayant accès à ce Project pourra les rechercher.

Les administrateurs de l’organisation peuvent activer ou désactiver le connecteur Databricks pour tous les utilisateurs depuis l’écran Autorisations dans Paramètres de l’organisation. L’application des autorisations de lecture/écriture est gérée au niveau de Unity Catalog (voir Contrôler ce que Perplexity peut faire dans Databricks ci-dessus).

Comment l’activer

La configuration du connecteur Databricks se déroule en deux étapes : un administrateur configure l’application OAuth une fois pour l’organisation, puis chaque utilisateur s’authentifie avec son propre compte Databricks.

Partie 1 : Configuration par l’administrateur — Configurer Databricks pour votre organisation

Un administrateur de workspace Databricks doit effectuer cette étape une seule fois. Les utilisateurs individuels n’ont pas besoin de la répéter.

Dans Paramètres de l’organisation → Connecteurs → Databricks, vous verrez un panneau de configuration en trois étapes intitulé « Configurer Databricks pour votre organisation » :

Étape 1 : Gérer l’application OAuth — Cliquez sur Gérer l’application OAuth pour enregistrer Perplexity en tant que client OAuth dans votre workspace Databricks. Cela accorde à Perplexity l’autorisation d’authentifier les utilisateurs via OAuth auprès de votre workspace.
Étape 2 : Authentifier avec Databricks — L’administrateur s’authentifie une fois pour vérifier que l’intégration fonctionne de bout en bout.
Étape 3 : Générer une carte des données (facultatif) — Générez éventuellement une carte des données pour l’organisation (voir la Partie 3 ci-dessous et Comprendre la carte des données) et ajoutez du contexte supplémentaire pour améliorer la précision des requêtes.

Remarque : Vous aurez besoin des privilèges d’administrateur du workspace Databricks pour effectuer cette étape. Si vous ne savez pas comment enregistrer une application OAuth dans Databricks, consultez la documentation OAuth de Databricks.

Partie 2 : Configuration utilisateur — S’authentifier et se connecter

Chaque utilisateur effectue les étapes suivantes de manière indépendante :

Accédez à Connecteurs dans les paramètres et localisez le connecteur Databricks.
Cliquez sur Activer → Ajouter un connecteur.
Cliquez sur S’authentifier avec Databricks. Vous serez redirigé vers Databricks pour vous connecter avec vos propres identifiants.
Autorisez Perplexity à accéder à vos données Databricks.
Cliquez sur Autoriser pour terminer la configuration.

Partie 3 : Générer une carte des données (facultatif mais recommandé)

Après l’authentification, Perplexity peut générer une carte des données de votre environnement Databricks. Cela aide Computer à comprendre la structure de votre catalogue et à répondre plus précisément aux questions sur les données.

Cliquez sur Régénérer la carte des données pour créer ou actualiser la carte à tout moment.
Pour de meilleurs résultats, ajoutez également du contexte supplémentaire — téléversez des fichiers ou ajoutez des notes décrivant vos données (par exemple, ce que représentent les tables clés, les définitions métier, les modèles de requêtes courants). Ce contexte additionnel aide l’agent à interpréter correctement vos données.
Cliquez sur Afficher les connaissances pour examiner ce que Perplexity a appris sur votre environnement Databricks.

Si vous ignorez la carte des données, la précision des questions de données complexes sera réduite. Nous recommandons de la générer lors de la configuration initiale. En savoir plus dans Comprendre la carte des données.

Utilisation des données connectées

Une fois connecté, vous pouvez faire référence à vos données Databricks dans des tâches Computer . Mentionnez des catalogues, des schémas ou des tables et Perplexity les interrogera dans le cadre de flux de travail en plusieurs étapes — le tout de manière asynchrone dans un sandbox cloud sécurisé.

Essayer

Une fois connecté, essayez d’exécuter des requêtes comme celles-ci :

« Résumez les tendances de revenus du tableau des ventes du T4 et mettez en évidence les indicateurs clés »
« Trouvez tous les enregistrements clients mis à jour au cours des 30 derniers jours »
« Quels sont les produits les plus performants selon le schéma analytics ? »
« Comparez les données du pipeline de ce trimestre avec celles du trimestre précédent »

Dépannage

Databricks n’est pas activé pour votre organisation

Un administrateur de l’organisation a peut-être désactivé le connecteur, ou l’application OAuth n’a peut-être pas encore été configurée. Contactez l’administrateur de votre organisation pour confirmer, ou contactez l’assistance Perplexity.

Application OAuth non configurée

Si les utilisateurs voient une erreur lors de la tentative d’authentification, la configuration de l’application OAuth par l’administrateur (Partie 1) n’est peut-être pas terminée. Un administrateur de workspace doit revenir dans Paramètres de l’organisation → Connecteurs → Databricks et terminer l Gérer l’application OAuth étape.

L’utilisateur ne peut pas accéder à certaines tables après la connexion

Le connecteur Databricks respecte les autorisations Unity Catalog existantes de chaque utilisateur. Si un utilisateur ne parvient pas à interroger une table à laquelle il pense devoir avoir accès, vérifiez que le GRANT approprié a bien été appliqué dans Unity Catalog :

-- 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`;

La carte des données est obsolète ou inexacte

Si Perplexity génère des réponses incorrectes ou obsolètes concernant vos données Databricks, essayez de cliquer sur Régénérer la carte des données dans les paramètres du connecteur. Vous pouvez également ajouter ou mettre à jour du contexte supplémentaire pour mieux guider l’agent sur la structure de vos données.

Problèmes de connexion et d’authentification

Vérifiez que l’application OAuth est correctement configurée dans votre workspace Databricks
Confirmez que les URI de redirection de Perplexity figurent dans la liste d’autorisation des paramètres de votre application OAuth Databricks
Si votre workspace utilise des listes d’accès IP, assurez-vous que les adresses IP de Perplexity sont autorisées
Demandez aux utilisateurs de reconnecter le connecteur Databricks après toute modification de la politique du workspace

Si les problèmes persistent après la mise à jour de ces paramètres, contactez l’assistance Perplexity pour obtenir de l’aide.