Borrar la advertencia de Nextcloud sobre índices de base de datos faltantes

Elimine la advertencia de Nextcloud "Faltan algunos índices en la base de datos" ejecutando occ db:add-missing-indicesel comando como usuario del servidor web desde la instalación correcta de Nextcloud. El comando agrega los índices definidos por Nextcloud o las aplicaciones instaladas que no se encuentran en la base de datos; según la documentación actual de Nextcloud 35, --dry-runmuestra una vista previa del código SQL antes de su ejecución.

Qué significa la advertencia

Un índice de base de datos es una estructura de búsqueda que permite a la base de datos encontrar filas sin necesidad de escanear toda la tabla. Nextcloud y sus aplicaciones a veces añaden índices para mejorar las consultas. Una actualización puede dejar esta tarea a cargo del administrador, ya que crear un índice en una tabla grande puede llevar tiempo y afectar al rendimiento durante su ejecución. La advertencia de índice faltante suele ser una notificación de mantenimiento, no una prueba de que los archivos o los registros de la base de datos estén dañados.

La documentación actual de Nextcloud sobre comandos de base de datos describe db:add-missing-indicescómo agregar índices que se encuentran en el esquema esperado, pero que no están presentes en la instalación actual. El manual también documenta --dry-runcómo previsualizar sentencias SQL. Los índices exactos dependen de la versión de Nextcloud y de las aplicaciones instaladas.

Preparar el servidor

• Confirma qué instancia de Nextcloud muestra la advertencia, especialmente si administras entornos de prueba y producción o más de un contenedor.
• Asegúrese de que exista una copia de seguridad reciente de la base de datos y de que sepa cómo restaurarla. Este comando modifica la estructura de la base de datos. No edite ni elimine índices manualmente como alternativa.
• Se recomienda ejecutar el comando cuando la carga de la base de datos sea razonable. Según las directrices de actualización de Nextcloud, el servidor puede permanecer en línea para esta operación, pero la indexación de una tabla grande puede llevar tiempo y afectar temporalmente la velocidad de respuesta.
• Localiza el directorio de instalación de Nextcloud, la versión de PHP CLI que utiliza el servidor web y la cuenta del sistema operativo del servidor web. Esta cuenta suele estar www-dataen Debian o Ubuntu, apacheen Fedora o CentOS, y httpen Arch Linux.

La guía OCC de Nextcloud explica que occes la interfaz de línea de comandos del servidor y debe ejecutarse como el usuario HTTP para que la propiedad y los permisos de los archivos se mantengan consistentes. No la utilice www-dataindiscriminadamente si su instalación usa una cuenta diferente.

Previsualiza y añade los índices que faltan.

Para una instalación estándar de archivo en Debian o Ubuntu, abra una consola en el servidor Nextcloud y cambie al directorio que contiene el occarchivo. Este ejemplo utiliza /var/www/nextcloud; su ruta puede ser diferente.

cd /var/www/nextcloud
sudo -E -u www-data php occ db:add-missing-indices --dry-run

La prueba en seco imprime la consulta SQL que se ejecutaría sin modificar la base de datos. Lea el resultado y confirme que se trata de la operación de mantenimiento prevista. Esta --dry-runopción está documentada en el manual actual de Nextcloud 35; si una versión anterior la rechaza, consulte la ayuda de comandos de dicha versión en lugar de eliminar opciones al azar.

Cuando esté listo para aplicar el cambio, ejecute el comando sin --dry-run:

sudo -E -u www-data php occ db:add-missing-indices

Nextcloud comprueba las tablas relevantes e informa del progreso. Deje que finalice; no interrumpa el proceso solo porque una tabla grande tarde más de lo previsto. El manual de actualización incluye este comando entre las tareas de esquema más largas que pueden ejecutarse mientras la instancia permanece en línea, por lo que normalmente no es necesario activar el modo de mantenimiento para esta reparación. Evite realizar tareas de mantenimiento de la base de datos simultáneamente mientras se esté ejecutando.

Si Nextcloud se ejecuta en Docker

Ejecútalo occen el contenedor de la aplicación Nextcloud, no en el contenedor de la base de datos independiente. Para un contenedor nextcloudcon el nombre de la cuenta habitual www-data, el comando suele ser:

docker exec --user www-data -it nextcloud php occ db:add-missing-indices

Sustituya esto nextcloudpor el nombre real del contenedor de su aplicación. Si su imagen o implementación utiliza un usuario de contenedor, un binario PHP o un envoltorio de comando diferente, siga la documentación de esa imagen y mantenga el comando ejecutándose como el usuario HTTP.

Verifica que la advertencia haya desaparecido.

Una vez finalizado el comando, actualice la configuración de administración > Resumen . El mensaje de índice faltante debería desaparecer cuando Nextcloud reconozca los índices. También puede volver a ejecutar el comando; debería finalizar sin necesidad de agregar nuevamente los mismos índices faltantes. Esto confirma que la verificación del esquema se ha actualizado, aunque no mide el rendimiento general de la base de datos.

Si la advertencia permanece

1. Confirma que ejecutaste el comando en la misma instalación de Nextcloud y base de datos que generó la advertencia. Un error común es ejecutarlo en un contenedor de mantenimiento, una instancia de prueba o un contenedor de base de datos.
2. Verifique que el comando se haya ejecutado con el usuario correcto del servidor web y que haya utilizado la misma versión de PHP que el servidor web. Nextcloud advierte que una configuración de PHP diferente en la interfaz de línea de comandos (CLI) puede provocar occerrores.
3. En Nextcloud 35 y versiones posteriores, ejecute este comando sudo -E -u www-data php occ db:schema:checkpara inspeccionar las diferencias de esquema. La documentación actual indica que esta comprobación se añadió en la versión 35. En versiones anteriores, utilice las herramientas de diagnóstico documentadas para dicha versión.
4. Si el índice que falta pertenece a una aplicación de terceros o el comando informa un error, actualice la aplicación si hay una actualización disponible, revise el registro de Nextcloud y la salida del comando, y solicite al responsable de la aplicación o al soporte de Nextcloud los nombres exactos del índice y la tabla. No ejecute CREATE INDEXinstrucciones escritas manualmente a menos que el responsable de la aplicación o de la base de datos se las proporcione para su esquema específico.

Para un servidor de producción, conserve la copia de seguridad de la base de datos hasta que se elimine la advertencia y la aplicación funcione con normalidad. La guía de actualización de Nextcloud cubre la tarea de mantenimiento en línea y la prueba de simulación opcional.