Configurer le complément Azure Databricks Excel

Important

Cette fonctionnalité est disponible en préversion publique.

Note

Le complément Azure Databricks Excel n’est pas disponible dans les régions Azure Government ou Azure Chine.

Le module complémentaire Azure Databricks Excel relie votre espace de travail Azure Databricks à Microsoft Excel, intégrant directement les données gouvernées de Lakehouse dans vos tableurs. Le complément est entièrement pris en charge dans les versions de Excel pour le web et de bureau pour Windows et macOS.

Cette page décrit les deux méthodes disponibles pour configurer le complément Azure Databricks Excel dans Microsoft Excel. Ce complément utilise l’authentification unique (SSO) pour vous connecter à votre espace de travail Azure Databricks et prend en charge Unity Catalog pour la gouvernance des données et le contrôle d’accès.

Conditions préalables

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

  • Accès à un espace de travail Azure Databricks avec Unity Catalog activé.
  • Un administrateur d’espace de travail doit activer la préversion Excel Connector. Consultez Gérer les préversions d’Azure Databricks.
  • Votre URL Azure Databricks workspace pour chaque espace de travail auquel Excel doit se connecter.
  • Vous avez l’accès à Azure Databricks SQL et au moins l’autorisation CAN USE sur un entrepôt SQL.
  • Autorisations de lecture des données à partir de tables de catalogue Unity dans votre espace de travail.
  • Une des versions suivantes de 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, ajoutez à la liste d’autorisation les URL de l’espace de travail Azure Databricks incluses dans le fichier du complément.
  • Si votre tenant Microsoft Entra bloque le consentement des utilisateurs pour les applications tierces, un administrateur Microsoft Entra doit accorder le consentement administrateur à l’application d’entreprise d’authentification unique Azure Databricks avant que les utilisateurs ne puissent se connecter avec le sélecteur de comptes. Cela n’est pas obligatoire si les utilisateurs se connectent en entrant directement une URL d’espace de travail. Consultez le message « Besoin d’approbation d’administrateur » lors de la connexion.

Configurer le fichier de complément

Note

Si vous êtes administrateur qui déploie le complément via la Place de marché Microsoft, ignorez cette section. Le déploiement du marketplace utilise PowerShell pour configurer l’accès à l’espace de travail au lieu du fichier de module complémentaire. Consultez Deploy through Microsoft Marketplace.

Le fichier de complément est un petit fichier de connecteur qui indique Excel comment se connecter en toute sécurité à Azure Databricks. Il agit comme la poignée de main numérique qui garantit que le complément se charge correctement et reste à jour chaque fois que vous ouvrez Excel.

Téléchargez et configurez le fichier de complément pour utiliser le complément Azure Databricks Excel. Un seul fichier complémentaire peut se connecter à plusieurs espaces de travail Azure Databricks.

  1. Téléchargez le fichier Azure Databricks complément Excel :

    Télécharger le fichier complément Excel

  2. Modifiez le fichier de complément en définissant l’URL de votre espace de travail dans la section <AppDomain>AppDomains. L’URL de votre espace de travail est l’URL de base que vous utilisez pour accéder à votre espace de travail Azure Databricks dans un navigateur. Pour basculer entre plusieurs espaces de travail Azure Databricks, ajoutez chaque URL d’espace de travail au fichier de complément.

    Pour vous connecter avec une URL personnalisée, ajoutez à la fois l’URL personnalisée et l’URL de l’espace de travail associée comme entrées séparées <AppDomain> , comme montré dans les exemples suivants. La connexion peut rediriger vers l’une ou l’autre URL.

    <AppDomains>
   <!-- DO NOT CHANGE -->
   <AppDomain>https://www.databricks.com</AppDomain>
   <AppDomain>https://login.databricks.com</AppDomain>
   <!-- ADD WORKSPACE URLS AS SHOWN BELOW; PUT EACH WORKSPACE URL IN ITS OWN <AppDomain> TAG  -->
   <!-- EXAMPLE -->
   // highlight-next-line
   <AppDomain>https://adb-<workspace1-id>.<random-number>.azuredatabricks.net</AppDomain>
   // highlight-next-line
   <AppDomain>https://adb-<workspace2-id>.<random-number>.azuredatabricks.net</AppDomain>
   <!-- TO USE A CUSTOM URL, ADD BOTH THE CUSTOM URL AND ITS ASSOCIATED WORKSPACE URL -->
   // highlight-next-line
   <AppDomain>https://<custom-url>.azuredatabricks.net</AppDomain>
</AppDomains>

    Note

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

  3. Enregistrez vos modifications. Vérifiez que le fichier est correctement mis en forme en tant que .xml fichier.

Option 1 : Déploiement depuis le centre d’administration Microsoft 365 admin center

En tant qu’administrateur général, vous pouvez déployer le complément Azure Databricks Excel aux utilisateurs de votre organisation. Vous pouvez déployer le complément en tant qu’application personnalisée à l’aide du fichier de complément ou l’installer à partir de la Place de marché Microsoft.

Pour installer le complément Azure Databricks Excel en tant que Administration 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 des compléments. Pour plus d’informations sur les administrateurs généraux sur Microsoft 365, consultez la documentation Microsoft.

Accédez au centre d’administration Microsoft 365 admin center ici.

Note

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

Déployer en tant qu’application personnalisée

Déployez le complément à l’aide d’un fichier manifeste personnalisé. Téléchargez et configurez le fichier de complément fourni dans les conditions préalables.

  1. Dans le Microsoft 365 admin center, accédez à Settings > Applications intégrées et cliquez sur le lien Add-ins.
  2. Cliquez sur Déployer un complément , puis cliquez sur Suivant.
  3. Cliquez sur Charger des applications personnalisées comme option pour déployer un nouveau complément.
  4. Sélectionnez l’option permettant de charger un manifeste. Cliquez sur Choisir un fichier et chargez le fichier de complément.
  5. Choisissez les utilisateurs qui doivent avoir accès au complément.
  6. Cliquez sur Déployer.

Pour obtenir des instructions détaillées sur le chargement du complément Azure Databricks Excel, consultez la documentation Microsoft.

Déployer à partir de Microsoft Place de marché

Installez le complément à partir de la Place de marché Microsoft et utilisez PowerShell pour configurer l’accès à l’espace de travail. L'installation du complément seul ne le connecte pas à vos espaces de travail Azure Databricks. Suivez toutes les étapes ci-dessous, y compris l’ajout à la liste verte des URL de votre espace de travail avec PowerShell.

Prerequisites

  • PowerShell est installé sur votre ordinateur.
  • Vous devez exécuter Windows PowerShell en tant qu’administrateur.

Installer le complément

  1. Dans le Microsoft 365 admin center, accédez à Settings > Applications intégrées et cliquez sur le lien Get Apps.
  2. Recherchez « complément Azure Databricks pour Excel ».
  3. Cliquez sur Obtenir maintenant.
  4. Déployez le complément sur vous-même en sélectionnant Juste moi sous Affecter des utilisateurs.
  5. Cliquez sur Déployer.

Pour obtenir des instructions détaillées sur le déploiement du complément Azure Databricks Excel à partir de la Place de marché Microsoft, consultez la documentation Microsoft.

Configurer l’accès à l’espace de travail

Après avoir installé le complément, utilisez PowerShell pour ajouter à la liste d’autorisation les URL de votre espace de travail Azure Databricks.

Note

La connexion PowerShell au Centre d’administration Office 365 peut expirer. Si une commande échoue, rouvrez PowerShell et reconnectez-vous en exécutant Connect-OrganizationAddInService.

  1. Ouvrez PowerShell et exécutez en tant qu’administrateur. Pour plus d’informations, consultez la documentation Microsoft.

  2. Installez et importez le module de déploiement centralisé Office 365 :

    Install-Module -Name O365CentralizedAddInDeployment
Import-Module O365CentralizedAddInDeployment

  3. Connectez-vous et ouvrez une session sur votre locataire Office 365 en tant qu’administrateur.

    Connect-OrganizationAddInService

  4. Vérifiez que le complément a été déployé. Le complément Azure Databricks pour Excel doit apparaître dans la liste.

    Get-OrganizationAddIn

    Si le complément n’apparaît pas, il peut être nécessaire de le redéployer ou il est peut-être encore en cours de déploiement.

  5. Liste d'autorisation des URL d'espace de travail Azure Databricks. Remplacez chacune <workspace-url> par l’URL d’un espace de travail que vous souhaitez autoriser. Vous pouvez inclure autant d’URL d’espace de travail que nécessaire. Pour prendre en charge une URL personnalisée, incluez à la fois l’URL personnalisée et l’URL de l’espace de travail associée.

    Set-OrganizationAddInOverrides -ProductId d75dbea5-bf93-49b8-9a49-bdf4e9d6f052 `
  -AppDomains "https://adb-<workspace1-id>.<random-number>.azuredatabricks.net", "https://adb-<workspace2-id>.<random-number>.azuredatabricks.net", "https://<custom-url>.azuredatabricks.net"

    L’ID de produit pour Azure Databricks est d75dbea5-bf93-49b8-9a49-bdf4e9d6f052.

  6. Confirmez que l’ajout à la liste d’autorisation est correct. Les URL d’espace de travail que vous avez autorisées doivent apparaître dans la AppDomains section.

    Get-OrganizationAddInOverrides -ProductId d75dbea5-bf93-49b8-9a49-bdf4e9d6f052

Tester le module complémentaire

  1. Dans Excel, recherchez le complément Azure Databricks.
  2. Connectez-vous et accédez à l’un des espaces de travail que vous avez ajoutés à la liste d’autorisation.

Note

La synchronisation des modifications de la liste d'autorisation peut prendre quelques minutes. Si l’authentification échoue, vérifiez que vous vous connectez à un espace de travail sur la liste d'autorisation. Si l’espace de travail est correct, fermez Excel, attendez quelques minutes, puis réessayez.

Déployer sur votre organisation

  1. Dans le Microsoft 365 admin center, accédez à Settings > Applications intégrées.
  2. Sélectionnez le complément Azure Databricks que vous avez installé et configuré.
  3. Cliquez sur l’onglet Utilisateurs et choisissez s’il faut déployer sur l’ensemble de votre organisation ou sur un groupe spécifique d’utilisateurs.

Note

En tant qu’administrateur, partagez le nom du compte associé aux espaces de travail que vous avez ajoutés à la liste autorisée avec les utilisateurs qui prévoient d’utiliser le complément Azure 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. Téléchargez et configurez le fichier de complément fourni dans les conditions préalables.

Excel pour le web

Pour installer et se connecter au complément Excel Excel pour le web procédez comme suit :

  1. Ouvrez Excel pour le web et créez ou ouvrez un classeur.
  2. Sous l’onglet Accueil, cliquez sur Compléments avancés>.
  3. Cliquez sur Charger mon complément.
  4. Chargez le fichier de complément.
  5. Cliquez sur Télécharger.
  6. Recherchez et cliquez sur le complément Azure Databricks dans le menu Add-ins.
  7. Connectez-vous à votre compte Azure Databricks. En cas d’erreur, veillez à activer les boîtes de dialogue contextuelles.
  8. Si vous avez configuré plusieurs URL d’espace de travail, sélectionnez le nom de compte de Azure Databricks souhaité. Vous devez uniquement sélectionner un espace de travail spécifique 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.

Excel Desktop (Windows)

Pour installer le complément Excel sur Excel Desktop pour Windows, effectuez les opérations suivantes :

  1. Créez un dossier nommé Manifest sur votre lecteur local (par exemple, C:\Manifest).
  2. Copiez le fichier de complément dans le C:\Manifest dossier.
  3. Ouvrez les propriétés du dossier et partagez le dossier :
    1. Cliquez avec le bouton droit sur le Manifest dossier et sélectionnez Propriétés.
    2. Cliquez sur Partager> et ajoutez-vous en tant qu’utilisateur avec des autorisations de lecture et d’écriture.
  4. Ouvrez Excel Desktop.
  5. Configurez Excel pour approuver le dossier manifeste :
    1. Cliquez sur Fichier>Options>Centre de gestion de la confidentialité>Paramètres du Centre de gestion de la confidentialité.
    2. Dans la barre latérale, cliquez sur Catalogues de compléments approuvés.
    3. Dans l’URL du catalogue, entrez le chemin d’accès au dossier partagé où se trouve le fichier de complément (par exemple). \\YourComputerName\Manifest
    4. Cliquez sur Ajouter un catalogue.
    5. Cochez la case Afficher dans le menu .
    6. Cliquez sur OK pour enregistrer vos modifications.
  6. Redémarrez Excel Desktop.
  7. Dans la zone de recherche dans la barre de titre, recherchez « Insérer en tant que complément » et sélectionnez-le dans les résultats.
  8. Sélectionnez le connecteur Azure Databricks, puis cliquez sur Add.
  9. Cliquez sur le complément Azure Databricks et terminez le processus de connexion à votre compte Azure Databricks.
  10. Si vous avez configuré plusieurs URL d’espace de travail, sélectionnez le nom de compte de Azure Databricks souhaité. Vous devez uniquement sélectionner un espace de travail spécifique 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.

Excel Desktop (macOS)

Pour installer le complément Excel dans Excel Desktop pour macOS, procédez comme suit :

  1. Copiez le fichier de complément dans votre dossier Microsoft Compléments Office. Si le wef dossier n’existe pas, créez-le.

    /Users/<your-username>/Library/Containers/com.microsoft.Excel/Data/Documents/wef

  2. Ouvrez ou redémarrez Excel Desktop.

  3. Dans la barre de navigation, cliquez sur Compléments>Mes compléments.

  4. Cliquez sur l'extension Azure Databricks.

  5. Terminez le processus de connexion à votre compte Azure Databricks.

  6. Si vous avez configuré plusieurs URL d’espace de travail, sélectionnez le nom de compte de Azure Databricks souhaité. Vous devez uniquement sélectionner un espace de travail spécifique 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 complément

Si un administrateur de votre organisation a déployé le complément Azure Databricks Excel, connectez-vous et connectez-vous à votre espace de travail Azure Databricks à partir de Excel.

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

  2. La première fois que vous vous connectez, connectez-vous à un espace de travail en utilisant l’une des options suivantes :

    • Saisissez une URL de workspace (recommandée) : Saisissez l’URL de votre workspace Azure Databricks. Cette option vous connecte à l’espace de travail SSO. Pour se connecter avec une URL personnalisée, vérifiez que l’URL personnalisée et l’URL de l’espace de travail associée sont ajoutées au fichier complémentaire. Voir Configurer le fichier complémentaire.
    • Utilisez le sélecteur de compte : Cliquez sur Sélectionner le sélecteur de compte pour ouvrir login.databricks.com, puis sélectionnez un compte et un espace de travail autorisés.

  3. Cliquez sur Se connecter et terminez le processus d’authentification pour accéder au complément Excel Azure Databricks.

Après votre première connexion, l’extension se souvient de vos espaces de travail. Lors des connexions ultérieures, sélectionnez un espace de travail dans le menu déroulant, ou utilisez l’une des options ci-dessus pour vous connecter à un autre espace de travail.

Si vous utilisez l’authentification Microsoft Entra ID et que le message « Besoin d’une approbation administrateur » apparaît, un administrateur Microsoft Entra doit approuver l’application Azure Databricks enterprise avant que vous puissiez vous connecter. Consultez le message « Besoin d’approbation d’administrateur » lors de la connexion.

Modifier l'espace de travail Azure Databricks

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

Pour vous connecter à un autre espace de travail Azure Databricks, procédez comme suit :

  1. En haut à droite du volet de complément Azure Databricks, cliquez sur le menu à trois points en regard du sélecteur de calcul.
  2. Cliquez sur Modifier l’espace de travail.
  3. Sélectionnez le compte auquel est associé votre espace de travail, l'espace de travail si vous y êtes invité, puis connectez-vous.

Résolution des problèmes

Message « Authentification en cours » lors de la connexion

Si vous voyez une fenêtre « Authentification en cours » lorsque vous essayez de vous connecter à Azure Databricks à partir du complément, votre espace de travail n’a peut-être pas été correctement ajouté au fichier de complément personnalisé. Vérifiez que vous avez configuré correctement votre espace de travail sous <AppDomains>.

Message « Besoin d’approbation administrateur » lors de la connexion

Le message suivant « Besoin d’approbation d’administrateur » s’affiche lorsque vous vous connectez à votre espace de travail Azure Databricks à partir de l’complément Excel, car le locataire Microsoft Entra bloque le consentement de l’utilisateur pour l’application Azure Databricks. Cela ne s’applique que lorsque vous vous connectez avec le sélecteur de compte (login.databricks.com) ; pour l’éviter, entrez directement l’URL de votre espace de travail lors de la connexion. Si le consentement de l’administrateur n’est pas accordé, Microsoft Entra ID continue de bloquer le flux de connexion même si vous disposez d’un accès direct à l’espace de travail.

Message de demande d’approbation de l’administrateur pour le complément Excel

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

Demandez à l’administrateur Microsoft Entra de consulter le lien suivant. Remplacez {TENANT_ID} par votre ID de locataire Microsoft Entra :

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

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

  1. Dans le centre d’administration Microsoft Entra, accédez à Entra ID>Enterprise apps>All applications et recherchez l’application d’entreprise Azure Databricks utilisée pour l’authentification unique. Pour identifier l’application, recherchez l’ID d’application aaec40b0-c0ae-4211-a98b-6fc160abb71b.
  2. Accordez le consentement administrateur pour les autorisations demandées par l’application d’entreprise Azure Databricks :
    1. Sous Sécurité, cliquez sur Autorisations.
    2. Cliquez sur Accorder le consentement de l’administrateur.

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

Impossible d’utiliser des ressources

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

  • Excel pour le web : redémarrez la feuille ou modifiez les espaces de travail et reconnectez-vous au même espace de travail. Consultez Changer l'espace de travail Azure Databricks.
  • Excel Desktop : rechargez le complément en cliquant sur l’icône d’informations dans le coin supérieur droit et en sélectionnant Reload.

Étapes suivantes

  • Last updated on