Revisar recomendaciones
La página se abre en Recomendaciones, ordenadas por prioridad. El analizador pondera el riesgo de una consulta según la intensidad de uso de la Tabla, por lo que las entradas que más conviene atender aparecen primero. Busca por ID de Tabla, Base o Espacio para filtrar todas las recomendaciones; cualquier otro texto filtra lo que ya aparece en pantalla. Los filtros de estado y riesgo permiten acotar aún más la lista. Cada entrada indica el Espacio, la Base y la Tabla a los que pertenece. Expande una fila para consultar las pruebas que respaldan la recomendación, la decisión del sistema y los diagnósticos SQL:
Análisis profundo abre el Espacio de trabajo de análisis con esa Tabla ya introducida.
Cuando el analizador detecta un uso intensivo de búsquedas de subcadenas en una Tabla, genera una única recomendación de GIN de texto generado para toda la Tabla, en lugar de un índice por Campo. Esa fila ofrece Crear ruta de búsqueda en lugar de Análisis profundo, y Añadir índice no aparece porque las rutas de acceso de búsqueda se aplican desde el Espacio de trabajo de análisis y requieren primero una Búsqueda de muestra con EXPLAIN. La recomendación se cierra automáticamente cuando la Tabla dispone de la ruta.
Hay otras dos pestañas junto a ella:
Aparece un banner sobre la lista cuando un problema de configuración está bloqueando el proceso: hay rutas de acceso de búsqueda configuradas mientras el indicador del entorno de ejecución está desactivado; algunas Tablas tienen una ruta de acceso obsoleta o pendiente de reconstrucción y su búsqueda ha vuelto silenciosamente al análisis
ILIKE, que es más lento; o la tarea más antigua de la cola lleva tanto tiempo esperando que parece que ningún proceso de trabajo la está consumiendo. Corrige el problema indicado en el banner antes de actuar sobre las recomendaciones que aparecen debajo.
Interpretar el distintivo de decisión
Cada recomendación incluye la decisión más reciente que el sistema ha tomado al respecto:De forma predeterminada, Teable solo registra las decisiones y crea registros de recomendaciones y tareas; no modifica la base de datos por sí solo. La ejecución automática se habilita de forma voluntaria mediante
V2_TABLE_QUERY_OPS_AUTO_ACCEPT=auto y, aun así, solo se aplica a Tablas pequeñas cuyo plan de ejecución muestra una mejora clara de costes. Todo lo demás queda pendiente de un administrador.Añadir el índice propuesto
Cuando estés de acuerdo con el índice propuesto por una recomendación, haz clic en Añadir índice en la fila. Al confirmar, se acepta la recomendación y se ejecutaCREATE INDEX CONCURRENTLY en la Tabla PostgreSQL subyacente; si se omitió la validación del plan, Teable crea igualmente el índice a partir de los Campos recomendados. El cuadro de diálogo repite las pruebas para que puedas comprobarlas una última vez.
En las Tablas con una estimación de 50 000 filas o más, el cuadro de diálogo te pide que confirmes la existencia de una ventana de mantenimiento antes de habilitar el botón. La creación simultánea en una Tabla grande requiere tiempo y añade carga mientras se ejecuta.
Teable informa entonces de que el Índice se ha creado o de que la Recomendación se ha aceptado y añadido a la cola. En el segundo caso, sigue la tarea en Tareas. Si la recomendación no tiene ninguna columna física ejecutable asociada, Añadir índice permanece deshabilitado e indica el motivo; usa el Espacio de trabajo de análisis para investigar con más detalle.
Ejecutar un análisis profundo
Abre el Espacio de trabajo de análisis para analizar un ámbito cuando lo necesites, por ejemplo, cuando un usuario informe de una Tabla lenta para la que aún no haya ninguna recomendación.
Elige Tabla, Base o Espacio, introduce el ID correspondiente y selecciona un tipo de análisis. Empieza por Tabla cuando ya sepas qué Tabla es lenta.
Haz clic en Generar informe de consultas o Generar informe de búsqueda. El informe resume los riesgos detectados y las siguientes acciones recomendadas. En los informes de búsqueda, la Búsqueda de muestra con EXPLAIN es opcional. Añade una muestra para comprobar la compatibilidad de los resultados, los planes de consulta y los tiempos de consultas repetidas de la ruta de acceso propuesta para búsquedas de subcadenas. Teable no guarda el valor de muestra.
El informe de consultas no modifica la base de datos. Para aplicar una recomendación de búsqueda de subcadenas se necesita una Búsqueda de muestra con EXPLAIN y la confirmación de un administrador.