Configurez un connecteur Databricks pour que Replit Agent puisse créer des applications orientées données alimentées par votre espace de travail Databricks.
Use this file to discover all available pages before exploring further.
Le connecteur Databricks est disponible exclusivement sur le plan Enterprise.
Le connecteur Databricks permet à Replit Agent d’interroger votre espace de travail Databricks. Les créateurs peuvent concevoir des tableaux de bord, des outils de reporting et des applications de données en langage naturel. Aucune expertise SQL requise.La configuration est un processus unique impliquant un administrateur Databricks et un administrateur d’organisation Replit. Une fois configuré, les créateurs ayant accès peuvent utiliser le connecteur depuis Replit.Ce guide couvre la configuration complète pour trois rôles :
Administrateur Databricks : crée le principal de service et accorde les permissions dans Databricks.
Administrateur Replit : configure le connecteur dans Replit.
Créateur : commence à créer avec les données Databricks.
Avant de commencer, confirmez les points suivants. Certaines de ces contraintes pourront être assouplies à l’avenir au fur et à mesure que Replit et Databricks ajouteront des fonctionnalités.Rôles
Administrateur de compte ou administrateur d’espace de travail Databricks
Administrateur d’organisation Replit
Contraintes de l’espace de travail Databricks
Aucun profil de sécurité de conformité (CSP), tel que HIPAA, FedRAMP ou PCI.
L’entrée est ouverte, sans listes d’accès IP ni contrôles d’entrée basés sur le contexte.
La sortie est ouverte, sans passerelle de sortie sécurisée (SEG) ni pare-feux.
Étape 1 : Créer un principal de service dans Databricks
Vous devez être administrateur de compte ou administrateur d’espace de travail Databricks pour effectuer cette étape.
L’administrateur Databricks crée une identité machine-à-machine, appelée principal de service, que Replit utilise pour se connecter à Databricks.
1
Ouvrir les Paramètres
Dans Databricks, sélectionnez votre avatar dans le coin supérieur droit, puis sélectionnez Paramètres.
2
Sélectionner Identité et accès
Dans la barre latérale des Paramètres, sélectionnez Identité et accès.
3
Gérer les principaux de service
Sous Gestion et autorisations, trouvez Principaux de service et sélectionnez Gérer.
4
Ajouter un nouveau principal de service
Sélectionnez Ajouter un principal de service, puis sélectionnez Ajouter nouveau.
5
Nommer le principal de service
Entrez un nom clair pour le principal de service, puis sélectionnez Ajouter.
6
Confirmer les détails du principal de service
Après que Databricks crée le principal de service, confirmez qu’il est actif. Gardez cette page ouverte si vous avez besoin des détails du principal de service lors de la configuration du connecteur Replit.
7
Accorder l'accès
Ouvrez l’onglet Permissions, sélectionnez Accorder l’accès, choisissez le principal de service, définissez la permission sur Gérer, puis sélectionnez Enregistrer.
Étape 2 : Obtenir les détails de connexion à votre entrepôt SQL
Le connecteur Replit a besoin des détails de connexion à l’entrepôt SQL Databricks pour acheminer les requêtes vers la bonne ressource de calcul.
1
Ouvrir les entrepôts SQL
Dans la barre latérale Databricks, sélectionnez Entrepôts SQL.
2
Sélectionner ou créer un entrepôt
Sélectionnez l’entrepôt SQL que vous souhaitez que Replit Agent utilise. Si vous n’en avez pas encore, sélectionnez Créer un entrepôt SQL et créez un nouvel entrepôt.
3
Copier les détails de connexion
Ouvrez l’entrepôt et sélectionnez Détails de connexion. Repérez les valeurs Nom d’hôte du serveur et Chemin HTTP. Vous aurez besoin de ces valeurs lors de la création du connecteur Databricks dans Replit.
Étape 3 : Créer le connecteur Databricks dans Replit
Vous devez être administrateur d’organisation Replit pour configurer les connecteurs.
L’administrateur Replit ajoute les détails de connexion Databricks à Replit pour que les créateurs puissent utiliser le connecteur.
1
Accéder aux Intégrations
Depuis la page d’accueil de votre organisation, ouvrez la page Intégrations. Sous Connecteurs, trouvez Databricks (Principal de service) et sélectionnez Se connecter.
2
Confirmer la connexion
Replit affiche une boîte de dialogue de confirmation avant de rediriger vers Databricks pour l’authentification. Examinez les détails et sélectionnez Continuer vers Databricks.
3
Entrer le chemin HTTP de l'entrepôt SQL
Collez le chemin HTTP depuis les détails de connexion de votre entrepôt SQL Databricks (par exemple, /sql/1.0/warehouses/abcdef1234567890), puis sélectionnez Suivant.
4
Entrer le nom d'hôte du serveur de l'entrepôt SQL
Collez le Nom d’hôte du serveur depuis les mêmes détails de connexion (par exemple, abc-12345678-wxyz.cloud.databricks.com), puis sélectionnez Continuer vers Databricks pour terminer l’authentification.
5
Configurer l'accès
Utilisez le contrôle d’accès basé sur les rôles pour choisir quels membres ou groupes de votre organisation peuvent utiliser ce connecteur.
6
Vérifier que le connecteur est actif
De retour sur la page Intégrations, confirmez que Databricks (Principal de service) apparaît sous Connecteurs avec un statut de connexion Actif.
Après la connexion, les créateurs peuvent créer des applications utilisant des données Databricks avec Agent.
1
Démarrer un projet
Depuis votre page d’accueil Replit, ouvrez la boîte d’invite pour démarrer un nouveau projet.
2
Sélectionner le modèle Databricks App
Ouvrez le menu déroulant Modèles et choisissez Databricks App sous Modèles d’organisation. L’invite est préremplie avec des instructions qui indiquent à Agent comment utiliser votre connecteur Databricks.
Ajoutez votre propre invite après les instructions préremplies pour décrire ce que vous souhaitez créer. Pour vous inspirer, parcourez les modèles Databricks Dev Hub.
3
Réviser et itérer
Examinez le SQL généré par Agent, les tables qu’il interroge et la structure de l’application. Itérez en demandant des modifications en langage naturel.
L'authentification échoue après la création du principal de service
Vérifiez que les détails du principal de service saisis dans Replit correspondent au principal de service créé dans Databricks. Si les identifiants ont été renouvelés, mettez à jour le connecteur dans Replit.
Agent peut voir les schémas mais les requêtes retournent des résultats vides
Le principal de service peut avoir accès aux métadonnées mais aucune permission de lecture sur les données. Accordez les permissions requises sur les tables, schémas ou catalogues dans Databricks et réessayez.
Connexion bloquée au niveau de la couche réseau
Confirmez que l’espace de travail répond aux prérequis : aucun profil de sécurité de conformité, aucune liste d’accès IP, aucune passerelle de sortie sécurisée et aucun PrivateLink. Ces contraintes pourront être assouplies à l’avenir.
Le connecteur ne peut pas atteindre l'entrepôt SQL
Vérifiez que les valeurs Nom d’hôte du serveur et Chemin HTTP correspondent aux détails de connexion de l’entrepôt SQL dans Databricks.