---
title: "Poser de meilleures questions à vos données"
description: "Posez des questions précises en langage naturel, utilisez le contexte et les relances, lisez les résultats et vérifiez la requête derrière chaque réponse."
canonical: https://docs.datarelix.ai/fr/guides/queries/
---

# Poser de meilleures questions à vos données

Datarelix transforme vos questions en langage naturel en SQL/KQL validé, avec une analyse Python optionnelle. Ce guide couvre la portée d'une connexion, les descriptions de schéma, les @-mentions et les preuves jointes à chaque réponse.

## Commencez par une connexion

Chaque conversation est rattachée à une seule connexion. Choisissez-en une dans le sélecteur de la barre latérale avant de poser votre question. Changer de connexion démarre une nouvelle conversation.

## La découverte du schéma facilite les questions

Lors de la première connexion, Datarelix inspecte le schéma et, en option, fait appel à un LLM pour enrichir chaque table d'une courte description. Ces descriptions font partie de ce que le modèle voit : de meilleures descriptions donnent de meilleures requêtes.

Si une table porte un nom peu parlant, modifiez sa description dans la vue de découverte de la connexion. Vous pouvez aussi y marquer ou démarquer les colonnes de clé primaire et de clé étrangère. Ces modifications de clés priment sur les indices de la base et du LLM pour la planification, mais ne changent jamais la base source ni l'instantané d'inspection brut.

Lorsque vous relancez **Analyze** (analyser), ajoutez si vous le souhaitez des notes sur la base, les tables importantes ou les principales colonnes de clés. Ces indices aident le LLM de découverte à produire de meilleures descriptions et de meilleures pistes de relations.

## Types de questions qui fonctionnent bien

- **Questions d'agrégation :** « Quel a été le chiffre d'affaires mensuel au dernier trimestre ? »
- **Questions top N :** « Les 10 meilleurs clients par valeur vie. »
- **Questions comparatives :** « Comment la conversion se compare-t-elle entre les États-Unis et l'UE ? »
- **Questions de tendance :** « Affiche les inscriptions par semaine sur les 6 derniers mois. »

Précisez la fenêtre temporelle et la granularité (jour/semaine/mois). Une question précise donne une requête précise.

## @-mentions : épingler des tables et des colonnes

Tapez `@` pour insérer une table ou une colonne directement dans votre question. Utile quand :

- Un schéma contient beaucoup de tables aux noms proches et vous voulez être exact.
- Vous voulez limiter une analyse à une colonne précise.

La mention apparaît sous forme de pastille dans votre saisie et accompagne votre question.

## Pastilles de filtre

Sous le champ de saisie, des pastilles listent les tables dans la portée. Vous pouvez :

- Activer ou désactiver chaque table.
- Activer ou désactiver chaque colonne d'une table.
- Cliquer sur **Clear** (effacer) pour réinitialiser.

Une portée plus étroite, c'est moins de métadonnées de schéma à parcourir et moins de risques de choisir la mauvaise table.

## Bouton graphique

Le bouton graphique, à côté du champ de saisie, bascule entre des réponses en texte seul et des réponses accompagnées d'un graphique. Les graphiques proviennent d'une étape Python en bac à sable exécutée après l'étape SQL — quelques secondes de plus, mais un résultat visuel que vous pouvez épingler à un tableau de bord.

## Lire la réponse

Chaque message de l'assistant comporte :

1. **Le texte de la réponse** — le résumé en langage naturel produit par le LLM.
2. **L'artefact** — tableau ou graphique, selon la question.
3. **La ligne de preuve** — les tables utilisées, le nombre de lignes et le temps d'exécution. Toujours visible.
4. **Les bascules de trace** — le SQL/KQL exact et le journal d'exécution étape par étape sont à un clic.

Si quelque chose semble faux, dépliez le SQL. Si le SQL est juste mais que les données ne le sont pas, le problème se situe en amont de Datarelix.

## En cas de problème

Datarelix classe les erreurs en cinq catégories. Chacune a son propre écran de reprise :

- **Aucun résultat** — élargissez la question.
- **Délai dépassé** — réduisez la portée ou raccourcissez la fenêtre.
- **Échec de plan** — le LLM n'a pas pu produire de plan valide ; reformulez la question et réessayez.
- **Échec de connexion** — retestez la connexion depuis la barre latérale.
- **Permission/validation** — la base rejette votre authentification ; vérifiez vos identifiants.

Voir [Codes d'erreur](/fr/api/errors/) pour la taxonomie complète.

## Épingler à un tableau de bord

N'importe quel graphique peut être épinglé à un tableau de bord depuis le menu du graphique. Les tableaux de bord s'actualisent à la demande — tous les graphiques d'un coup ou une carte à la fois.

## Revenir à une conversation

Chaque conversation dispose d'un lien direct en `/c/<id>` que vous pouvez mettre en favori et rouvrir plus tard. Les conversations sont privées, rattachées à votre compte.