---
title: "Dépannage"
description: "Ce que signifie chaque message d’erreur de Datarelix et comment le résoudre : questions en échec, délais, connexion, limites du forfait et analyse du schéma."
canonical: https://docs.datarelix.ai/fr/guides/troubleshooting/
---

# Dépannage

Quand une question échoue, Datarelix affiche un court message avec un moyen de reprendre : **Retry** (réessayer), une copie modifiable de votre question avec **Try again**, **Test connection** (tester la connexion), **Manage connections** (gérer les connexions) ou **View plans** (voir les forfaits). L’historique des exécutions présente le même échec sous son code, par exemple `SQL_TIMEOUT`. Les messages restent en anglais dans l’application : retrouvez le vôtre ci-dessous pour savoir ce qu’il signifie et comment le résoudre.

Pour de nombreux échecs, Datarelix a déjà corrigé la requête et réessayé plusieurs fois avant d’afficher un message.

## La question n’a pas pu aboutir

| Message | Dans l’historique | Que faire |
| --- | --- | --- |
| **Unable to answer** | `NOT_ANSWERABLE` | Les données de la portée ne contiennent pas ce que demande la question. Reformulez, ou ajoutez les tables manquantes à la sélection de la connexion. |
| **Ambiguous question** | `AMBIGUOUS_QUERY` | La question admet plusieurs lectures raisonnables. Précisez la mesure, la période ou la table voulue, puis choisissez **Try again**. |
| **Table not found** | `MISSING_TABLE` | La requête avait besoin d’une table non sélectionnée. Ajoutez-la à la sélection et relancez la question. |
| **Column not found** | `MISSING_COLUMN` | La colonne n’existe pas dans les tables sélectionnées. Vérifiez la sélection, ou reformulez avec des colonnes existantes. |
| **Data type mismatch** | `TYPE_MISMATCH` | Des valeurs de types différents ont été comparées, comme du texte et des dates. Reformulez pour comparer des types compatibles. |

Le [guide des questions](/fr/guides/queries/) montre comment préciser période, mesure et regroupement pour qu’une question n’ait qu’une lecture.

## La requête a pris trop de temps ou de ressources

| Message | Dans l’historique | Que faire |
| --- | --- | --- |
| **Query timed out** | `SQL_TIMEOUT` | La requête a dépassé la limite de 30 secondes. Ajoutez un filtre de dates, réduisez la portée, ou interrogez le responsable de la base sur la charge. |
| **Processing timed out** | `SANDBOX_TIMEOUT` | Une étape d’[analyse Python](/fr/guides/python/) a dépassé sa limite de 90 secondes. Agrégez d’abord en SQL ou réduisez le nombre de lignes traitées. |
| **Out of memory** | `SANDBOX_OOM` | Une étape d’analyse Python a dépassé sa limite de 512 Mo de mémoire. Sélectionnez moins de colonnes ou agrégez avant l’analyse. |

## Datarelix n’a pas pu joindre votre base

| Message | Dans l’historique | Que faire |
| --- | --- | --- |
| **Connection failed** | `CONNECTION_ERROR` | Choisissez **Test connection**. En cas d’échec, vérifiez les identifiants, que la base fonctionne et que son pare-feu autorise Datarelix. Le [guide de connexion](/fr/guides/connections/) de votre moteur liste les causes fréquentes. |

## La requête générée a échoué

| Message | Dans l’historique | Que faire |
| --- | --- | --- |
| **SQL validation failed** | `SQL_VALIDATION` | La requête a été refusée avant son exécution — par exemple parce que ce n’était pas une lecture, ou qu’elle visait des objets hors de la portée de la connexion. Reformulez la question ; élargir les droits sur la base ne règle pas ce cas. Voir [Sécurité et contrôles en lecture seule](/fr/guides/security/). |
| **Query execution error** | `SQL_EXECUTION` | La base a renvoyé une erreur, par exemple un problème de droits. Vérifiez que l’identité de la connexion peut lire les tables concernées. |
| **SQL syntax error** | `SQL_SYNTAX` | La requête générée n’était pas valide pour votre moteur. Reformulez ou simplifiez la question. |
| **Processing error** | `SANDBOX_CODE_ERROR` | Le code d’analyse Python généré a échoué. Essayez une analyse plus simple ou reformulez. |
| **Invalid AI output** | `LLM_INVALID_OUTPUT` | L’IA a renvoyé une réponse inutilisable. Choisissez **Retry**. |

## Le service d’IA a rencontré un problème

| Message | Que faire |
| --- | --- |
| **The AI service is busy** | Réessayez dans un instant. |
| **The AI service timed out** | Réessayez. Si cela se répète, posez une question plus ciblée. |
| **AI service error** | Réessayez. Si l’erreur persiste, contactez le support avec la référence affichée. |

## Limites du forfait

Ces messages signifient que la demande a atteint une limite de votre forfait, pas qu’une panne s’est produite. Vos données et votre historique ne sont pas touchés. Les limites de chaque forfait figurent dans [Facturation et formules](/fr/guides/billing/).

| Message | Que faire |
| --- | --- |
| **Question limit reached** / Monthly question limit reached | Vous avez utilisé les questions du mois. Le compteur repart le 1er (UTC), ou choisissez **View plans** pour passer à un forfait supérieur ; la nouvelle allocation s’applique aussitôt. Avec Team, l’allocation est partagée par l’espace de travail. |
| Daily fair-use limit reached | Pro et Team autorisent 500 questions par personne et par jour. La limite repart à minuit UTC ; votre allocation mensuelle n’est pas touchée. |
| Monthly AI schema analysis allowance reached | Vous avez utilisé les analyses IA du schéma du mois. Relancer la découverte et reprendre une analyse interrompue restent gratuits. Attendez le 1er (UTC) ou passez à un forfait supérieur. |
| **This connection is paused** | Réactivez-la depuis **Manage connections** — il faut de la place sous la limite de connexions de votre forfait — ou utilisez une autre connexion. |
| **Too many active connections for your plan** | Vous avez plus de connexions actives que votre forfait n’en prévoit, par exemple après un changement de forfait. Mettez en pause celles dont vous n’avez pas besoin depuis **Manage connections**, ou passez à un forfait supérieur. |
| All seats are taken | Une invitation Team demande un siège libre. Ajoutez des sièges dans **Manage billing**, ou retirez un membre ou une invitation en attente. |
| **Subscription inactive** | Inviter des collègues demande un abonnement Team actif. Si un abonnement a pris fin, vous êtes sur le forfait Free avec vos données intactes ; passez à un forfait supérieur pour retrouver ses limites. |

## Analyse du schéma

| Message | Que faire |
| --- | --- |
| **Analysis failed** | Choisissez **Retry Schema Analysis** lorsqu’il est proposé, ou relancez l’analyse. Si elle échoue à plusieurs reprises, contactez le support avec la référence affichée. |
| **Analysis interrupted** | Choisissez **Retry Schema Analysis**. Les schémas déjà analysés sont réutilisés, et la reprise ne consomme pas d’analyse IA du schéma supplémentaire. |
| **Couldn't read the tables in your database** | L’analyse n’a pas pu lire la base de données : rien n’a été analysé, votre schéma enregistré reste inchangé et l’analyse IA du schéma n’est pas décomptée de votre allocation mensuelle. Datarelix attend déjà environ une minute qu’une base mise en pause en cas d’inactivité se réveille. Vérifiez que la base est démarrée et accessible depuis Datarelix, puis relancez l’analyse. |
| **No tables or views were found** | Les schémas sélectionnés pour cette connexion sont vides : il n’y avait rien à analyser, et l’analyse IA du schéma n’est pas décomptée. Vérifiez les schémas sélectionnés dans les paramètres de la connexion. |

Si l’analyse IA du schéma dure longtemps sur un très gros schéma, réduisez la portée autorisée de la connexion, ou ignorez l’analyse et travaillez à partir de la découverte seule.

## Contacter le support

Les erreurs liées à une réponse ou à une analyse du schéma affichent une **Reference** (référence). Si vous [contactez le support](https://datarelix.ai/fr/contact/), indiquez cette référence, le message et votre question. N’envoyez jamais de mot de passe de base de données ni d’autres identifiants.