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

# Connecteur Databricks

> 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.

<Info>
  Le connecteur Databricks est disponible exclusivement sur le plan **Enterprise**.
</Info>

<Frame>
  <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/templates-dropdown-zoom.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=92d2df97ba167b7fd5b9dfe7509e7dfa" alt="Boîte d'invite d'accueil Replit avec le menu déroulant Modèles ouvert, affichant le modèle d'organisation Databricks App" width="1680" height="300" data-path="images/connectors/databricks/templates-dropdown-zoom.png" />
</Frame>

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 :

1. **Administrateur Databricks** : crée le principal de service et accorde les permissions dans Databricks.
2. **Administrateur Replit** : configure le connecteur dans Replit.
3. **Créateur** : commence à créer avec les données Databricks.

## Prérequis

Avant de commencer, confirmez les points suivants.

**Rôles**

* Administrateur de compte ou administrateur d'espace de travail [Databricks](https://www.databricks.com/)
* Administrateur d'organisation [Replit](https://replit.com/)

## Étape 1 : Créer un principal de service dans Databricks

<Note>
  Vous devez être administrateur de compte ou administrateur d'espace de travail Databricks pour effectuer cette étape.
</Note>

L'administrateur Databricks crée une identité machine-à-machine, appelée [principal de service](https://docs.databricks.com/aws/en/admin/users-groups/service-principals), que Replit utilise pour se connecter à Databricks.

<Steps>
  <Step title="Ouvrir les Paramètres">
    Dans Databricks, sélectionnez votre avatar dans le coin supérieur droit, puis sélectionnez **Paramètres**.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/settings-menu.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=4179d36f68585cf88af24ab86d960694" alt="Menu de l'espace de travail Databricks avec Paramètres sélectionné" width="3438" height="1984" data-path="images/connectors/databricks/settings-menu.png" />
    </Frame>
  </Step>

  <Step title="Sélectionner Identité et accès">
    Dans la barre latérale des Paramètres, sélectionnez **Identité et accès**.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/settings-page.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=8e22324831c8804b135a3b5e550e7f45" alt="Page Paramètres Databricks avec Identité et accès dans la barre latérale" width="3438" height="1984" data-path="images/connectors/databricks/settings-page.png" />
    </Frame>
  </Step>

  <Step title="Gérer les principaux de service">
    Sous **Gestion et autorisations**, trouvez **Principaux de service** et sélectionnez **Gérer**.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/identity-and-access.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=4c502716a573596cbe0550644036654d" alt="Page des paramètres Identité et accès affichant le bouton Gérer des principaux de service" width="3438" height="1984" data-path="images/connectors/databricks/identity-and-access.png" />
    </Frame>
  </Step>

  <Step title="Ajouter un nouveau principal de service">
    Sélectionnez **Ajouter un principal de service**, puis sélectionnez **Ajouter nouveau**.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/add-service-principal.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=ca1c2ec068049bd48b2c590d9cae4b3f" alt="Boîte de dialogue Ajouter un principal de service avec le bouton Ajouter nouveau" width="3438" height="1984" data-path="images/connectors/databricks/add-service-principal.png" />
    </Frame>
  </Step>

  <Step title="Nommer le principal de service">
    Entrez un nom clair pour le principal de service, puis sélectionnez **Ajouter**.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/add-service-principal-name.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=f2490e64e7bb1516e153f7690da5c9a2" alt="Boîte de dialogue Ajouter un principal de service avec un nom de principal de service saisi" width="3438" height="1984" data-path="images/connectors/databricks/add-service-principal-name.png" />
    </Frame>
  </Step>

  <Step title="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.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/service-principal-details.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=ffdb270b49e7b6a330c3691358b8234b" alt="Page de détails du principal de service Databricks" width="3438" height="1984" data-path="images/connectors/databricks/service-principal-details.png" />
    </Frame>
  </Step>

  <Step title="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**.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/grant-access.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=ee85ab8f1741b86f830efcd80427a596" alt="Boîte de dialogue Accorder l'accès pour un principal de service Databricks avec la permission Gérer sélectionnée" width="3438" height="1984" data-path="images/connectors/databricks/grant-access.png" />
    </Frame>
  </Step>
</Steps>

## É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.

<Steps>
  <Step title="Ouvrir les entrepôts SQL">
    Dans la barre latérale Databricks, sélectionnez **Entrepôts SQL**.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/sql-warehouses.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=8610ede28b6a723fd5774fb9e97c7485" alt="Page des entrepôts SQL Databricks affichant les entrepôts disponibles" width="3438" height="1984" data-path="images/connectors/databricks/sql-warehouses.png" />
    </Frame>
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/connection-details.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=b2e51207eb945f4e9e939caa093c2b23" alt="Page des détails de connexion de l'entrepôt SQL Databricks avec le nom d'hôte du serveur et le chemin HTTP" width="3438" height="1984" data-path="images/connectors/databricks/connection-details.png" />
    </Frame>
  </Step>
</Steps>

## Étape 3 : Créer le connecteur Databricks dans Replit

<Note>
  Vous devez être administrateur d'organisation Replit pour configurer les connecteurs.
</Note>

L'administrateur Replit ajoute les détails de connexion Databricks à Replit pour que les créateurs puissent utiliser le connecteur.

<Steps>
  <Step title="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**.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/integrations-databricks-signin.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=f3b1558a4d4afc021fd7b2be96004ea7" alt="Page Intégrations Replit filtrée sur Databricks, affichant le connecteur Databricks (Principal de service) avec un bouton Se connecter" width="3436" height="1978" data-path="images/connectors/databricks/integrations-databricks-signin.png" />
    </Frame>
  </Step>

  <Step title="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**.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/connect-databricks-intro.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=d1bd23f4bb71d62a555993b106f4596e" alt="Boîte de dialogue Connecter Databricks expliquant la redirection OAuth, l'utilisation des données et les permissions" width="3436" height="1978" data-path="images/connectors/databricks/connect-databricks-intro.png" />
    </Frame>
  </Step>

  <Step title="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**.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/connector-http-path.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=c68fa0868bed7dbd56c46f3be3bbc4b3" alt="Boîte de dialogue Connecter Databricks étape 1 sur 2 demandant le chemin HTTP de l'entrepôt SQL" width="3436" height="1978" data-path="images/connectors/databricks/connector-http-path.png" />
    </Frame>
  </Step>

  <Step title="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.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/connector-server-hostname.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=0b8210206a0941725aa1eb71a2b1d99e" alt="Boîte de dialogue Connecter Databricks étape 2 sur 2 demandant le nom d'hôte du serveur de l'entrepôt SQL" width="3436" height="1978" data-path="images/connectors/databricks/connector-server-hostname.png" />
    </Frame>
  </Step>

  <Step title="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.
  </Step>

  <Step title="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**.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/integrations-page.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=f2bb0eac84b4d08e7d7213f5aa5e1a9f" alt="Page Intégrations Replit affichant le connecteur Databricks (Principal de service) avec un statut de connexion Actif" width="1680" height="1199" data-path="images/connectors/databricks/integrations-page.png" />
    </Frame>
  </Step>
</Steps>

## Étape 4 : Créer avec Agent

Après la connexion, les créateurs peuvent créer des applications utilisant des données Databricks avec Agent.

<Steps>
  <Step title="Démarrer un projet">
    Depuis votre page d'accueil Replit, ouvrez la boîte d'invite pour démarrer un nouveau projet.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/home-default.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=36baeac209507cbe0cb8a0f5a14a7c5d" alt="Page d'accueil Replit avec la boîte d'invite et le menu déroulant Modèles" width="1680" height="1199" data-path="images/connectors/databricks/home-default.png" />
    </Frame>
  </Step>

  <Step title="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.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/templates-dropdown.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=707bf8f7247ef849e1064d33dfa09d3a" alt="Menu déroulant Modèles ouvert affichant le modèle Databricks App sous Modèles d'organisation" width="1680" height="1199" data-path="images/connectors/databricks/templates-dropdown.png" />
    </Frame>

    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](https://www.databricks.com/devhub/templates).

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/agent-prompt-filled.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=edc9c3d4e326a265ce3a20dfd5d2bc00" alt="Boîte d'invite avec le modèle Databricks App sélectionné et les instructions préremplies" width="1680" height="1199" data-path="images/connectors/databricks/agent-prompt-filled.png" />
    </Frame>
  </Step>

  <Step title="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.
  </Step>
</Steps>

## Résolution des problèmes

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

## Documentation associée

* [Vue d'ensemble des connecteurs d'entrepôt](/fr/connectors/warehouses/overview) : tous les connecteurs d'entrepôt pris en charge.
* [Connecter Snowflake](/fr/connectors/warehouses/snowflake) : configuration Snowflake étape par étape.
* [Gestion de vos connecteurs](/fr/replitai/managing-connectors) : gestion et configuration des connecteurs.
* [Principaux de service Databricks](https://docs.databricks.com/en/admin/users-groups/service-principals.html) : documentation Databricks sur les principaux de service.
* [Entrepôts SQL Databricks](https://docs.databricks.com/en/compute/sql-warehouse/index.html) : documentation Databricks sur le calcul des entrepôts SQL.
