La pagina si limita ad accodare attività e non modifica mai il database in modo diretto. Ogni modifica viene eseguita in background in modo asincrono, quindi verifica l’esito in Attività / cronologia.
Le operazioni sulle query delle Tabelle sono disattivate per impostazione predefinita. Imposta
V2_TABLE_QUERY_OPS_ENABLED su true nel backend e riavvia: la pagina inizierà a raccogliere osservazioni.Individuare la Tabella su cui intervenire
La pagina si apre sull’elenco delle Tabelle. I pulsanti di stato in alto riportano i rispettivi conteggi e restringono l’elenco:
Il campo di ricerca accetta nomi o ID di Tabella, Progetto e Spazio. L’ordinamento è per Più query lente oppure Nome Tabella. La Finestra di osservazione copre l’ultima ora o 24 ore, e tutti i dati di osservazione dell’elenco seguono quella finestra. Le osservazioni vengono conservate per 2 giorni; quelle precedenti non compaiono più nell’elenco.
Ogni riga riporta righe e dimensioni stimate della Tabella, richieste e query lente della finestra, metodo di ricerca corrente e copertura dei Campi, numero di indici di filtro/ordinamento, oltre ai suggerimenti in sospeso e alle attività attive. Fai clic sul nome di una Tabella per aprirne il dettaglio.
Accanto ai pulsanti di stato, Informazioni sugli stati dell’indice spiega come vengono conteggiati questi numeri.
Leggere lo stato dell’indice
L’elenco delle Tabelle e il dettaglio mostrano lo stato dell’indice accanto al metodo di ricerca:
Sotto lo stato possono comparire due righe. Configurato: pg_bigm / pg_trgm indica che il provider salvato è diverso dal metodo di ricerca in uso, mentre Interruttore di runtime della ricerca indicizzata: disattivato indica che l’indice è pronto ma il runtime è spento e la ricerca resta su
ILIKE.
Quando un avviso in cima alla pagina segnala Tabelle con un indice di ricerca configurato ma non attivo, la ricerca su quelle Tabelle ripiega su ILIKE. Se l’avviso indica anche che il worker delle attività è spento, imposta V2_TABLE_QUERY_OPS_TASK_WORKER_ENABLED su true nel backend e riavvia, così gli indici potranno essere ricostruiti.
Un indice pubblicato non significa che ogni ricerca lo utilizzi: un termine troppo corto o un Campo fuori copertura ripiega comunque su
ILIKE. Questa pagina riporta lo stato dell’indice, non la prova che le richieste recenti lo abbiano usato.Configurare la copertura di ricerca
La scheda Copertura di ricerca mostra il metodo di ricerca corrente della Tabella, quanti Campi sono coperti e la Copertura attiva di ciascun Campo. Mostra campi non coperti limita l’elenco ai Campi non ancora inclusi; i Campi contrassegnati come Non idoneo non possono contribuire a un indice di ricerca per sottostringa.La copertura attiva richiede metadati dell’indice pubblicati e utilizzabili e l’interruttore di runtime attivo: la sola configurazione salvata non conta. La copertura è esplicita, quindi i Campi aggiunti in seguito non vengono inclusi automaticamente: riconfigura la Tabella per integrarli.
Analizza ed esegui la simulazione applica la modifica senza confermarla e riporta il numero di Campi coperti, le righe stimate, l’eventuale presenza di prove dal piano e l’impatto della creazione o della ricostruzione. Le Tabelle stimate a 50.000 righe o più, e quelle di dimensioni sconosciute, richiedono anche la conferma della finestra di manutenzione. Poi scegli Conferma e accoda attività.
Quello che la finestra restituisce è una ricevuta dell’attività, non un risultato. Chiudila e segui l’attività in Attività / cronologia. Inviando di nuovo la stessa modifica viene restituita l’attività già esistente.
Gestire gli indici di filtro e ordinamento
La scheda Indici di filtro / ordinamento elenca gli indici fisici che servono le condizioni di filtro e gli ordinamenti di questa Tabella, ciascuno con validità, indicazione se è gestito da Teable, dimensione e definizione. Sono gestiti separatamente dagli indici di ricerca per sottostringa. Sotto, le Azioni in sospeso raccolgono i suggerimenti di indice del sistema e indicano se sono supportati da prove del piano. Esamina la creazione dell’indice mostra l’indice proposto, il database su cui viene eseguito e le prove; dopo la conferma, Teable esegueCREATE INDEX CONCURRENTLY in modo asincrono. Anche qui le Tabelle grandi o di dimensioni sconosciute richiedono la conferma della finestra di manutenzione.
Questa pagina non elimina indici. Gli indici non gestiti e quelli di sistema possono proteggere vincoli o servire altri carichi di lavoro, quindi non vengono toccati.
Diagnosticare query specifiche
Quando una Tabella viene segnalata come lenta e nessun suggerimento la riguarda, apri la scheda Diagnosi delle query e scegli Analizza query. L’analisi legge soltanto le forme di query salvate e le prove del piano disponibili, e non crea nulla. La conclusione è Trovate opportunità di indice supportate dal piano, Nessuna opportunità di indice confermata dai piani disponibili oppure Prove insufficienti. Prove insufficienti non significano che si sia verificata una scansione sequenziale: una singola osservazione lenta non dimostra che il percorso di accesso sia la causa. Sotto viene elencata ogni query interessata, con l’indicazione se proviene dal traffico reale o da una configurazione di Vista salvata, e il costo di piano stimato prima e dopo l’indice proposto (costo di piano, non millisecondi).Seguire i risultati
La scheda Attività / cronologia ha tre parti:- Attività: le attività in background di questa Tabella, con stato, numero di tentativi, tipo di attività e motivo dell’errore. Se un’attività è poi riuscita dopo un errore, l’errore è contrassegnato come tentativo precedente.
- Cronologia della configurazione di ricerca: provider, stato ed elenco dei Campi di ogni configurazione di copertura precedente.
- Cronologia dei suggerimenti: suggerimenti accettati, ignorati o sostituiti.
Finché una Tabella ha un’attività accodata o in esecuzione, i pulsanti per configurare la ricerca e creare indici restano disabilitati. Attendi la fine dell’attività.