Interroger les données Databricks dans Google Sheets

Cette page décrit comment query des données depuis votre workspace Databricks et les importer dans Google Sheets à l'aide du Connecteur Databricks pour Google Sheets . Vous pouvez sélectionner des tables directement, écrire des query SQL, ajouter des parameters et créer des tableaux croisés dynamiques. Le connecteur enregistre automatiquement toutes les requêtes en tant qu'importations afin que vous puissiez refresh les résultats et réutiliser les requêtes existantes.

Prérequis

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

Choisir une méthode d'importation

Vous pouvez importer des données de Databricks dans Google Sheets en sélectionnant une table ou en écrivant une query SQL. Une fois les données importées, la query est liée à la feuille. Le connecteur prend en charge l'importation jusqu'à la limite de Google Sheets de 10 millions de cellules .

Le changement du nom de la feuille rompt le mappage. Pour plus d'informations sur la gestion des modifications de nom, consultez les Limitations.

important

Si vous utilisez "Select data" pour importer les vues de métriques Unity Catalog, elles ne peuvent être importées qu'en tant que tableaux croisés dynamiques car les métriques Unity Catalog représentent des données pivotées.

attention

Ne supprimez ni ne modifiez la mise en forme du tableau appliquée. L'identifiant de table Google Sheets est utilisé pour refresh l'importation. La suppression de la mise en forme entraîne des erreurs de refresh.

Choisissez une méthode d'importation pour commencer :

Select data

Pour importer des données depuis une table dans Databricks, procédez comme suit :

1. Dans la barre latérale du connecteur Databricks de Google Sheets, sous Nouvelle importation , pour Méthode d'importation , sélectionnez Sélectionner les données .

2. Sous Catalogue , utilisez les menus déroulants de catalogue, de schéma et de table pour rechercher la table que vous souhaitez importer.

3. Vous pouvez, si vous le souhaitez, mettre à jour l’ Asset Name pour modifier le nom de cet import.

4. Facultativement, 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 **+ Filtre** sous **Filtres**. Sélectionnez la **colonne** à laquelle appliquer le filtre et le **type de filtre**.

7. Vous pouvez activer l'option **Limit rows** pour définir une limite pour le nombre de lignes à importer. La limite est activée par default et définie à 1 000 lignes.

8. Sous Destination de la sortie , sélectionnez si vous souhaitez enregistrer les résultats de la query dans une nouvelle feuille ou dans la feuille actuelle.

   • Si vous sélectionnez une nouvelle feuille, saisissez un nom pour la feuille.
   • Si vous sélectionnez la feuille actuelle, spécifiez la cellule où start à ajouter les données.

9. Cliquez sur Enregistrer & Importer pour renseigner la feuille.

Write a SQL query

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

1. Dans la barre latérale du connecteur Databricks Google Sheets, sous Nouvelle importation , sélectionnez Écrire du SQL .

2. Databricks vous recommande de saisir un nom pour votre query afin qu'il soit identifiable.

3. Vous pouvez parcourir les catalogues, les schémas et les tables.

4. Dans Texte de la requête , saisissez votre query SQL.

5. Vous pouvez éventuellement ajouter des paramètres de query.

6. Sous Destination de la sortie , sélectionnez si vous souhaitez enregistrer les résultats de la query dans une nouvelle feuille ou dans la feuille actuelle.

   • Si vous sélectionnez une nouvelle feuille, saisissez un nom pour la feuille.
   • Si vous sélectionnez la feuille actuelle, spécifiez la cellule où start à ajouter les données.

7. Cliquez sur Enregistrer et importer pour exécuter la query et remplir la feuille.

remarque

L'exécution de la query expire après 15 minutes. Si votre query dépasse cette limite, elle est automatiquement annulée. Pour les grands jeux de résultats, les 1 000 premières lignes sont écrites immédiatement, les données restantes étant récupérées progressivement. Si la récupération des données est interrompue, les résultats partiels restent dans votre feuille et peuvent être effacés en réexécutant la query.

Ajouter des parameters de query (facultatif)

Pour ajouter des parameters de query à votre query SQL :

1. Assurez-vous que votre query contient au moins un parameter de query, au format :parameter_name. Pour en savoir plus sur les paramètres de requête, consultez Utiliser des marqueurs de paramètre nommés.

2. Cliquez sur + Ajouter un parameter.

3. Saisissez le paramètre dans la première zone. Assurez-vous que le nom du parameter correspond à ce que vous avez entré dans l'éditeur de query.

4. Saisissez le nom de la feuille et l'emplacement de la cellule de la valeur de votre paramètre dans la deuxième boîte, y compris le point d'exclamation après le nom de la feuille.

5. Pour ajouter d'autres parameters de query, cliquez à nouveau sur + Ajouter un paramètre .

   Par exemple, la query suivante inclut le parameter de query :trip_distance, qui est défini dans la feuille sheet_1, cellule H1.

   

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 **Sélectionner les données**, sélectionnez la case à cocher **Table pivot**.
2. Sous **Configuration du tableau croisé dynamique**, sélectionnez les **Lignes** et les **Colonnes** pour les dimensions de votre tableau croisé dynamique.
3. Spécifiez les valeurs à agréger. Cliquez sur + Ajouter une valeur et sélectionnez la colonne et la méthode d’agrégation.
4. En option, ajoutez des filtres en cliquant sur + Ajouter un filtre et sélectionnez la Colonne et le Type 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 importés dans une nouvelle feuille.

Gérer les données importées

Pour gérer les données que vous importez depuis Databricks, procédez comme suit :

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

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

   • **Refresh d'une seule importation** : cliquez sur l'icône refresh à côté du nom de la query.
   • refresh all imports : Cliquez sur l'icône de refresh en haut de la Saved imports tab, à côté de l'icône du calendrier.

   Pour actualiser automatiquement les importations selon un calendrier récurrent, consultez la section Planifier les refresh de données dans Google Sheets.

3. Pour voir à quelle feuille une importation est connectée, cliquez sur > Accéder à la feuille à côté du nom de la query.

4. Pour modifier une importation, cliquez sur > Edit à côté du nom de la query.

5. Pour supprimer une importation, cliquez sur > Supprimer à côté du nom de la query. Cela supprime la query, et non les données importées dans Google Sheets. Vous devez supprimer manuellement les données importées.

Implications du partage

L'extension n'a pas d'impact sur votre capacité à partager votre Google Sheet. Toutefois, la manière dont vous partagez le fichier a un impact sur les actions que vos destinataires peuvent effectuer à l'aide de l'extension.

• Les destinataires ayant le rôle de Visionneur ou de Commentateur ne peuvent pas accéder au complément.
• Les destinataires disposant du rôle d'éditeur et d'un accès équivalent aux assets de données peuvent utiliser le module complémentaire avec leur compte Google. Ils peuvent utiliser le connecteur tout comme le propriétaire.
• Les destinataires disposant du rôle d'Éditeur et ayant le même accès aux Ressources sous-jacentes peuvent refresh les importations s'ils sont connectés au même Workspace Databricks.

Déplacer les données importées

Déplacez les tables importées à l'aide des commandes standard de copier-coller ou de couper-coller :

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

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

Limitations

• Renommer ou supprimer une feuille attachée à une importation existante vous empêche d'actualiser l'importation. Pour corriger cela, effectuez l'une des opérations suivantes :

  • Recréez la feuille avec le même nom exact.
  • Créer une nouvelle importation en choisissant **Sélectionner une requête** comme source, en réutilisant l'importation et en cliquant sur **Enregistrer comme nouveau**.

• Si deux query mappent vers les mêmes plages ou des plages qui se chevauchent, l'add-on affiche les résultats de la query la plus récemment exécutée. Cela écrase les données précédemment importées.

Étapes suivantes

• Planifier les refresh de données dans Google Sheets