Fonction QUERYInterroge tes données avec du SQL – Guide 2026

La source de données à interroger

Le paramètre données définit la plage de cellules que tu veux interroger. C'est l'équivalent de la clause FROM en SQL classique. Tu peux utiliser une simple référence de plage comme A1:E100, ou des fonctions plus avancées qui retournent des tableaux.

Google Sheets traite cette plage comme une table de base de données où chaque colonne représente un champ et chaque ligne représente un enregistrement. La première ligne peut contenir des en-têtes (selon le paramètre en_têtes), et toutes les lignes suivantes sont considérées comme des données.

La requête SQL pour manipuler les données

Le paramètre requête est le cœur de la fonction QUERY. C'est ici que tu écris ta requête SQL en utilisant le Google Visualization API Query Language, une version simplifiée de SQL spécialement conçue pour les feuilles de calcul.

Les colonnes se référencent par leurs lettres (A, B, C...) relatives à ta plage de données, ou par Col1, Col2, Col3... Tu peux sélectionner des colonnes spécifiques, les trier, les filtrer avec des conditions complexes, les regrouper pour créer des agrégations, et même créer des tableaux croisés dynamiques avec PIVOT.

Ordre des clauses SQL : SELECT → WHERE → GROUP BY → PIVOT → ORDER BY → LIMIT → LABEL. Respecte toujours cet ordre sinon tu auras une erreur de syntaxe.

Gérer les lignes d'en-tête (facultatif)

Le paramètre en_têtes indique à QUERY combien de lignes au début de ta plage sont des en-têtes de colonnes plutôt que des données. C'est crucial pour que QUERY sache où commencent les vraies données à interroger.

Utilise -1 (valeur par défaut) pour laisser Google Sheets deviner automatiquement en analysant le type de données. Utilise 0 si ta plage ne contient aucune en-tête et que les données commencent immédiatement. Utilise 1 ou plus si tu as une ou plusieurs lignes d'en-têtes fixes.

QUERY completed with an empty output

Cette erreur survient quand ta requête ne retourne aucune ligne de résultat. C'est souvent dû à une condition WHERE trop restrictive, une faute de frappe dans une valeur texte (majuscules/minuscules), ou des données qui n'existent tout simplement pas.

Solution : Teste d'abord avec "SELECT *" sans WHERE pour vérifier que ta plage de données est correcte. Ajoute ensuite les conditions une par une pour identifier celle qui pose problème. Vérifie la casse exacte de tes valeurs textuelles.

Invalid query: erreur de syntaxe SQL

Ta requête SQL contient une erreur de syntaxe : mot-clé mal orthographié, guillemets manquants ou incorrects, parenthèses mal fermées, ou clauses dans le mauvais ordre.

Solution : Vérifie l'ordre obligatoire des clauses : SELECT, WHERE, GROUP BY, PIVOT, ORDER BY, LIMIT, LABEL. Utilise toujours des guillemets simples \' pour les valeurs textuelles. Vérifie que tous les parenthèses et guillemets sont bien fermés.

Can't perform aggregation without GROUP BY

Tu utilises une fonction d'agrégation (SUM, AVG, COUNT, MIN, MAX...) dans ton SELECT avec d'autres colonnes non agrégées, mais tu as oublié le GROUP BY. En SQL, si tu agrèges certaines colonnes, toutes les autres doivent être dans GROUP BY.

Solution : Ajoute "GROUP BY" suivi de toutes les colonnes présentes dans SELECT qui ne sont pas dans une fonction d'agrégation. Exemple : "SELECT A, SUM(B) GROUP BY A"

Column [X] doesn't exist

Tu références une colonne qui n'existe pas dans ta plage de données. Par exemple, tu utilises "SELECT F" alors que ta plage A1:D100 ne contient que les colonnes A à D. Attention : les lettres sont relatives à ta plage, pas à la feuille.

Solution : Vérifie que ta plage de données inclut bien toutes les colonnes que tu références dans ta requête. Si ta plage commence en B, alors Col1 correspond à la colonne B, pas A.

Type mismatch: comparaison de types incompatibles

Tu essaies de comparer des types de données incompatibles, par exemple "WHERE A > 100" alors que la colonne A contient du texte, ou "WHERE B = 'Paris'" alors que B contient des nombres.

Solution : Assure-toi que tes colonnes contiennent le bon type de données avant de faire ta requête. Utilise des guillemets simples uniquement pour le texte, rien pour les nombres, et le format date '2024-01-15' pour les dates.

Guillemets simples oubliés dans les valeurs texte

Tu as écrit WHERE A = Paris au lieu de WHERE A = \'Paris\'. Sans guillemets simples, Google Sheets pense que "Paris" est un nom de colonne ou une variable, pas une valeur texte.

Solution : Encadre toujours les valeurs textuelles avec des guillemets simples \' à l'intérieur de ta requête : "WHERE A = \'Paris\' AND B = \'France\'"

Quelles clauses SQL sont supportées par QUERY ?

QUERY supporte les principales clauses SQL : SELECT (sélection de colonnes), WHERE (filtrage), ORDER BY (tri), GROUP BY (regroupement), PIVOT (tableaux croisés), LIMIT (limitation de résultats) et LABEL (renommage de colonnes). Tu peux les combiner pour créer des analyses sophistiquées en une seule formule.

Comment référencer les colonnes dans une requête QUERY ?

Les colonnes se référencent par leurs lettres (A, B, C...) ou par Col1, Col2, Col3... Tu peux aussi utiliser les en-têtes de colonnes si le paramètre en_têtes est défini sur 1 ou -1. Attention : les lettres de colonnes sont relatives à ta plage de données, pas à la feuille entière.

QUERY fonctionne-t-elle dans Excel ?

Non, QUERY est une fonction exclusive à Google Sheets. Excel propose des alternatives comme les tableaux structurés, Power Query ou les fonctions FILTRER et TRIER pour obtenir des résultats similaires. Si tu travailles sur Excel, utilise FILTRE, TRIER et UNIQUE en combinaison.

Peut-on combiner plusieurs fonctions QUERY ensemble ?

Oui, tu peux utiliser le résultat d'une QUERY comme source de données pour une autre QUERY. Tu peux aussi combiner QUERY avec d'autres fonctions comme ARRAYFORMULA, IMPORTRANGE ou même utiliser des opérateurs d'ensemble pour fusionner plusieurs requêtes.

Comment debugger une requête QUERY qui ne fonctionne pas ?

Commence par tester une requête simple comme "SELECT *" pour vérifier que ta plage de données est correcte. Ajoute ensuite les clauses une par une : d'abord SELECT avec les colonnes spécifiques, puis WHERE, puis ORDER BY, etc. Vérifie toujours les guillemets simples pour les valeurs textuelles et les types de données de tes colonnes.