Los cambios de configuración de búsqueda e índices se ejecutan de forma asíncrona en segundo plano. Después de enviarlos, confirma el resultado en Historial.
La observación de consultas está desactivada de forma predeterminada. Establece
V2_TABLE_QUERY_OPS_ENABLED en true en el backend y reinícialo para empezar a recopilar 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.
Usa Elegir una tabla en la parte superior para cambiar de tabla. La selección se mantiene al pasar a Complejidad o Integridad del esquema; Actualizaciones calculadas muestra la cola de toda la instancia.
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.
Cuando un aviso en la parte superior de la página informa de Tablas cuyo índice de búsqueda configurado no está en servicio, la búsqueda en esas Tablas recurre a ILIKE. Si además indica que el worker de tareas está desactivado, define V2_TABLE_QUERY_OPS_TASK_WORKER_ENABLED como true en el backend y reinicia para que los índices puedan reconstruirse.
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 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 Historial. Si vuelves a enviar el mismo cambio, se devuelve la tarea existente.
Gestionar los índices de filtro y orden
La pestaña Índices enumera los índices de filtrado/ordenación y del sistema, con su validez, gestión, tamaño y definición. Los índices de búsqueda de subcadenas aparecen por separado en Búsqueda. 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 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 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.
Evaluar el impacto de los cambios
Actualizar registros puede activar más cálculos en fórmulas, búsquedas y acumulaciones a través de registros vinculados. Para evaluar si una escritura por lotes, conversión o eliminación de campos afectará a muchos datos, abre Complejidad y elige una tabla, o pulsa Evaluar complejidad en sus detalles de búsqueda e índices. La Matriz de impacto estima las actualizaciones, eliminaciones y conversiones de cada campo, además de la creación y eliminación de registros por separado. El punto de la izquierda representa el caso típico y el relleno, el peor caso. Pulsa una celda para consultar filas afectadas, rutas de propagación, limitaciones y recomendaciones. Revisa primero los cambios Alto o Crítico para decidir si reducir los lotes o ajustar las dependencias de cálculo. En Ajustes de estimación, establece Registros por cambio en la cantidad que enviarás cada vez; si lo dejas vacío, se estima un registro. Usar estadísticas del catálogo está activado de forma predeterminada y lee el tamaño de las tablas y el número de vínculos para mejorar la estimación.La evaluación solo lee estructuras y estadísticas. No modifica registros ni campos ni predice el tiempo de ejecución. Si aparece No estimado, o la calidad es Parcial o Truncada, revisa las limitaciones y completa la información antes de decidir. La ausencia de una estimación no implica ausencia de riesgo.