Passer au contenu principal
Les connecteurs Databricks sont disponibles sur les plans Pro et Enterprise.
Boîte d'invite d'accueil Replit avec le menu déroulant Modèles ouvert, affichant le modèle d'organisation Databricks App
Les connecteurs Databricks permettent à 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 n’est requise. Replit prend en charge deux types de connexion Databricks. Choisissez-en un en fonction de l’identité qui doit exécuter chaque requête.

Choisir un type de connexion

Configurer l'utilisateur-à-machine (U2M)

Utilisez l’identité Databricks, les permissions et l’attribution d’audit de chaque créateur.

Configurer un principal de service (M2M)

Utilisez une identité et un ensemble de permissions Databricks partagés pour les créateurs autorisés.

Configurer le connecteur U2M

La configuration U2M implique trois rôles :
  1. Administrateur de compte Databricks : crée une connexion d’application OAuth et fournit les détails de l’entrepôt SQL.
  2. Administrateur d’organisation Replit : configure le connecteur avec les identifiants OAuth.
  3. Créateur : se connecte avec son compte Databricks et commence à créer.

Prérequis U2M

Avant de commencer, confirmez que vous disposez des éléments suivants :
  • Un administrateur de compte Databricks. Les connexions d’application se configurent dans la console de compte, et non dans les paramètres d’administration de l’espace de travail.
  • Un administrateur d’organisation Replit.
  • Un compte Databricks pour chaque créateur qui utilisera le connecteur.
  • Un accès à l’espace de travail pour chaque créateur, incluant la permission Can use sur l’entrepôt SQL et les permissions Unity Catalog requises.

Étape 1 : Créer une connexion d’application OAuth

Vous devez être administrateur de compte Databricks pour effectuer cette étape.
L’administrateur de compte Databricks enregistre Replit en tant qu’application OAuth. La connexion d’application fournit l’ID client et le secret client utilisés pour configurer Replit.
1

Ouvrir la console de compte Databricks

Dans votre espace de travail Databricks, ouvrez le sélecteur d’espace de travail dans le coin supérieur droit et sélectionnez Manage account.
Sélecteur d'espace de travail Databricks ouvert avec Manage account visible
2

Ouvrir Connexions d'application

Dans la console de compte, sélectionnez Paramètres, puis ouvrez l’onglet Connexions d’application.
Page Paramètres du compte Databricks avec l'onglet Connexions d'application sélectionné et le bouton Ajouter une connexion visible
3

Configurer la connexion Replit

Sélectionnez Ajouter une connexion. Entrez un nom d’application qui identifie Replit, par exemple replit-u2m.Sous URL de redirection, entrez :
Sous Portées d’accès, sélectionnez All APIs. Cela permet à Agent d’utiliser Databricks SQL et les API Databricks nécessaires pour créer et gérer des Databricks Apps.Sélectionnez Générer un secret client. Databricks ne peut pas ajouter de secret à cette connexion après sa création.Définissez les durées de vie des jetons selon la politique de sécurité de votre organisation. L’exemple utilise une durée de vie du jeton d’accès de 1440 minutes (24 heures) et une durée de vie du jeton de rafraîchissement de 129600 minutes (90 jours), les valeurs maximales proposées par Databricks. Une durée de vie de jeton de rafraîchissement plus courte peut obliger les créateurs à se reconnecter plus souvent.Sélectionnez Ajouter.
All APIs accorde un accès plus large que le SQL seul. Contrôlez l’accès effectif du connecteur grâce aux permissions Databricks de chaque créateur.
Formulaire Add connection de Databricks configuré avec un nom d'application Replit, une URL de redirection, l'accès All APIs, la génération d'un secret client et les durées de vie des jetons
4

Enregistrer les identifiants OAuth

Copiez l’ID client et le secret client, puis stockez-les dans le gestionnaire de secrets de votre organisation.
Databricks affiche le secret client une seule fois. Notez sa date d’expiration et faites tourner la connexion d’application avant que le secret n’expire.
Boîte de dialogue Connection created de Databricks avec l'ID client et le secret client masqués, ainsi que l'avertissement de secret à usage unique et la date d'expiration
Les connexions d’application OAuth nouvelles ou mises à jour peuvent prendre jusqu’à 30 minutes pour devenir disponibles.

Étape 2 : Partager les détails de l’entrepôt SQL

Chaque créateur saisit les détails de l’entrepôt SQL lors de l’autorisation du connecteur U2M. Publiez ces valeurs à un endroit accessible à vos créateurs, par exemple une page d’intégration interne.
1

Ouvrir les entrepôts SQL

Dans l’espace de travail Databricks, sélectionnez SQL Warehouses et ouvrez l’entrepôt que les créateurs doivent utiliser.
Page des entrepôts SQL Databricks affichant les entrepôts disponibles
2

Copier les détails de connexion

Sélectionnez Détails de connexion, puis copiez le Nom d’hôte du serveur et le Chemin HTTP.
Page des détails de connexion de l'entrepôt SQL Databricks avec le nom d'hôte du serveur et le chemin HTTP

Étape 3 : Activer U2M dans Replit

Vous devez être administrateur d’organisation Replit pour configurer les connecteurs.
1

Ouvrir et activer le connecteur U2M

Accédez à Intégrations dans Paramètres. Recherchez Databricks U2M, trouvez Databricks for Databricks Apps (U2M), et sélectionnez Activer.Entrez l’ID client et le secret client de la connexion d’application Databricks.Confirmez que l’URL de redirection affichée dans Replit correspond à l’URL configurée dans Databricks :
Sous Portées du connecteur, activez all-apis et offline_access. La portée offline_access fournit à Replit un jeton de rafraîchissement pour les sessions de longue durée.Sélectionnez Configurer.
Paramètres Intégrations Replit filtrés sur Databricks U2M avec le panneau d'activation affichant l'URL de redirection, les champs d'identifiants OAuth et les portées du connecteur
2

Vérifier que le connecteur est activé

Confirmez que Databricks for Databricks Apps (U2M) apparaît sous Vos intégrations.

Étape 4 : Se connecter en tant que créateur

Chaque créateur se connecte avec son propre compte Databricks avant d’utiliser le connecteur. Replit peut rafraîchir la session jusqu’à l’expiration du jeton de rafraîchissement.
1

Se connecter au connecteur

Sur la page Intégrations, trouvez Databricks for Databricks Apps (U2M) et sélectionnez Se connecter. Examinez les détails de connexion, puis sélectionnez Continuer vers Databricks for Databricks Apps.
Fenêtre modale Connect Databricks for Databricks Apps expliquant la redirection, la confidentialité et les contrôles de permission
2

Entrer les détails de l'entrepôt SQL

Entrez le Chemin HTTP de l’entrepôt SQL fourni par votre administrateur Databricks, puis sélectionnez Suivant.
Boîte de dialogue Connect Databricks for Databricks Apps demandant le chemin HTTP de l'entrepôt SQL à l'étape 1 sur 2
Replit demande ensuite le Nom d’hôte du serveur de l’entrepôt SQL. Entrez-le et continuez vers Databricks. Connectez-vous lorsque vous y êtes invité, examinez l’accès demandé, puis approuvez la demande.Chaque requête exécutée par Agent via cette connexion utilise vos permissions Databricks et est attribuée à vous dans les journaux d’audit Databricks.Après approbation, Databricks vous redirige vers Replit et le connecteur est prêt à l’emploi.

Configurer le connecteur à principal de service

La configuration du principal de service implique trois rôles :
  1. Administrateur Databricks : crée le principal de service et accorde les permissions dans Databricks.
  2. Administrateur d’organisation Replit : configure le connecteur et l’accès dans Replit.
  3. Créateur : commence à créer avec l’identité Databricks partagée.

Prérequis du principal de service

Avant de commencer, confirmez que vous disposez des éléments suivants :
  • Accès administrateur de compte ou administrateur d’espace de travail Databricks.
  • Accès administrateur d’organisation Replit.

É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.
Menu de l'espace de travail Databricks avec Paramètres sélectionné
2

Sélectionner Identité et accès

Dans la barre latérale des Paramètres, sélectionnez Identité et accès.
Page Paramètres Databricks avec Identité et accès dans la barre latérale
3

Gérer les principaux de service

Sous Gestion et autorisations, trouvez Principaux de service et sélectionnez Gérer.
Page des paramètres Identité et accès affichant le bouton Gérer des principaux de service
4

Ajouter un nouveau principal de service

Sélectionnez Ajouter un principal de service, puis sélectionnez Ajouter nouveau.
Boîte de dialogue Ajouter un principal de service avec le bouton Ajouter nouveau
5

Nommer le principal de service

Entrez un nom clair pour le principal de service, puis sélectionnez Ajouter.
Boîte de dialogue Ajouter un principal de service avec un nom de principal de service saisi
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.
Page de détails du principal de service Databricks
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.
Boîte de dialogue Accorder l'accès pour un principal de service Databricks avec la permission Gérer sélectionnée

É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.
Page des entrepôts SQL Databricks affichant les entrepôts disponibles
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.
Page des détails de connexion de l'entrepôt SQL Databricks avec le nom d'hôte du serveur et le chemin HTTP

É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

Accédez à Intégrations dans Paramètres. Sous Connecteurs, trouvez Databricks (Principal de service) et sélectionnez Se connecter.
Page Intégrations Replit filtrée sur Databricks, affichant le connecteur Databricks (Principal de service) avec un bouton 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.
Boîte de dialogue Connecter Databricks expliquant la redirection OAuth, l'utilisation des données et les permissions
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.
Boîte de dialogue Connecter Databricks étape 1 sur 2 demandant le chemin HTTP de l'entrepôt SQL
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.
Boîte de dialogue Connecter Databricks étape 2 sur 2 demandant le nom d'hôte du serveur de l'entrepôt SQL
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.
Page Intégrations Replit affichant le connecteur Databricks (Principal de service) avec un statut de connexion Actif

Créer avec Agent

Après la connexion avec l’une ou l’autre méthode, les créateurs peuvent créer des applications utilisant les données Databricks avec Agent.
1

Sélectionner le modèle Databricks App pour le déploiement

Sélectionnez le modèle Databricks App lorsque vous souhaitez déployer l’application terminée dans votre environnement Databricks. Le modèle n’est pas nécessaire pour utiliser un connecteur configuré afin d’accéder aux données et ressources Databricks.Depuis la page d’accueil Replit, sélectionnez + dans la boîte d’invite, ouvrez Utiliser un modèle, puis choisissez Databricks App.
Boîte d'invite de la page d'accueil Replit avec le menu plus ouvert et Utiliser un modèle affichant Databricks App et Microsoft Fabric App
2

Décrire votre application

Ajoutez votre invite après les instructions préremplies. 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. Demandez des modifications en langage naturel.

Utiliser Lakebase pour les données d’application

Les applications que vous publiez avec le modèle Databricks App utilisent Lakebase comme base de données PostgreSQL de production gérée. Créez et testez avec la base de données de développement dans Replit. Lors de la publication, Replit prépare une base de données Lakebase dans votre espace de travail Databricks et applique vos modifications de schéma. Utilisez Lakebase pour l’état de l’application, comme les comptes utilisateurs, les paramètres et les transactions. Continuez à utiliser un entrepôt SQL pour l’analytique et les données Unity Catalog.
1

Créer avec la base de données de développement

Demandez à Agent d’ajouter les données d’application dont votre projet a besoin. Utilisez l’outil Database pour examiner les tables et les données pendant que vous créez. Consultez Bases de données de développement et de production pour comprendre les différences entre les deux bases de données.
2

Préparer la base de données de production

Commencez à publier votre Databricks App. Examinez les modifications de schéma que Replit applique à Lakebase avant de continuer. Consultez Apporter des modifications sûres à votre base de données de production pour les modifications qui nécessitent une planification.
3

Publier votre application

Publiez l’application pour créer ou mettre à jour sa base de données Lakebase. Replit connecte automatiquement l’application publiée à Lakebase.
Les applications publiées avec d’autres modèles utilisent une base de données de production Replit standard au lieu de Lakebase.

Résolution des problèmes

Vérifiez les permissions Databricks de l’identité qui exécute la requête. Avec U2M, il s’agit du créateur individuel. Avec le connecteur à principal de service, il s’agit du principal de service partagé. L’identité peut avoir accès aux métadonnées mais aucune permission de lecture sur les données. Accordez les permissions de catalogue, de schéma ou de table requises, puis réessayez.
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. Pour U2M, vérifiez les valeurs saisies par le créateur concerné. Confirmez également que l’entrepôt est actif et que l’identité de la requête dispose de la permission de l’utiliser.
Pour U2M, confirmez que la connexion d’application Databricks liste https://replit.com/connectors/oauth/callback sous URL de redirection, sans barre oblique finale. Si l’authentification échoue pour tous les créateurs, vérifiez l’ID client et le secret client partagés, confirmez que le secret n’a pas expiré, et assurez-vous que les portées dans Replit correspondent à la connexion d’application Databricks.Pour le connecteur à 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.
Cela peut se produire avec U2M lorsque le jeton de rafraîchissement expire ou est révoqué. Recommencez le flux d’autorisation Databricks. Si les créateurs doivent se reconnecter plus souvent que ne l’exige votre politique de sécurité, vérifiez les durées de vie des jetons de la connexion d’application.

Documentation associée