> ## Documentation Index > Fetch the complete documentation index at: https://help.teable.ai/llms.txt > Use this file to discover all available pages before exploring further. # Operaciones de consulta de Tablas > Revisa la cobertura de búsqueda y los índices Tabla por Tabla, configura la búsqueda, crea índices y sigue los resultados. Disponible para el plan Business autoalojado y los planes superiores Ruta: Administración del sistema → Operaciones de consulta de Tablas Usa **Búsqueda e índices de Tablas** cuando las Vistas, los filtros, las relaciones o las búsquedas de una Tabla grande se vuelvan lentos. Teable observa la carga de consultas en segundo plano y resume cada Tabla: cómo se busca actualmente, qué Campos están cubiertos, qué índices físicos existen y cuántas consultas lentas se registraron hace poco. Los administradores de la instancia configuran aquí la cobertura de búsqueda, crean índices y siguen los resultados. 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: | Estado | Significado | | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Todas las Tablas** | Todas las Tablas observadas. | | **Requiere atención** | Tablas con consultas lentas, tiempos de espera agotados, recomendaciones pendientes o tareas fallidas. Empieza por aquí. | | **Búsqueda indexada** | Tablas cuyos metadatos de índice están publicados y utilizables y cuyo interruptor de ejecución está activado, de modo que la búsqueda usa realmente el índice. | | **Búsqueda configurada** | Tablas con una configuración de búsqueda guardada o con metadatos de índice, incluidas las que aún no se han publicado. | | **Sin configurar** | Tablas sin cobertura de búsqueda. | | **No disponible** | Tablas que ahora mismo no pueden usar la búsqueda indexada. La fila indica el motivo. | 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: | Estado | Significado | Qué hacer | | ------------------------------------------ | ----------------------------------------------------------------------- | --------------------------------------------------------------------- | | **Sin configurar** | No hay configuración de búsqueda guardada ni metadatos de índice. | Elige **Configurar búsqueda** si la Tabla necesita búsqueda indexada. | | **Configurado · pendiente de publicación** | La configuración está guardada; el índice aún no se ha publicado. | Comprueba en **Tareas / historial** si queda alguna tarea en curso. | | **Publicado · listo** | Los metadatos del índice están publicados y son utilizables. | No hay nada que hacer. | | **Metadatos inutilizables** | Los metadatos del índice están dañados y no pueden atender la búsqueda. | Vuelve a ejecutar **Actualizar selección / reconstruir**. | 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. Elige **Configurar búsqueda** en una Tabla que nunca se haya configurado, o **Actualizar selección / reconstruir** en una que sí, que abre con el proveedor y la selección de Campos guardados la última vez. El cuadro de diálogo pide: | Elemento | Qué introducir | | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Proveedor de búsqueda** | `pg_bigm` o `pg_trgm`. Si falta la extensión, el cuadro de diálogo indica qué falta y quién puede instalarla. | | **Texto de búsqueda representativo** | Un texto que tus usuarios buscarían de verdad. Sirve para comprobar la semántica de subcadena y recoger pruebas del plan, y nunca se guarda. Si es demasiado corto, el cuadro de diálogo indica la longitud mínima. | | **Campos** | Selecciona los Campos que los usuarios buscan realmente. No lo selecciones todo en una Tabla ancha: crear un documento de búsqueda para cada Campo sale caro. | **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**. Crear o reconstruir la cobertura de búsqueda genera una columna de búsqueda y un índice GIN. Puede reescribir toda la Tabla y mantener bloqueos, y la búsqueda indexada se interrumpe brevemente mientras se ejecuta. Prográmalo dentro de una ventana de mantenimiento. 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 ejecuta `CREATE 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. El historial solo carga las entradas más recientes. Si hay más, una línea sobre la lista indica el total. 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.