Examiner les recommandations
La page s’ouvre sur Recommandations, classées par priorité. L’analyseur évalue le risque d’une requête par rapport à l’intensité d’utilisation de la Table ; les éléments qui méritent le plus une action apparaissent donc en premier. Recherchez par ID de Table, de Base ou d’Espace pour filtrer toutes les recommandations ; tout autre texte filtre ce qui est déjà affiché à l’écran. Les filtres de statut et de risque réduisent davantage la liste. Chaque entrée indique l’Espace, la Base et la Table auxquels elle appartient. Développez une ligne pour lire les éléments probants de la recommandation, la décision du système et les diagnostics SQL :
Analyse approfondie ouvre l’espace de travail d’analyse avec cette Table déjà renseignée.
Lorsque l’analyseur détecte de nombreuses recherches de sous-chaînes dans une Table, il génère une recommandation GIN de texte généré pour l’ensemble de cette Table au lieu d’un index par Champ. Une telle ligne propose Créer un chemin de recherche à la place de Analyse approfondie, et Ajouter un index n’apparaît pas, car un chemin d’accès de recherche est appliqué depuis l’espace de travail d’analyse et nécessite d’abord un EXPLAIN d’une recherche d’exemple. La recommandation se ferme automatiquement une fois que la Table dispose du chemin.
Deux autres onglets se trouvent à côté :
Une bannière apparaît au-dessus de la liste lorsqu’un problème de configuration bloque le processus : des chemins d’accès de recherche sont configurés alors que l’indicateur d’exécution est désactivé, certaines Tables ont un chemin d’accès obsolète ou en attente de reconstruction et leur recherche est silencieusement revenue à l’analyse
ILIKE plus lente, ou la tâche en file d’attente la plus ancienne attend depuis suffisamment longtemps pour suggérer qu’aucun worker ne la traite. Corrigez ce que la bannière indique avant d’agir sur les recommandations ci-dessous.
Lire le badge de décision
Chaque recommandation porte la dernière décision prise par le système à son sujet :Par défaut, Teable enregistre uniquement les décisions et crée des enregistrements de recommandations et de tâches ; il ne modifie pas votre base de données de lui-même. L’exécution automatique est facultative via
V2_TABLE_QUERY_OPS_AUTO_ACCEPT=auto et, même dans ce cas, elle s’applique uniquement aux petites Tables dont le plan d’exécution montre une nette amélioration des coûts. Tout le reste attend un administrateur.Ajouter l’index proposé
Lorsqu’une recommandation propose un index avec lequel vous êtes d’accord, cliquez sur Ajouter un index dans la ligne. La confirmation accepte la recommandation et exécuteCREATE INDEX CONCURRENTLY sur la Table PostgreSQL sous-jacente ; si la validation du plan a été ignorée, Teable crée tout de même l’index à partir des Champs recommandés. La boîte de dialogue répète les éléments probants afin que vous puissiez les vérifier une dernière fois.
Pour une Table estimée à 50 000 lignes ou plus, la boîte de dialogue vous demande de confirmer qu’une fenêtre de maintenance est prévue avant que le bouton ne devienne disponible. Une création concurrente sur une grande Table prend du temps et ajoute de la charge pendant son exécution.
Teable indique ensuite Index créé ou Recommandation acceptée et mise en file d’attente. Dans le second cas, suivez la tâche sous Tâches. Si la recommandation ne possède aucune colonne physique exécutable associée, Ajouter un index reste désactivé et l’indique ; utilisez plutôt l’espace de travail d’analyse pour approfondir.
Exécuter une analyse approfondie
Ouvrez Espace de travail d’analyse pour analyser un périmètre à la demande, par exemple lorsqu’un utilisateur signale une Table lente qui n’a pas encore de recommandation.
Choisissez Table, Base ou Espace, saisissez l’ID correspondant et sélectionnez un type d’analyse. Commencez par Table lorsque vous savez déjà quelle Table est lente.
Cliquez sur Générer le rapport de requêtes ou Générer le rapport de recherche. Le rapport résume les risques détectés et les prochaines actions recommandées. Pour un rapport de recherche, EXPLAIN d’une recherche d’exemple est facultatif. Ajoutez un exemple pour vérifier la compatibilité des résultats, les plans de requête et les temps de requête répétés pour le chemin d’accès de recherche de sous-chaînes proposé. Teable n’enregistre pas la valeur de l’exemple.
Le rapport de requêtes ne modifie pas la base de données. L’application d’une recommandation de recherche de sous-chaînes nécessite un EXPLAIN d’une recherche d’exemple et la confirmation d’un administrateur.