Interroger des données Azure Databricks dans Google Sheets

Le connecteur Databricks pour Google Sheets interroge les données de votre espace de travail Azure Databricks et les importe dans Google Sheets. Vous pouvez sélectionner directement des tables, écrire des requêtes SQL, ajouter des paramètres, créer des tableaux croisés dynamiques et importer à partir de modèles. Le connecteur enregistre automatiquement toutes les requêtes en tant qu’importations afin de pouvoir actualiser les résultats et réutiliser les requêtes existantes.

Prerequisites

• Vous avez configuré le connecteur Databricks pour Google Sheets.

Choisir une méthode d’importation

Vous pouvez importer des données depuis Azure Databricks dans Google Sheets en sélectionnant une table, en rédigeant une requête SQL ou en utilisant un modèle. Une fois les données importées, la requête est liée à la feuille. Le connecteur prend en charge l’importation jusqu’à la limite de 10 millions de cellules dans Google Sheets.

La modification du nom de la feuille interrompt le mappage. Pour plus d’informations sur la gestion des modifications de noms, consultez Limitations.

Choisissez une méthode d’importation pour commencer :

Sélectionner les données

Pour importer des données à partir d’une table dans Azure Databricks, procédez comme suit :

1. Dans la barre latérale google Sheets Databricks Connector, sous Nouvelle importation, pour la méthode Import, sélectionnez Sélectionner des données.
2. Sous Catalogue, utilisez le catalogue, le schéma et les menus déroulants de table pour rechercher la table que vous souhaitez importer.
3. Si vous le souhaitez, mettez à jour le nom de la ressource pour modifier le nom de cette importation.
4. Si vous le souhaitez, sous Champs, choisissez les colonnes à inclure ou exclure.
5. Vous pouvez éventuellement importer en tant que tableau croisé dynamique.
6. Pour ajouter un filtre, cliquez sur + Filtrer sous Filtres. Sélectionnez la colonne à laquelle appliquer le filtre et le type de filtre.
7. Si vous le souhaitez, activez Limiter les lignes pour définir une limite pour le nombre de lignes à importer. La limite est activée par défaut et définie sur 1 000 lignes.
8. Sous Destination de sortie, indiquez si vous souhaitez enregistrer les résultats de la requête dans une nouvelle feuille ou dans la feuille active.
   • Si vous sélectionnez une nouvelle feuille, entrez un nom pour la feuille.
   • Si vous sélectionnez la feuille active, spécifiez la cellule dans laquelle commencer l’ajout des données.
9. Cliquez sur Enregistrer & Importer pour remplir la feuille.

Écrire une requête SQL

Pour écrire une nouvelle requête SQL, procédez comme suit :

1. Dans la barre latérale du connecteur Google Sheets Databricks, sous Nouvelle importation, sélectionnez Écrire SQL.
2. Databricks recommande d’entrer un nom pour votre requête afin qu’elle soit identifiable.
3. Vous pouvez parcourir les catalogues, les schémas et les tables.
4. Dans l’éditeur SQL, saisissez votre requête SQL. Pour écrire une requête plus longue dans une fenêtre plus grande, ou pour prévisualiser les résultats avant d’importer, développez l’éditeur SQL.
5. Vous pouvez éventuellement ajouter des paramètres de requête.
6. Sous Destination de sortie, indiquez si vous souhaitez enregistrer les résultats de la requête dans une nouvelle feuille ou dans la feuille active.
   • Si vous sélectionnez une nouvelle feuille, entrez un nom pour la feuille.
   • Si vous sélectionnez la feuille active, spécifiez la cellule dans laquelle commencer l’ajout des données.
7. Cliquez sur Enregistrer & Importer pour exécuter la requête et remplir la feuille.

Utiliser le modèle

Un administrateur d’espace de travail ou un utilisateur ayant ce CREATE CATALOG privilège doit configurer des modèles avant que vous puissiez en importer un. Pour importer à partir d’un modèle, faites ce qui suit :

1. Dans la barre latérale du Connecteur Databricks pour Google Sheets, sous Nouvelle importation, pour Méthode d'importation, sélectionnez Utiliser le modèle.
2. Sélectionnez un groupe de modèles, puis sélectionnez un modèle. Un aperçu liste les importations du modèle.
3. Sélectionnez les imports à importer. Tous les imports sont sélectionnés par défaut.
4. Cliquez sur Importer des modèles. Chaque importation sélectionnée est ajoutée à une nouvelle feuille puis se comporte comme n’importe quelle autre importation enregistrée.

Ajouter des paramètres de requête (facultatif)

Pour ajouter des paramètres de requête à votre requête SQL :

1. Vérifiez que votre requête a au moins un paramètre de requête, au format .:parameter_name Pour plus d’informations sur les paramètres de requête, consultez Utiliser des marqueurs de paramètres nommés.

2. Cliquez sur + Ajouter un paramètre.

3. Entrez le paramètre dans la première zone. Vérifiez que le nom du paramètre correspond à ce que vous avez entré dans l’éditeur de requête.

4. Entrez le nom de la feuille et l’emplacement de la cellule de votre valeur de paramètre dans la deuxième zone, y compris le point d’exclamation après le nom de la feuille.

5. Pour ajouter d’autres paramètres de requête, cliquez à nouveau sur + Ajouter un paramètre .

   Par exemple, la requête suivante inclut le paramètre :trip_distancede requête , qui est défini dans la feuille sheet_1, cellule H1.

   

Agrandir l’éditeur SQL (optionnel)

Le Databricks Connector pour Google Sheets peut ouvrir l’éditeur Write SQL dans une fenêtre séparée et plus grande, afin que vous puissiez écrire, paramétrer et prévisualiser des requêtes plus longues que ce qui peut être placé dans la barre latérale. Le tableau reste utilisable tant que la fenêtre est ouverte.

Pour agrandir l’éditeur SQL :

1. Dans le formulaire Écrire SQL, cliquez sur l’icône d’expansion à côté de l’étiquette éditeur SQL.

   L’éditeur SQL s’ouvre dans une nouvelle fenêtre. Tant qu’il est ouvert, la barre latérale indique que l’éditeur de requêtes est étendu et que vous ne pouvez pas modifier la requête dans la barre latérale.

2. Modifiez votre requête SQL. Pour ajouter des paramètres de requête, cliquez sur + Ajouter un paramètre. Les paramètres fonctionnent de la même manière que dans la barre latérale. Consultez Ajouter des paramètres de requête.

3. Pour vérifier votre requête avant d’importer, cliquez sur Aperçu. La fenêtre affiche le nombre total de lignes retournées par la requête ainsi que les 10 premières lignes.

4. Choisissez comment fermer la fenêtre :

   • Pour conserver vos modifications, cliquez sur Enregistrer. Vous pouvez aussi cliquer sur Réduire dans la barre latérale.
   • Pour annuler vos modifications, cliquez sur Annuler ou fermez la fenêtre. Si vous avez des modifications non enregistrées, le navigateur vous demande de confirmer avant que la fenêtre ne se ferme.

Importer en tant que tableau croisé dynamique (facultatif)

Pour importer vos données en tant que tableau croisé dynamique, procédez comme suit :

1. Pour importer des données à l'aide de la méthode Select data, cochez la case Tableau croisé dynamique.
2. Sous Configuration de tableau croisé dynamique, sélectionnez les lignes et colonnes pour les dimensions de votre tableau croisé dynamique.
3. Spécifiez les valeurs à agréger. Cliquez sur + Ajouter une valeur , puis sélectionnez la colonne et la méthode d’agrégation.
4. Si vous le souhaitez, ajoutez des filtres en cliquant sur + Ajouter un filtre , puis sélectionnez le type de colonne et de filtre.
5. Cliquez sur Enregistrer & Importer pour importer les résultats sous forme de tableau croisé dynamique. Les tableaux croisés dynamiques importés sont automatiquement placés dans une nouvelle feuille.

Champs calculés

Un champ calculé est une colonne dérivée de données existantes, telles que profit calculées à partir de revenue et cost. Le Databricks Connector pour Google Sheets ne permet pas de créer des champs calculés avec la méthode d’importation de données Select . Pour ajouter un champ calculé, utilisez l’une des méthodes suivantes :

• Write SQL : Utilisez la méthode d’importation Write SQL pour calculer les colonnes calculées avec n’importe quelle expression SQL. Voir Choisir une méthode d’importation.
• Genie One : Demandez à Genie One de renvoyer vos données avec les colonnes calculées dont vous avez besoin, puis importez les résultats. Voir Utiliser Genie One dans Google Sheets.

Databricks recommande d’utiliser Genie One pour les champs calculés.

Gérer les données importées

Pour gérer les données que vous importez à partir de Azure Databricks, procédez comme suit :

1. Cliquez sur l’onglet Importations enregistrées dans la barre latérale du connecteur.

2. Pour actualiser manuellement les données importées :

   • Actualisez une seule importation : cliquez sur l’icône d’actualisation en regard du nom de la requête.
   • Actualisez toutes les importations : cliquez sur l’icône d’actualisation en haut de l’onglet Importations enregistrées , en regard de l’icône de calendrier.

   Pour actualiser automatiquement les importations selon une planification périodique, consultez Planifier des actualisations de données dans Google Sheets.

3. Pour afficher la feuille à laquelle une importation est connectée, cliquez sur l’icône de menu Kebab. Accédez à la feuille à côté du nom de la requête.

4. Pour modifier une importation, cliquez sur > Modifier à côté du nom de la requête.

5. Pour supprimer une importation, cliquez sur > Supprimez en regard du nom de la requête. Cela supprime la requête, et non les données importées dans Google Sheets. Vous devez supprimer manuellement les données importées.

Implications du partage

Le module complémentaire n’a pas d’impact sur votre capacité à partager votre feuille Google. Toutefois, la façon dont vous partagez le fichier a un impact sur les actions que vos destinataires peuvent entreprendre à l’aide du module complémentaire.

• Les destinataires disposant du rôle Visionneuse ou Commenter ne peuvent pas accéder au module complémentaire.
• Les destinataires disposant du rôle Éditeur et de l’accès aux ressources de données équivalentes peuvent utiliser le module complémentaire avec leur compte Google. Ils peuvent utiliser le connecteur comme le propriétaire.
• Les destinataires ayant le rôle Éditeur et le même accès aux ressources sous-jacentes peuvent actualiser les importations s’ils sont connectés au même espace de travail Azure Databricks.

Déplacer des données importées

Déplacez des tables importées à l’aide des commandes de copie-et-collage standard ou couper-coller :

• Le copier-coller duplique les données du tableau.
• Couper et coller déplace la table importée.

Azure Databricks ne vous empêche pas d'exporter les données de table.

Limites

• Le changement de nom ou la suppression d’une feuille attachée à une importation existante vous empêche d’actualiser l’importation. Pour résoudre ce problème, effectuez l’une des opérations suivantes :

  • Recréez la feuille avec le même nom.
  • Créez une nouvelle importation en choisissant Sélectionner une requête en tant que source, réutilisant l’importation, puis en cliquant sur Enregistrer sous Nouveau.

• Si deux requêtes correspondent à des plages identiques ou qui se chevauchent, le module complémentaire affiche les résultats de la requête la plus récente exécutée. Cela remplace les données précédemment importées.

• Lorsque vous importez un modèle, une requête dont le paramètre pointe vers une cellule n’est pas exécutée automatiquement. Le connecteur enregistre la requête et vous invite à configurer le paramètre avant de l’exécuter. Consultez les modèles dans Google Sheets.

Étapes suivantes

• Planifier les actualisations des données dans Google Sheets