La página solo pone tareas en cola; nunca cambia la base de datos directamente. Cada cambio se ejecuta de forma asíncrona en segundo plano, así que confirma el resultado en Tareas / historial.
Las operaciones de consulta de Tablas están desactivadas de forma predeterminada. Define
V2_TABLE_QUERY_OPS_ENABLED como true en el backend y reinicia: la página empezará a acumular observaciones.Encontrar la Tabla que necesita atención
La página se abre con la lista de Tablas. Los botones de estado de la parte superior llevan su propio recuento y acotan la lista:
El cuadro de búsqueda admite nombres o identificadores de Tabla, Proyecto y Espacio. La ordenación puede ser Más consultas lentas o Nombre de Tabla. La Ventana de observación abarca la última hora o 24 horas, y todas las cifras de observación de la lista siguen esa ventana. Las observaciones se conservan 2 días; lo anterior deja de aparecer en la lista.
Cada fila muestra las filas y el tamaño estimados de la Tabla, las solicitudes y las consultas lentas de la ventana, el método de búsqueda actual y la cobertura de Campos, el número de índices de filtro/orden, y los recuentos de recomendaciones pendientes y tareas activas. Haz clic en el nombre de una Tabla para abrir su detalle.
Junto a los botones de estado, Acerca de los estados del índice explica cómo se calculan estos recuentos.
Leer el estado del índice
La lista de Tablas y el detalle muestran el estado del índice junto al método de búsqueda:
Bajo el estado pueden aparecer dos líneas. Configurado: pg_bigm / pg_trgm indica que el proveedor guardado no coincide con el método de búsqueda en uso, y Interruptor de ejecución de la búsqueda indexada: desactivado indica que el índice está listo pero la ejecución está apagada, así que la búsqueda sigue usando
ILIKE.
Que un índice esté publicado no significa que todas las búsquedas lo usen: un término demasiado corto o un Campo fuera de la cobertura siguen recurriendo a
ILIKE. Esta página refleja el estado del índice, no demuestra que las solicitudes recientes lo hayan usado.Configurar la cobertura de búsqueda
La pestaña Cobertura de búsqueda muestra el método de búsqueda actual de la Tabla, cuántos Campos están cubiertos y la Cobertura efectiva de cada Campo. Mostrar campos no cubiertos limita la lista a los Campos aún no incluidos; los Campos marcados como No apto no pueden formar parte de un índice de búsqueda por subcadena.La cobertura efectiva exige metadatos de índice publicados y utilizables y el interruptor de ejecución activado; una configuración guardada por sí sola no cuenta. La cobertura es explícita, así que los Campos que añadas después no se incluyen de forma automática: vuelve a configurar la Tabla para incorporarlos.
Analizar y simular ejecuta el cambio sin aplicarlo e informa del número de Campos cubiertos, las filas estimadas, si existen pruebas del plan y el impacto de crear o reconstruir. Las Tablas estimadas en 50.000 filas o más, y las de tamaño desconocido, requieren además marcar la confirmación de la ventana de mantenimiento. Después elige Confirmar y poner la tarea en cola.
Lo que devuelve el cuadro de diálogo es un acuse de recibo de la tarea, no un resultado. Ciérralo y sigue la tarea en Tareas / historial. Si vuelves a enviar el mismo cambio, se devuelve la tarea existente.
Gestionar los índices de filtro y orden
La pestaña Índices de filtro / orden enumera los índices físicos que sirven a las condiciones de filtro y a la ordenación de esta Tabla, cada uno con su validez, si lo gestiona Teable, su tamaño y su definición. Se gestionan por separado de los índices de búsqueda por subcadena. Debajo, Acciones pendientes reúne las recomendaciones de índice del sistema e indica si hay pruebas del plan que las respalden. Revisar creación de índice muestra el índice propuesto, la base de datos en la que se ejecuta y las pruebas; tras tu confirmación, Teable ejecutaCREATE INDEX CONCURRENTLY de forma asíncrona. Las Tablas grandes y las de tamaño desconocido también requieren aquí la confirmación de la ventana de mantenimiento.
Esta página no elimina índices. Los índices no gestionados y los del sistema pueden proteger restricciones o servir a otras cargas de trabajo, así que no se tocan.
Diagnosticar consultas concretas
Cuando alguien informa de una Tabla lenta y ninguna recomendación la cubre, abre la pestaña Diagnóstico de consultas y elige Analizar consultas. El análisis solo lee las formas de consulta guardadas y las pruebas de plan disponibles; no crea nada. La conclusión es Se encontraron oportunidades de índice respaldadas por el plan, Ningún plan disponible confirma una oportunidad de índice o Pruebas insuficientes. Que las pruebas sean insuficientes no significa que se produjera un escaneo secuencial: una observación lenta por sí sola no demuestra que la ruta de acceso sea la causa. Debajo se enumera cada consulta afectada, si procede del tráfico real o de una configuración de Vista guardada, y el coste de plan estimado antes y después del índice propuesto (coste de plan, no milisegundos).Seguir los resultados
La pestaña Tareas / historial tiene tres partes:- Tareas: las tareas en segundo plano de esta Tabla, con estado, número de intentos, tipo de tarea y motivo del fallo. Si una tarea acabó completándose tras fallar, el error se marca como intento anterior.
- Historial de configuración de búsqueda: el proveedor, el estado y la lista de Campos de cada configuración de cobertura anterior.
- Historial de recomendaciones: recomendaciones aceptadas, descartadas o sustituidas.
Mientras una Tabla tenga una tarea en cola o en ejecución, los botones para configurar la búsqueda y crear índices permanecen deshabilitados. Espera a que termine la tarea.