Skip to main content
Disponibile per il piano Business Self-hosted e versioni successive
Percorso: Amministrazione di sistema → Operazioni sulle query delle Tabelle Usa Operazioni sulle query delle Tabelle quando Viste, filtri, relazioni o ricerche in una Tabella di grandi dimensioni diventano lenti. Un analizzatore in background osserva il carico delle query e trasforma quanto rilevato in suggerimenti. La pagina li elenca affinché gli amministratori dell’istanza possano esaminare le prove, analizzare più a fondo una Tabella specifica e confermare eventuali modifiche al database. I contatori sopra l’elenco riepilogano la situazione corrente: finestre di osservazione, richieste, query lente, timeout, suggerimenti aperti e accettati, attività in esecuzione e non riuscite e numero di percorsi di accesso per la ricerca pronti o degradati.

Esaminare i suggerimenti

La pagina si apre su Suggerimenti, ordinati per priorità. L’analizzatore pondera il rischio di una query rispetto all’intensità d’uso della Tabella, così le voci per cui è più opportuno intervenire vengono mostrate per prime. Cerca per ID di Tabella, Base o Spazio per filtrare tutti i suggerimenti; qualsiasi altro testo filtra ciò che è già visualizzato. I filtri di stato e rischio restringono ulteriormente l’elenco. Ogni voce indica lo Spazio, la Base e la Tabella a cui appartiene. Espandi una riga per leggere le prove alla base del suggerimento, la decisione del sistema e la diagnostica SQL: Analisi approfondita apre l’area di lavoro di analisi con la Tabella già compilata. Quando l’analizzatore rileva numerose ricerche di sottostringhe in una Tabella, genera un unico suggerimento GIN per testo generato per l’intera Tabella, anziché un indice per ogni Campo. Tale riga offre Crea percorso di ricerca al posto di Analisi approfondita e Aggiungi indice non viene visualizzato, perché un percorso di accesso per la ricerca viene applicato dall’area di lavoro di analisi e richiede prima una ricerca di esempio EXPLAIN. Il suggerimento si chiude automaticamente quando la Tabella dispone del percorso. Accanto sono presenti altre due schede: Sopra l’elenco viene visualizzato un banner quando un problema di configurazione blocca il processo: i percorsi di accesso per la ricerca sono configurati mentre il flag del runtime è disattivato, alcune Tabelle hanno un percorso di accesso obsoleto o in attesa di ricostruzione e la ricerca è passata automaticamente alla scansione ILIKE più lenta oppure l’attività accodata più vecchia è rimasta in attesa abbastanza a lungo da suggerire che nessun worker la stia elaborando. Correggi quanto segnalato dal banner prima di intervenire sui suggerimenti sottostanti.

Leggere il badge della decisione

Ogni suggerimento riporta la decisione più recente presa dal sistema:
Per impostazione predefinita, Teable registra soltanto le decisioni e crea i Record dei suggerimenti e delle attività; non modifica autonomamente il database. L’esecuzione automatica è facoltativa e si abilita tramite V2_TABLE_QUERY_OPS_AUTO_ACCEPT=auto; anche in tal caso viene applicata soltanto alle Tabelle di piccole dimensioni il cui piano di esecuzione mostra un chiaro miglioramento dei costi. Tutto il resto attende l’intervento di un amministratore.

Aggiungere l’indice proposto

Quando un suggerimento propone un indice che approvi, fai clic su Aggiungi indice nella riga. La conferma accetta il suggerimento ed esegue CREATE INDEX CONCURRENTLY sulla Tabella PostgreSQL sottostante; se la convalida del piano è stata ignorata, Teable crea comunque l’indice dai Campi consigliati. La finestra di dialogo ripete le prove affinché tu possa controllarle un’ultima volta. Per una Tabella stimata in almeno 50.000 righe, la finestra di dialogo richiede di confermare che sia attiva una finestra di manutenzione prima di rendere disponibile il pulsante. La creazione simultanea su una Tabella di grandi dimensioni richiede tempo e aggiunge carico durante l’esecuzione. Teable segnala quindi Indice creato oppure Suggerimento accettato e accodato. Nel secondo caso, segui l’attività nella scheda Attività. Se il suggerimento non dispone di una colonna fisica eseguibile sottostante, Aggiungi indice rimane disabilitato e ne indica il motivo; usa invece l’area di lavoro di analisi per approfondire.

Eseguire un’analisi approfondita

Apri Area di lavoro di analisi per analizzare un ambito su richiesta, ad esempio quando un utente segnala una Tabella lenta per cui non esiste ancora alcun suggerimento. Scegli Tabella, Base o Spazio, inserisci l’ID corrispondente e seleziona un tipo di analisi. Inizia da Tabella quando sai già quale Tabella è lenta. Fai clic su Genera report delle query o Genera report della ricerca. Il report riepiloga i rischi rilevati e le azioni successive consigliate. Per un report della ricerca, la ricerca di esempio EXPLAIN è facoltativa. Aggiungi un esempio per controllare la compatibilità dei risultati, i piani delle query e la temporizzazione delle query ripetute per il percorso di accesso proposto per la ricerca di sottostringhe. Teable non salva il valore di esempio.
Il report delle query non modifica il database. L’applicazione di un suggerimento per la ricerca di sottostringhe richiede una ricerca di esempio EXPLAIN e la conferma di un amministratore.
Per una Tabella di grandi dimensioni, esamina l’impatto e pianifica qualsiasi modifica confermata in una finestra di manutenzione adeguata.
Ultima modifica il 4 settembre 2026