Aller au contenu principal
Dernière mise à jour le

Configurer le module complémentaire Databricks Excel

info

Aperçu

Cette fonctionnalité est en aperçu public.

L’extension Databricks pour Excel connecte votre workspace Databricks à Microsoft Excel, en intégrant directement les données gouvernées du Lakehouse dans vos feuilles de calcul. L’extension est entièrement prise en charge dans les versions Web et de bureau d’Excel pour Windows et macOS.

Cette page décrit les deux méthodes disponibles pour configurer le complément Databricks Excel dans Microsoft Excel. Ce module complémentaire utilise l'authentification Single Sign On (SSO) pour se connecter à votre Workspace Databricks et prend en charge Unity Catalog pour la gouvernance des données et le contrôle d'accès.

Prérequis​

Avant d'installer le complément Excel, vérifiez que vous disposez des éléments suivants :

  • Accès à un workspace Databricks avec Unity Catalog activé.

  • Un administrateur Workspace doit activer la prévisualisation du connecteur Excel . Voir Gérer les aperçus Databricks.

  • Votre URL du workspace Databricks pour chaque workspace auquel Excel doit se connecter. Les URL de compte personnalisées ne sont pas prises en charge.

  • Vous avez accès à Databricks SQL et au moins l'autorisation PEUT UTILISER sur un SQL Warehouse.

  • Autorisations de lire les données des tables Unity Catalog dans votre workspace.

  • L'une des versions suivantes d'Excel :

    • Excel 2019 ou version ultérieure sur Mac
    • Excel sur Windows (Microsoft 365)
    • Excel sur le web
    • Excel sur Mac (Microsoft 365)

  • Si vous utilisez un pare-feu ou une plateforme de sécurité cloud, mettez en liste verte les URL de Workspace Databricks incluses dans le fichier de complément.

  • Si votre tenant Microsoft Entra bloque le consentement des utilisateurs pour les applications tierces, un administrateur Microsoft Entra doit accorder le consentement d'administrateur à l'application d'entreprise Single Sign On Databricks avant que les utilisateurs ne puissent se connecter. Voir le message « Need admin approval » lors de la connexion.

Configurer le fichier de complément​

remarque

Si vous êtes un administrateur qui déployez le complément via le Microsoft Marketplace, ignorez cette section. Le déploiement du marketplace utilise PowerShell pour configurer l’accès au workspace au lieu du fichier add-in. Voir Déployer via Microsoft Marketplace.

Le fichier de complément est un petit fichier de connexion qui indique à Excel comment se connecter en toute sécurité à Databricks. Il agit comme le lien numérique qui garantit que le module complémentaire se charge correctement et reste à jour chaque fois que vous ouvrez Excel.

download et configurez le fichier de module complémentaire pour utiliser le module complémentaire Excel Databricks. Un seul fichier de module complémentaire peut se connecter à plusieurs Workspace Databricks.

  1. Download le fichier de complément Databricks Excel :

Download le fichier de complément Excel

  1. Modifiez le fichier de complément en spécifiant l'URL de votre workspace comme un <AppDomain> dans la section AppDomains. L'URL de votre workspace est l'URL de base que vous utilisez pour accéder à votre workspace Databricks dans un navigateur. Pour basculer entre plusieurs workspaces Databricks, ajoutez chaque URL de workspace au fichier de complément.

    XML
    <AppDomains>
       
       <AppDomain>https://www.databricks.com</AppDomain>
       <AppDomain>https://login.databricks.com</AppDomain>
       
       
       <AppDomain>https://<workspace1-id>.cloud.databricks.com</AppDomain>
       <AppDomain>https://<workspace2-id>.cloud.databricks.com</AppDomain>
    </AppDomains>
remarque

Collez l’URL de votre Workspace en texte brut, sans mise en forme. Dans la plupart des éditeurs de texte, utilisez Ctrl+Shift+V (Windows) ou Command+Shift+V (macOS).

  1. Enregistrez vos modifications. Vérifiez que le fichier est correctement formaté en tant que fichier .xml.

Option 1 : Déployer depuis le centre d'administration Microsoft 365​

En tant qu'administrateur global, vous pouvez déployer le complément Databricks Excel aux utilisateurs de votre organisation. Vous pouvez déployer le module complémentaire en tant qu'application personnalisée à l'aide du fichier de module complémentaire ou l'installer depuis la Microsoft marketplace.

Pour installer l'add-in Databricks Excel en tant qu'administrateur Microsoft 365, vous devez disposer de l'autorisation global admin. En tant qu'administrateur, vous pouvez déterminer quels utilisateurs de votre organisation peuvent utiliser les add-ins. Pour en savoir plus sur les administrateurs globaux de Microsoft 365, consultez la documentation Microsoft.

Accédez au centre d'administration Microsoft 365 ici.

remarque

Databricks recommande de déployer le complément Databricks Excel en tant qu'application personnalisée.

Déployez le complément à l'aide d'un fichier manifeste personnalisé. Download et configurez le fichier de complément fourni dans les Prérequis.

  1. Dans le centre d'administration Microsoft 365, accédez à Paramètres > Applications intégrées et cliquez sur le Link Compléments .
  2. Cliquez sur Déployer le complément et cliquez sur Suivant .
  3. Cliquez sur **Upload d'applications personnalisées** comme option pour déployer un nouveau module complémentaire.
  4. Sélectionnez l'option d'upload d'un manifeste. Cliquez sur **Choisir un fichier** et upload le fichier de complément.
  5. Choisissez les utilisateurs qui devraient avoir accès à l'extension.
  6. Cliquez sur Déployer .

Pour des étapes détaillées sur l’upload du complément Microsoft Excel de Databricks, consultez la documentation Microsoft.

remarque

En tant qu'administrateur, partagez le nom de compte associé aux Workspace que vous avez mis sur liste blanche avec les utilisateurs qui prévoient d'utiliser le complément Databricks Excel. Voir Se connecter au module complémentaire.

Option 2 : déployer en tant qu'utilisateur individuel​

Les étapes d'installation varient en fonction de votre plateforme Excel. Download et configurez le fichier de complément fourni dans les Prérequis.

Pour installer et vous connecter au module complémentaire Excel dans Excel pour le web, procédez comme suit :

  1. Ouvrez Excel pour le web et créez ou ouvrez un classeur.
  2. Sous l'tab Accueil, cliquez sur **Compléments** >**Avancé**.
  3. Cliquez sur Upload My Add-in .
  4. Upload le fichier de complément.
  5. Click upload .
  6. Recherchez et cliquez sur le complément Databricks dans le menu Compléments .
  7. Connectez-vous à votre compte Databricks. S'il y a une erreur, assurez-vous d'activer les fenêtres contextuelles.
  8. Si vous avez configuré plusieurs URL de workspace, sélectionnez le nom de compte Databricks souhaité. Vous n'avez besoin de sélectionner un workspace spécifique que si les URL se trouvent dans le même compte. Pour plus d'informations sur les noms de compte, consultez Localiser votre ID de compte.

Se connecter au module complémentaire​

Si un administrateur de votre organisation a déployé le complément Databricks Excel, connectez-vous à votre Workspace Databricks depuis Excel.

  1. Dans Excel, sous l'onglet Accueil, cliquez sur le complément Databricks.

  2. Lors de votre première Connexion, connectez-vous à un workspace en utilisant l'une des options suivantes :

    • Saisissez une URL de workspace (recommandé) : Saisissez l’ URL de votre workspace Databricks. Cette option vous connecte via le SSO du workspace.

    • Utilisez le sélecteur de compte : cliquez sur Select account picker pour ouvrir login.databricks.com, puis sélectionnez un compte et un workspace autorisés.

remarque

Le sélecteur de compte n'est pas disponible sur GovCloud. Utilisez une URL de Workspace pour vous connecter.

  1. Cliquez sur Sign in et terminez le processus d'authentification pour accéder au complément Excel Databricks.

Après votre première connexion, le module complémentaire mémorise vos Workspace. Lors des connexions ultérieures, sélectionnez un workspace dans le menu déroulant ou utilisez l’une des options ci-dessus pour vous connecter à un workspace différent.

Si vous utilisez l'authentification Microsoft Entra ID et que le message « Need admin approval » apparaît, un administrateur Microsoft Entra doit approuver l'application d'entreprise Databricks avant que vous ne puissiez vous connecter. Voir le message « Need admin approval » lors de la Connexion.

Modifier le workspace Databricks​

Si votre fichier de complément spécifie plusieurs espaces de travail Databricks, vous pouvez basculer entre ces espaces de travail. Pour plus d’informations, consultez Configurer le fichier de complément.

Pour vous connecter à un autre Workspace Databricks, procédez comme suit :

  1. Dans le coin supérieur droit du volet du module complémentaire Databricks, cliquez sur le menu à trois points à côté du sélecteur de compute.
  2. Cliquez sur Changer de workspace .
  3. Sélectionnez le compte dans lequel se trouve votre Workspace, le Workspace si vous y êtes invité, et connectez-vous.

Dépannage​

Message « Authentification en cours » lors de la Connexion​

Si vous voyez une fenêtre « Authentification en cours » lorsque vous tentez de vous connecter à Databricks depuis le complément, votre workspace n'a peut-être pas été correctement ajouté au fichier de complément personnalisé. Vérifiez que vous avez correctement configuré votre workspace sous <AppDomains>.

Message « Approbation de l'administrateur requise » lors de la Connexion​

Le message « Demande d'approbation d'administrateur » suivant s'affiche lorsque vous vous connectez à votre workspace Databricks à partir du complément Excel, car le tenant Microsoft Entra bloque le consentement de l'utilisateur pour l'application Databricks. Si le consentement de l'administrateur n'est pas accordé, Microsoft Entra ID continue de bloquer le flux de connexion même si vous avez un accès direct au Workspace.

remarque

Ce problème affecte l'application de bureau Excel de la version de juin 2026.

Nécessite un message d&#39;approbation de l&#39;administrateur dans le complément Excel.

Pour résoudre ce problème, un utilisateur Microsoft Entra disposant des rôles d'administrateur appropriés doit accorder le consentement d'administrateur à l'échelle du tenant à l'application d'entreprise Databricks.

Demandez à l'administrateur Microsoft Entra de visiter le Link suivant. Remplacez {TENANT_ID} par votre ID de tenant Microsoft Entra :

Text
https://login.microsoftonline.com/{TENANT_ID}/adminconsent?client_id=aaec40b0-c0ae-4211-a98b-6fc160abb71b

Si le Link échoue, l’administrateur peut accorder le consentement manuellement :

  1. Dans le centre d'administration Microsoft Entra, accédez à Entra ID > Applications d'entreprise > Toutes les applications et recherchez l'application d'entreprise Databricks utilisée pour le Single Sign On. Pour identifier l'application, recherchez l'ID de l'application aaec40b0-c0ae-4211-a98b-6fc160abb71b.
  2. Accorder le consentement de l'administrateur pour les autorisations demandées par l'application d'entreprise Databricks :
    1. Sous Sécurité , cliquez sur Autorisations .
    2. Cliquez sur Accorder le consentement administrateur .

Pour des instructions détaillées, consultez la documentation Microsoft.

Erreur de module complémentaire​

Vous pouvez voir l'erreur suivante lors de l'authentification à votre Workspace :

Text
ADD-IN ERROR

This add-in could not be started. Close this dialog to ignore the problem or click "Restart" to try again.

Si cliquer sur Redémarrer ne fonctionne pas, essayez ce qui suit :

  1. Cliquez avec le bouton droit dans la fenêtre d’authentification, puis cliquez sur **Inspecter**.
  2. Fermez la fenêtre DevTools .
  3. Faites un clic droit dans la fenêtre d'authentification et cliquez sur refresh .

Le volet du complément Databricks Excel devrait se charger.

Solution de contournement Inspecter et refresh pour l&#39;erreur de Startup du complément Excel.

Impossible d'utiliser les ressources​

Si vous ne parvenez pas à utiliser les ressources Databricks, telles que les SQL warehouses, dans le complément Databricks, essayez l'une des méthodes suivantes en fonction de la version d'Excel que vous utilisez :

  • Excel pour le web : Redémarrez la feuille ou modifiez les Workspace et reconnectez-vous au même Workspace. Consultez Modifier le Workspace Databricks.
  • Excel Desktop : rechargez le module complémentaire en cliquant sur l’icône d’informations dans le coin supérieur droit et en sélectionnant Recharger.

Étapes suivantes​

Sur cette page