Guide
Fonction QUERY Google Sheets : traduire une question
QUERY répond à une question écrite dans un langage proche de celui des bases de données. Syntaxe, ordre des clauses, dix questions traduites.
Mis à jour le
La fonction QUERY de Google Sheets est ce qui se rapproche le plus d'une question posée à la feuille, sans IA : vous écrivez ce que vous voulez voir (« le total par client, du plus gros au plus petit ») dans un petit langage proche du SQL (le langage standard des bases de données), et Sheets renvoie un tableau de résultats qui se met à jour avec les données. Sa syntaxe : QUERY(données; requête; [en-têtes]).
Cette page traduit des questions courantes en requêtes. Les règles citées viennent de l'aide Google de QUERY et de la documentation du langage de requête de l'API Google Visualization, relues le 16/11/2026. Pour des consignes prêtes à copier autour de QUERY et d'IMPORTRANGE, voir IMPORTRANGE et QUERY dans Google Sheets : guide et prompts.
La syntaxe en trois arguments
- données : la plage interrogée, par exemple
A1:E500. Chaque colonne ne peut contenir que des booléens, des nombres (dates et heures comprises) ou du texte. - requête : le texte de la question, entre guillemets, ou une cellule qui le contient.
- en-têtes (facultatif) : le nombre de lignes d'en-tête. Omis ou à
-1, Sheets le devine d'après le contenu. Mettez1si la plage contient une ligne d’en-têtes et0si elle n’en contient aucune.
Selon les paramètres régionaux de la feuille, les arguments se séparent par un point-virgule ou une virgule. Dans la requête, les colonnes se désignent par leur lettre (A, B…). L'aide montre aussi la notation Col1, Col2… : c'est elle que l'on emploie quand QUERY lit le résultat d'une autre formule plutôt qu'une plage de la feuille.
Les clauses, dans l'ordre obligatoire
| Clause | Rôle | Équivalent dans votre question |
|---|---|---|
select |
Colonnes à afficher | « montre-moi le client et le montant » |
where |
Lignes à garder | « seulement les devis signés » |
group by |
Regrouper | « par client » |
pivot |
Mettre des valeurs en colonnes | « avec une colonne par statut » |
order by |
Trier | « du plus gros au plus petit » |
limit |
Nombre de lignes | « les 10 premiers » |
offset |
Sauter des lignes | « à partir du 11e » |
label |
Renommer une colonne de résultat | « appelle la colonne Total » |
format |
Mettre en forme | « en euros » |
La documentation est formelle : l'ordre des clauses doit être respecté. Un order by placé avant un group by produit une erreur.
Fonctions de calcul disponibles : sum() et avg() pour les nombres, count() (les vides ne sont pas comptés), max() et min().
Dix questions traduites
Prenons une feuille d'exemple, avec en A la date, en B le client, en C le commercial, en D le montant et en E le statut, et une ligne d’en-têtes. Pour les exemples de comptage ci-dessous, chaque ligne représente un devis ou une commande, et le champ client B est renseigné.
| Question en français | Requête |
|---|---|
| Toutes les commandes de plus de 1 000 € | select * where D > 1000 |
| Les devis signés, client et montant seulement | select B, D where E = 'Signé' |
| Le total par client | select B, sum(D) group by B |
| Le total par client, du plus gros au plus petit | select B, sum(D) group by B order by sum(D) desc |
| Les 5 meilleurs clients | select B, sum(D) group by B order by sum(D) desc limit 5 |
| Le nombre de devis par statut | select E, count(B) group by E |
| Le montant moyen par commercial | select C, avg(D) group by C |
| Le montant par commercial, une colonne par statut | select C, sum(D) group by C pivot E |
| Les clients dont le nom contient « SARL », quelle que soit la casse | select B where upper(B) contains 'SARL' |
| Le total par client, colonne renommée | select B, sum(D) group by B label sum(D) 'Total' |
La formule complète s'écrit par exemple : =QUERY(A1:E500; "select B, sum(D) where E = 'Signé' group by B order by sum(D) desc"; 1). Le texte entre apostrophes ('Signé') doit correspondre exactement au contenu des cellules, majuscules et accents compris.
Pour les questions qui portent sur une période (« depuis 90 jours », « ce mois-ci »), les dates ont leurs propres règles : voir QUERY et les dates.
Une notice des données peut préciser si « ventes » désigne des commandes ou des factures. Les fonctions d’ALMA offrent une piste pour interroger cette notice. La requête QUERY doit ensuite être exécutée et contrôlée dans la feuille sur les colonnes correspondantes.
Trois erreurs à examiner
- Une colonne affichée sans être regroupée. Avec
group by, toute colonne duselectdoit soit être dans legroup by, soit être dans une fonction de calcul.select B, C, sum(D) group by Béchoue : ajoutez C augroup byou retirez-la. - Des types mélangés. Si une colonne mélange nombres et texte, le type majoritaire l'emporte et les valeurs de l'autre type sont traitées comme vides. Si la colonne est majoritairement numérique, un montant resté en texte peut disparaître du total sans erreur de syntaxe. Voir nettoyer les données.
- La casse du texte.
contains,starts with,ends with,likeetmatchessont sensibles aux majuscules.where B contains 'sarl'ne trouve pas « SARL Dupont ».
Tester le comptage et les égalités
Dans notre exemple fictif, trois devis portent le statut Signé, mais l’un n’a pas de client renseigné. count(B) n’en compte que deux, puisque cette fonction ignore les valeurs nulles. Pour compter les devis, utilisez un identifiant systématiquement présent et contrôlez séparément les identifiants manquants.
Pour les cinq premiers clients, un classement par montant seul laisse le traitement des ex æquo à préciser. Ajoutez un second ordre, par exemple order by sum(D) desc, B asc, si vous voulez cinq lignes selon une règle stable. Cette limite n’inclut pas nécessairement tous les clients ayant le même montant que le cinquième. Un classement par chiffre ne mesure pas à lui seul la rentabilité ou la qualité d’un client.
Un total correct peut rester partiel
La formule d’exemple lit A1:E500 : elle ne couvre pas les lignes ajoutées après cette limite. Contrôlez la dernière ligne utile avant d’interpréter le résultat. Pour chaque groupe, rapprochez aussi le nombre de pièces attendues et le nombre de montants numériques disponibles.
Exemple fictif : trois devis ont des montants de 100 €, 200 € et un montant inconnu. Les deux valeurs connues totalisent 300 € ; ce n’est pas le montant confirmé des trois devis. Conservez le montant inconnu comme tel et signalez la pièce à compléter au lieu de saisir zéro pour faire disparaître le manque.
QUERY et Gemini, ensemble
Gemini peut écrire des formules dans votre feuille. Lui demander une formule QUERY plutôt qu'un chiffre a deux avantages : le résultat se met à jour avec les données, et vous pouvez relire la requête avec le tableau ci-dessus. Si le where ne filtre pas ce que vous pensiez, vous pouvez le repérer en examinant les conditions et les lignes retenues. C'est l'une des méthodes de vérification d'une réponse.
Pour une question à laquelle vous répondez souvent sous plusieurs angles, un tableau croisé dynamique est plus simple à manipuler.
Questions fréquentes
Quelle est la syntaxe de QUERY ?
QUERY(données; requête; [en-têtes]). La requête s'écrit entre guillemets dans le langage de requête de l'API Google Visualization ; en-têtes indique le nombre de lignes d'en-tête.
Dans quel ordre écrire les clauses ?
select, where, group by, pivot, order by, limit, offset, label, format, options. La documentation précise que cet ordre est obligatoire ; toutes les clauses sont facultatives.
Pourquoi une valeur manque dans le résultat ?
Vérifiez notamment si la colonne mélange les types : le type majoritaire l'emporte et les autres valeurs sont traitées comme vides.
La recherche par texte tient-elle compte des majuscules ?
Oui. contains, starts with, like et les autres opérateurs de texte sont sensibles à la casse ; utilisez upper() ou lower() pour l'éviter.
Sources
Pages consultées pour écrire cet article :