Importer et query des données à l’aide du complément Excel Databricks
Aperçu
Cette fonctionnalité est en aperçu public.
Le complément Databricks Excel connecte votre workspace Databricks à Microsoft Excel, en intégrant des données Lakehouse régies directement dans vos feuilles de calcul pour vous aider à passer plus rapidement des données aux décisions.
Cette page décrit comment utiliser le complément Databricks Excel pour importer et analyser des données de Databricks dans Excel. Vous pouvez parcourir et importer des tables Databricks via une interface intuitive sans aucune connaissance SQL requise. Bien que le module complémentaire offre la flexibilité d'exécuter des queries SQL personnalisées, il est facultatif.
Prérequis
- Avant d'utiliser le module complémentaire Excel, veuillez vérifier qu'il est configuré.
- Vous avez accès à Databricks SQL et au moins l'autorisation PEUT UTILISER sur un SQL Warehouse.
Sélectionner un SQL Warehouse
Choisissez quel SQL Warehouse utiliser :
- Dans le coin supérieur droit du volet du complément Databricks dans Excel, cliquez sur le menu déroulant.
- Sélectionnez le SQL warehouse que vous souhaitez utiliser.
Importez des données de Databricks
Importez des données de Databricks dans Excel en sélectionnant une table, en écrivant une query SQL ou en important un tableau croisé dynamique.
Vous pouvez importer des vues de métriques Unity Catalog à l'aide de tableaux croisés dynamiques, de requêtes SQL et de fonctions personnalisées.
Créer des tableaux croisés dynamiques
Pour créer un tableau croisé dynamique à partir de tables et de vues Unity Catalog dans Excel :
-
Dans le volet du complément Databricks Excel, sous l'onglet **New import** tab, sélectionnez **Sélectionner les données** comme **Méthode d’importation**.
-
Sous Catalogue , sélectionnez la table à partir de laquelle vous souhaitez créer un tableau croisé dynamique et cliquez sur Sélectionner .
-
Cochez la case Pivot Data .
-
Configurez Ligne , Colonne et Valeur en faisant glisser chaque champ vers la zone appropriée.
-
(Facultatif) Ajoutez un filtre . Pour plus d'informations sur les filtres, consultez Filtrer les données importées.
-
(Facultatif) Pour voir un échantillon de l'importation, cliquez sur Prévisualiser .
-
(Facultatif) Définissez une limite de lignes pour votre importation.
-
Importez vos résultats. Choisissez l'une des options suivantes :
- Cliquez sur Enregistrer et importer pour enregistrer la query en vue de sa réutilisation dans le classeur Excel et importer les résultats.
- Cliquez sur la flèche vers le bas, puis cliquez sur **Importer les résultats** pour importer les résultats sans enregistrer la requête. Utilisez cette option lorsque vous souhaitez continuer à modifier une importation.
Les tables croisées dynamiques peuvent uniquement être importées dans une nouvelle feuille.
Lorsque vous travaillez avec des métriques Unity Catalog dans des tableaux croisés dynamiques, vous pourriez voir Sum(measure) affiché dans les résultats. Ceci est le comportement attendu et aucune agrégation supplémentaire n'a lieu. Excel exige que les valeurs aient une fonction d'agrégation, mais étant donné que les données contiennent des valeurs uniques, aucune agrégation n'a lieu.
Sélectionner les tables
Les données sont importées en tant qu'objet de table Excel. Vous pouvez déplacer la table ou renommer la feuille, et le complément Excel refresh les données au nouvel emplacement.
Pour importer des données depuis une table Databricks, procédez comme suit :
- Dans le volet du complément Databricks Excel, sous l'onglet **New import** tab, sélectionnez **Sélectionner les données** comme **Méthode d’importation**.
- Choisissez une table à importer depuis l’explorateur de catalogues. Vous pouvez filtrer le catalogue par propriétaire, statut de certification et autres propriétés à l’aide du filtre
. - Cliquez sur Sélectionner .
- Sous Columns , cliquez sur la flèche vers le bas et désélectionnez les colonnes que vous ne souhaitez pas importer, ou laissez toutes les colonnes sélectionnées pour importer la table entière.
- (Facultatif) Ajoutez un filtre . Pour plus d'informations sur les filtres, consultez Filtrer les données importées.
- (Facultatif) Pour voir un échantillon de l'importation, cliquez sur Prévisualiser .
- (Facultatif) Définissez une limite de lignes pour restreindre le nombre de lignes importées.
- (Facultatif) Pour identifier vos données importées, saisissez un nom d'importation .
- Sous Destination de la sortie , choisissez d’importer les données vers une nouvelle feuille ou la feuille actuelle. Si vous importez vers la feuille actuelle, les données commencent à la référence de cellule que vous saisissez (by default A1).
- Importez vos résultats. Choisissez l'une des options suivantes :
- Cliquez sur Enregistrer et importer pour enregistrer la query en vue de sa réutilisation dans le classeur Excel et importer les résultats.
- Cliquez sur la flèche vers le bas, puis cliquez sur **Importer les résultats** pour importer les résultats sans enregistrer la requête. Utilisez cette option lorsque vous souhaitez continuer à modifier une importation.
Écrire des requêtes SQL
La méthode d'importation Write SQL prend en charge les fonctions SQL et les procédures stockées.
Pour exécuter des requêtes SQL personnalisées sur votre Workspace Databricks, procédez comme suit :
-
Dans le volet du complément Databricks Excel, sous le **tab Nouvelle importation**, sélectionnez **Écrire du SQL** comme **Méthode d’importation**.
-
Saisissez un nom pour votre query afin de l'identifier ultérieurement.
-
Écrivez une nouvelle query ou utilisez une query existante depuis votre Workspace Databricks.
-
Écrivez votre query SQL dans l'éditeur. Vous pouvez query n'importe quelle table dans Unity Catalog à laquelle vous avez des autorisations d'accès.
- Cliquez sur
l'explorateur de catalogue pour afficher vos schémas et tables.
- Cliquez sur
-
Pour utiliser une query depuis votre workspace Databricks ou une query existante dans Excel, cliquez sur le dossier
. Si vous utilisez une query existante de votre Workspace Databricks, les modifications apportées dans Excel ne sont pas reflétées sur Databricks.
-
Les queries doivent être explicitement enregistrées dans Databricks à l'aide du bouton Enregistrer dans le coin supérieur droit de l'éditeur de queries avant d'apparaître dans Excel.
-
(Facultatif) Pour ajouter des paramètres de requête, cliquez sur +Ajouter à côté de Paramètres . Cliquez sur le paramètre et saisissez le Nom du paramètre et la Valeur du paramètre .
- Pour la valeur du paramètre, vous pouvez soit entrer une valeur spécifique, soit cliquer sur le bouton de la case et de la flèche pour spécifier une référence de cellule. Sélectionnez une cellule ou une plage de cellules et cliquez sur la flèche pour remplir automatiquement la valeur du parameter.
-
Sous Destination de la sortie , choisissez d’importer les données vers une nouvelle feuille ou la feuille actuelle. Si vous importez vers la feuille actuelle, les données commencent à la référence de cellule que vous saisissez (by default A1).
-
Pour prévisualiser vos résultats de query, cliquez sur Exécuter .
-
Importez vos résultats. Choisissez l'une des options suivantes :
- Cliquez sur Enregistrer et importer pour enregistrer la query en vue de sa réutilisation dans le classeur Excel et importer les résultats.
- Cliquez sur la flèche vers le bas, puis cliquez sur **Importer les résultats** pour importer les résultats sans enregistrer la requête. Utilisez cette option lorsque vous souhaitez continuer à modifier une importation.
Vous pouvez également utiliser des fonctions personnalisées pour ajouter des paramètres de query. Voir Écrire du SQL.
Filtrer les données importées
Lorsque vous importez des données en sélectionnant un tableau ou en créant un tableau croisé dynamique, vous pouvez appliquer des filtres pour affiner les résultats.
Pour définir des filtres, cliquez sur + à côté de Filtres , sélectionnez la colonne à laquelle vous souhaitez appliquer un filtre, puis saisissez votre condition de filtre. Pour les filtres qui nécessitent une valeur, vous pouvez effectuer l'une des opérations suivantes :
-
Saisissez la valeur.
-
Pour générer une liste de jusqu'à 1 000 valeurs de filtre distinctes, vous pouvez utiliser :
- Cliquez sur Valeurs , puis sur Obtenir les valeurs de filtre .
- Cliquez sur la flèche vers le bas et sélectionnez une ou plusieurs valeurs dans la liste.
-
Pour utiliser une référence de cellule :
- Cliquez sur Cellules .
- Sélectionnez une cellule ou une plage de cellules.
- Cliquez sur le curseur
.
Le tableau suivant décrit chaque filtre disponible et son entrée attendue.
Filtrer | Entrée attendue | Description |
|---|---|---|
| Aucun | Trouve les lignes où la valeur de la colonne est nulle. |
| Aucun | Trouve les lignes où la valeur de la colonne n'est pas nulle. |
| Un nombre ou une chaîne de texte. | Trouve les lignes où la valeur de la colonne correspond exactement à la valeur spécifiée. |
| Un nombre ou une chaîne de texte. | Trouve les lignes où la valeur de la colonne ne correspond pas à la valeur spécifiée. |
| Un ou plusieurs numéros ou chaînes de texte, séparés par des virgules | Recherche les lignes où la valeur de la colonne correspond à l'une des valeurs spécifiées. |
| Un ou plusieurs numéros ou chaînes de texte, séparés par des virgules | Trouve les lignes où la valeur de la colonne ne correspond à aucune des valeurs spécifiées. |
| Un modèle utilisant
| Recherche les lignes où la valeur de colonne correspond au modèle. Sensible à la casse. |
| Un modèle utilisant
| Trouve les lignes où la valeur de la colonne ne correspond pas au modèle. Sensible à la casse. |
| Un modèle utilisant
| Recherche les lignes où la valeur de colonne correspond au modèle. Non sensible à la casse. |
| Une chaîne de texte | Recherche les lignes où la valeur de la colonne commence par le texte spécifié. |
| Une chaîne de texte | Trouve les lignes où la valeur de la colonne se termine par le texte spécifié. |
| Une chaîne de texte | Recherche les lignes où la valeur de la colonne contient le texte spécifié n'importe où dans la chaîne. |
Utilisez les fonctions personnalisées Databricks dans Excel.
Le complément Excel fournit des fonctions personnalisées que vous pouvez utiliser dans les formules Excel pour importer des données depuis Databricks.
Sélectionnez une table
La fonction DATABRICKS.Table importe les données d'une table Unity Catalog.
Syntaxe :
=DATABRICKS.Table(catalog_name.schema_name.table_name, [column1, ...], [limit])
Paramètres :
catalog_name.schema_name.table_name(obligatoire) : le nom de table entièrement qualifié.columns(facultatif) : Un tableau de noms de colonnes à importer. Omettez ce parameter pour importer toutes les colonnes.limit(facultatif) : Le nombre maximal de lignes à importer. Omettez ce parameter pour importer toutes les lignes, jusqu'à la limite de 10 Mo.
Exemple :
=DATABRICKS.Table("main.default.customers", {"customer_id", "customer_name"}, 100)
Cette formule importe les colonnes customer_id et customer_name de la table main.default.customers, limitée à 100 lignes.
Écrire du SQL
La fonction DATABRICKS.SQL exécute une query SQL qui utilise des query parameters et renvoie les résultats.
Syntaxe :
Spécifiez les paramètres à l'aide de valeurs.
=DATABRICKS.SQL("query_text", {parameter1_name, parameter1_value; ...})
Spécifiez les paramètres à l’aide d’une plage de cellules. Définissez les parameters de nom et de valeur dans les cellules situées sur la même ligne.
=DATABRICKS.SQL("query_text", {param_name_cell: param_value_cell; ...})
Paramètres :
query_text(requis) : query SQL à exécuter.parameters(obligatoire) : une correspondance des valeurs de paramètre à substituer dans la requête.
Exemple :
=DATABRICKS.SQL("SELECT * FROM samples.bakehouse.sales_suppliers WHERE longitude > :long_param AND latitude > :lat_param LIMIT 10", {"long_param",20; "lat_param",10})
=DATABRICKS.SQL("SELECT * FROM samples.bakehouse.sales_suppliers WHERE city = :city", M4:N4)
Cette formule exécute une requête qui filtre les données de ventes par longitude et latitude, en utilisant les valeurs de paramètre fournies.
Gérer les queries
Gérez vos importations existantes depuis la page Importations.
Modifier une importation existante.
Pour modifier une importation existante :
- Dans le volet de l'extension Databricks dans Excel, cliquez sur l'onglet tab .
- Trouvez l'importation que vous souhaitez modifier.
- Cliquez sur le menu à trois points à côté de l'importation.
- Cliquez sur Modifier pour modifier votre importation.
refresh data
L'Add-in Excel ne refresh pas les données automatiquement. La façon dont vous refresh les données dépend de la manière dont vous les avez importées. Les données importées à l'aide d'une méthode d'importation (sélectionner une table, écrire une query SQL ou créer un tableau croisé dynamique) sont refresh depuis l'onglet Imports . Les données importées à l'aide d'une fonction personnalisée doivent être recalculées.
Mettez à jour les imports avec les dernières valeurs de Databricks. Le complément exécute à nouveau la query d'origine ou la sélection de table et met à jour votre feuille de calcul avec des données récentes :
-
Pour refresh une seule importation :
- Dans le volet de l'extension Databricks dans Excel, cliquez sur l'onglet tab .
- Cliquez sur
refresh à côté de l'importation que vous souhaitez actualiser.
-
Pour refresh toutes les importations :
- Cliquez sur Refresh All dans le volet du complément Databricks.
Lors de l'actualisation des données, le complément Excel efface toutes les données existantes dans la table spécifiée et recharge les données les plus récentes de Databricks. Toutes les colonnes personnalisées que vous avez ajoutées à la table sont supprimées pendant le processus de refresh.
Les données importées de fonctions personnalisées, telles que DATABRICKS.Table et DATABRICKS.SQL, ne se refresh pas lorsque vous rouvrez un classeur. Pour refresh les données importées de fonctions personnalisées, connectez-vous au complément Databricks, puis recalculez le classeur ou modifiez une valeur à laquelle la fonction personnalisée fait référence.
Implications de partage
Lorsque vous partagez un classeur Excel qui contient des données Databricks, prenez en compte les implications suivantes en matière d'accès aux données et de sécurité :
Visibilité sur les données importées
Lorsqu'un destinataire refresh une importation, le complément utilise les autorisations Unity Catalog du destinataire. S'ils n'ont pas accès aux données sous-jacentes, le refresh échoue.
Pour les classeurs où la confidentialité des données est une préoccupation, vous pouvez utiliser la solution de contournement suivante :
- Créer un classeur avec toutes les formules et importations nécessaires.
- Supprimez les données importées de la feuille.
- Partagez le classeur avec le destinataire.
- Demandez au destinataire de refresh les données.
Le destinataire ne voit que les données auxquelles il a accès en fonction de ses autorisations Unity Catalog.
Accès aux Workspace et aux assets de données
- Les utilisateurs sans accès aux objets Unity Catalog référencés dans le classeur ne peuvent pas refresh les données. Pour refresh les données, les utilisateurs doivent disposer d’autorisations de lecture sur les tables et vues sous-jacentes dans Unity Catalog.
- Les utilisateurs doivent avoir accès à la table sous-jacente dans Databricks pour modifier les importations existantes.
Visibilité de la query
Les utilisateurs ayant un accès en modification au workbook peuvent consulter les queries utilisées pour générer les données via le Databricks Add-in, même s'ils n'ont pas accès aux données sous-jacentes dans Unity Catalog.
Alternative pour enregistrer en tant que template
Le complément Excel Databricks ne prend pas en charge l'enregistrement d'un classeur en tant que Template, mais vous pouvez partager un classeur afin que d'autres utilisateurs puissent voir les queries importées. Consultez les Implications du partage pour l'accès aux données et les considérations de sécurité.
En guise de solution de contournement pour partager un classeur en tant que template, veuillez effectuer l'une des opérations suivantes :
- Partagez le fichier local avec un autre utilisateur. Le destinataire peut renommer le fichier et voir les requêtes enregistrées.
- Sur SharePoint, partagez le classeur avec un autre utilisateur. Lorsqu'un autre utilisateur download le fichier, les importations enregistrées sont conservées.
Limitations
- Fonctions personnalisées : Pour les fonctions personnalisées, les résultats de requête sont limités à 25 MiB en raison des limitations de l'API d'exécution SQL.
- Chargement des données : Le chargement des données peut échouer si une cellule du classeur est en mode édition.
- Limite de lignes d'Excel Desktop : Excel Desktop prend en charge un maximum de 1 048 576 lignes par feuille.
- Limite de taille de fichier Excel pour le web : Excel pour le web prend en charge une taille de fichier de classeur maximale d'environ 25 Mo pour l'affichage et la modification.