Skip to main content
Disponible avec le forfait Business auto-hébergé et les forfaits supérieurs
Chemin : Panneau d’administration → Boîte d’envoi calculée Utilisez Boîte d’envoi calculée lorsque les valeurs de champ de formule, de recherche ou d’autres champs calculés cessent de se mettre à jour ou prennent beaucoup plus de temps que prévu. La page affiche l’état de santé global des tâches, les tâches qui transitent par la file d’attente, celles qui peuvent nécessiter une récupération et tous les Espaces dont les tâches calculées sont actuellement suspendues.

​
Lire l’état de santé

L’état à côté du titre de la page indique si les tâches calculées nécessitent votre attention : Lorsque l’état nécessite votre attention, la page en indique la raison.

​
Rechercher une tâche dans la file d’attente

La file d’attente BullMQ en direct répertorie les tâches que Teable conserve encore afin que vous puissiez suivre une tâche calculée ou rechercher les tâches lentes. Chaque ligne correspond par défaut à une tâche et celle-ci change d’état sur place à mesure que Teable la relance. Passez à Livraisons lorsque vous avez besoin de l’historique complet des tentatives d’une tâche ou souhaitez rechercher des exécutions lentes. Pour affiner la liste :
  • Cliquez sur les tuiles d’état au-dessus de la table pour filtrer par état : En attente, Active, Différée, Échouée, Terminée (conservée), etc. Vous pouvez en sélectionner plusieurs à la fois ; survolez une tuile pour connaître la signification de cet état.
  • Filtrez par Espace, Base, Cause ou Résultat, recherchez une tâche, une Base, un Espace ou une erreur, ou définissez un temps de traitement minimal pour faire apparaître les tâches lentes.
  • Cliquez sur une ligne pour ouvrir la Traçabilité calculée : horodatages de la file d’attente, délai de livraison, temps de traitement, raison complète de l’échec avec le SQL masqué d’une livraison échouée, et détails de propagation décrits ci-dessous.
Terminée ne signifie pas que la tâche a effectué un travail. Le badge de résultat indique ce que la livraison a réellement fait : Traitée a exécuté la tâche, Aucune opération n’a rien trouvé à faire, Différée l’a replanifiée pour plus tard et Mise en attente signifie que son périmètre est suspendu. Le filtre Résultat restreint la liste selon ce résultat et indique le nombre de livraisons couvertes par chacun ; associer Terminée (conservée) à Traitée ne conserve donc que les livraisons ayant réellement exécuté la tâche.
Une ligne échouée représente l’historique d’une tentative de livraison, et non une tâche bloquée. La tâche durable continue de se relancer elle-même ; consultez donc la colonne État du registre pour décider si une action est nécessaire : Réglée signifie qu’une nouvelle tentative ultérieure a déjà réussi, et Lettre morte renvoie à la maintenance des anomalies. Les échecs réglés sont masqués par défaut ; une bannière indique leur nombre et vous permet de les afficher. Effacer l’historique des échecs supprime uniquement de la file d’attente les enregistrements de tâches échouées conservés. Cette opération ne répare rien, et les lettres mortes restent dans Maintenance des anomalies. Une tuile d’état peut également compter des entrées dont les données de tâche n’existent plus dans Redis, généralement laissées après une éviction ou une perte de données. La liste ne peut pas les afficher ; la page explique donc l’écart sous la table. Teable supprime lui-même ces éléments résiduels de l’état échoué ; Effacer l’historique des échecs les supprime immédiatement.

​
Suivre la propagation d’une valeur

Lorsqu’une valeur calculée semble incorrecte ou est arrivée tardivement, ouvrez Traçabilité calculée pour voir toute la chaîne à l’origine de celle-ci. Cliquez sur une ligne de la file d’attente, ou sur Traçabilité à côté d’un ID de tâche dans le détail d’une anomalie.
Le registre de traçabilité n’enregistre que les tâches créées après le déploiement de cette fonctionnalité et conserve 7 jours d’historique. Une tâche plus ancienne affiche les informations de sa file d’attente sans graphique de propagation. Une tâche initiale que le worker n’a pas encore planifiée n’affiche que ses champs déclencheurs. Lorsqu’une modification n’a produit aucune écriture calculée en aval, le graphique l’indique : aucun élément ne dépendait de ces champs via une formule, une recherche, un rollup ou un titre de lien.

​
Gérer les tâches anormales

Le nombre Échouée et Maintenance des anomalies indiquent différents types de problèmes ; leurs nombres peuvent donc différer.
Maintenance des anomalies regroupe les anomalies par groupes de problèmes, un par Base, table source et erreur, ce qui permet d’identifier facilement une cause racine unique. Examinez la raison de l’échec et corrigez le problème sous-jacent avant toute récupération. Développez un groupe pour consulter les détails de son erreur et les tâches qu’il couvre ; ces lignes sont destinées à l’inspection et la récupération s’exécute toujours sur le groupe dans son ensemble. Les actions proposées par un groupe dépendent de son type : Après la récupération d’un groupe, Teable indique le nombre de tâches restaurées, celles nouvellement mises en file d’attente ou déjà dans la file, et celles livrées ou différées. Les workers consomment ensuite le groupe selon les limites actuelles de concurrence et de fractionnement des tâches. Un groupe marqué Base supprimée appartient à une Base qui n’existe plus. Sa récupération échouerait immédiatement à nouveau ; Ignorer le groupe est donc la seule action proposée. Déplacer une table vers la corbeille ne crée plus d’anomalies ici. Une tâche calculée qui référence toujours une table placée dans la corbeille ignore les étapes qui la lisent, termine les étapes ciblant des tables actives, puis se termine. La récupération n’est pas non plus disponible lorsque les données elles-mêmes ont causé l’échec, par exemple une valeur qui dépasse une limite de taille ou ne respecte pas une contrainte de champ. Rejouer la même tâche échouerait de la même manière ; ignorez donc le groupe et corrigez les données source ou la définition du champ. Les écritures ultérieures recalculent automatiquement ces champs.

​
Suspendre les tâches calculées d’un Espace

Lorsque les tâches calculées d’un Espace aggravent un incident, suspendez cet Espace dans Suspensions des tâches calculées plutôt que d’arrêter toute l’instance.
1

Ouvrir la boîte de dialogue de suspension

Cliquez sur Suspendre un Espace.
2

Rechercher l’Espace

Recherchez par ID ou nom d’Espace, puis sélectionnez-le dans les résultats.
3

Choisir la durée

Définissez Durée de suspension sur 15, 30, 60 ou 120 minutes.
4

Indiquer la raison (facultatif)

Indiquez l’incident ou la fenêtre de maintenance dans Raison.
5

Confirmer

Cliquez sur Confirmer la suspension.
Une suspension empêche uniquement les workers de prendre en charge de nouvelles tâches calculées pour cet Espace. Les tâches déjà en cours ne sont pas interrompues, et les tâches correspondantes attendent la fin de la suspension au lieu d’être supprimées. Une suspension expire toujours d’elle-même, et deux heures est la durée maximale que vous pouvez définir. Si l’incident dure plus longtemps, suspendez de nouveau l’Espace depuis cette page. La liste affiche chaque suspension active avec son créateur, sa raison et sa date de reprise automatique, ainsi que le nombre de tâches en attente retenues par les suspensions actives, afin que vous puissiez évaluer l’arriéré qui sera libéré lors de la reprise. Pour lever une suspension plus tôt, cliquez sur Reprendre dans sa ligne et confirmez.

​
Ajuster la concurrence

La section de la file d’attente comporte deux contrôles de concurrence. Chacun écrit un remplacement à l’échelle du cluster que tous les processus appliquent dans un délai d’environ 15 secondes, sans redémarrage ; chacun peut être réinitialisé afin que les processus reviennent à leur propre paramètre d’environnement. Un badge Remplacé signale un contrôle qui n’utilise plus sa valeur par défaut. Augmentez les plafonds de prise en charge lorsqu’une Base très sollicitée constitue le goulot d’étranglement, et la concurrence par processus lorsque de nombreuses Bases sont mises en file d’attente simultanément.
Une concurrence plus élevée accroît la charge sur votre base de données. Les Espaces qui stockent leurs données dans un locataire de base de données conservent les valeurs par défaut de l’environnement pour les plafonds de prise en charge, car leurs pools de connexions sont dimensionnés pour ces valeurs.
Dernière modification le 4 septembre 2026