Rédiger et modifier une requête

Si vous souhaitez effectuer une analyse plus complexe (comme joindre des données provenant de plusieurs tables BigQuery), vous pouvez rédiger une requête personnalisée.

Important :

• Pour accéder aux données BigQuery dans Google Sheets, vous devez avoir accès à BigQuery. Découvrez comment faire vos premiers pas avec BigQuery.
• Vous ne pouvez utiliser que le langage SQL standard Google avec le connecteur BigQuery.

1. Sur votre ordinateur, ouvrez une feuille de calcul dans Google Sheets.
2. Dans le menu situé en haut, cliquez sur Données Connecteurs de données Se connecter à BigQuery.
3. Sélectionnez un projet.
4. Cliquez sur Requêtes enregistrées et éditeur de requête.
5. Saisissez une requête.
   • Pour prévisualiser la quantité de données analysées par votre requête, cliquez sur Prévisualiser les résultats en bas à droite de l'éditeur.
6. Cliquez sur Insérer les résultats.

Conseils :

• Si vous êtes développeur, découvrez comment utiliser Apps Script avec les feuilles connectées.
• Pour trouver certaines nouvelles requêtes enregistrées, activez l'API Dataform. En savoir plus sur l'API Dataform
• Validez les types de données entre les données BigQuery et Sheets à des fins d'analyse.

Utiliser des requêtes enregistrées dans les feuilles connectées

Pour créer des requêtes dans des feuilles connectées, vous pouvez accéder aux requêtes enregistrées à partir de projets BigQuery. En savoir plus sur les requêtes enregistrées

1. Sur votre ordinateur, ouvrez une feuille de calcul dans Google Sheets.
2. Dans le menu situé en haut de la feuille de calcul, cliquez sur Données Connecteurs de données Se connecter à BigQuery.
3. Sélectionnez un projet.
4. Cliquez sur Requêtes enregistrées et éditeur de requête Requêtes enregistrées BigQuery.
5. Sélectionnez un projet une requête enregistrée.
6. Cliquez sur Se connecter.

Pour modifier une requête enregistrée, mettez-la à jour directement dans BigQuery. La requête mise à jour apparaît dans les feuilles connectées dans les cinq minutes qui suivent.

Pour que vos requêtes enregistrées soient à jour chaque fois que vous les modifiez dans BigQuery :

1. Dans la feuille connectée, synchronisez vos requêtes enregistrées via l'option Synchroniser depuis BigQuery.
2. Dans l'éditeur BigQuery, cliquez sur Connecter.

En savoir plus sur les requêtes enregistrées

Lorsqu'une erreur se produit en raison de la modification ou de la suppression d'une requête enregistrée, vous pouvez mettre à jour la connexion dans la boîte de dialogue de l'erreur ou dans l'éditeur BigQuery.

1. En haut à droite de la feuille d'aperçu, ouvrez Paramètres de connexion.
2. Pour mettre à jour la connexion, cliquez sur Synchroniser depuis BigQuery Connecter.
3. Pour mettre à jour la connexion dans les cas suivants :
   • Requête modifiée : cliquez sur Afficher l'erreur Synchroniser la requête enregistrée.
     • Vous pouvez également ouvrir l'éditeur de requête. Cliquez sur Modifier Synchroniser la requête enregistrée Connecter.
   • Requête supprimée : cliquez sur Afficher l'erreur Utiliser en tant que requête personnalisée.
     • Vous pouvez également procéder comme suit :
       1. Pour ouvrir l'éditeur de requête, cliquez sur Modifier.
       2. Passez à une autre requête ou dissociez la requête existante.
       3. Cliquez sur Se connecter.

Ajouter des paramètres à une requête

Pour utiliser la valeur d'une ou de plusieurs cellules dans une requête personnalisée, configurez un paramètre.

1. Dans une feuille connectée, ouvrez Requêtes enregistrées et éditeur de requête.
2. À droite, cliquez sur Paramètres Ajouter.
3. Attribuez un nom au paramètre, puis cliquez sur Référence de cellule.
4. Saisissez ou sélectionnez une plage de données d'une ou plusieurs cellules, puis cliquez sur OK.
5. Dans la fenêtre des paramètres BigQuery, cliquez sur Ajouter.
6. Dans l'éditeur de requête, saisissez votre requête.
   • Conseil : Lorsque vous utilisez un paramètre de liste, utilisez la fonction UNNEST().
7. Lorsque les données sont prêtes, cliquez sur Connecter.

Comparaison de données dans Sheets et BigQuery

Pour comparer des données, vous devrez peut-être en modifier le type. Par exemple, si une colonne contient des données sous forme de chaînes dans BigQuery, celles-ci doivent être converties en texte brut dans Sheets pour que la comparaison puisse être effectuée correctement.
Si le type de données est différent dans la feuille de calcul et dans BigQuery, deux possibilités s'offrent à vous :

• Modifier le format des données dans Sheets. Par exemple, les données au format numérique peuvent être remplacées par du texte brut.
• Caster la valeur dans une requête. Par exemple : WHERE zip_code = CAST(@ZIP AS string).

Exemples de requêtes

Requête simple :

SELECT
word,
SUM(word_count) AS word_count
FROM
`bigquery-public-data.samples.shakespeare`
WHERE word IN ('me', 'I', 'you')
GROUP BY word;

Requête paramétrée :

SELECT SUM(kw_total)
FROM `bigquery-public-data.sunroof_solar.solar_potential_by_censustract`
WHERE state_name = @STATENAME;

Étape suivante : Résoudre les problèmes liés aux données BigQuery dans Sheets

Ressources associées

• Premiers pas avec les données BigQuery dans Sheets
• Trier et filtrer vos données BigQuery dans Sheets
• Analyser et actualiser une requête avec des données BigQuery dans Sheets
• Résoudre les problèmes liés aux données BigQuery dans Sheets