Acelere las consultas de ownCloud 10 gestionando los índices de forma segura.

Para ownCloud 10, comience aplicando los cambios de esquema proporcionados por el núcleo y las aplicaciones instaladas, y luego verifique qué consultas a la base de datos son realmente lentas. No agregue índices a ciegas ni asuma que el comando Nextcloud db:add-missing-indiceses un comando de reparación compatible con ownCloud 10: la referencia actual de ownCloud Server 10.15 OCC no lo documenta. Los índices pueden acelerar las lecturas coincidentes, pero cada índice agregado consume almacenamiento y aumenta la carga de trabajo en las inserciones, actualizaciones y eliminaciones.

Este enfoque es adecuado para un administrador que experimenta lentitud en la página, el listado de archivos o el funcionamiento de una aplicación de ownCloud, y que puede acceder al servidor y a la base de datos. Si la instancia completa es lenta o se ejecuta en SQLite con varios usuarios activos, revise la base de datos y la configuración de la implementación antes de considerar los índices como la causa del problema.

Elija el cambio que coincida con la evidencia.

Un índice de base de datos es una estructura auxiliar que ayuda a la base de datos a localizar filas sin necesidad de escanear toda la tabla. ownCloud y sus aplicaciones definen tablas, columnas e índices como parte de su esquema. Las actualizaciones del núcleo y de las aplicaciones pueden incluir migraciones de esquema que crean o modifican dichos índices. Por lo tanto, mantener actualizado el esquema de la aplicación es el primer paso más seguro.

Utilice las siguientes distinciones antes de realizar cualquier cambio:

• Advertencia del administrador o problema de actualización conocido: ejecute el procedimiento de actualización normal de ownCloud y revise el resultado. Las migraciones de actualización son la vía compatible para los cambios de esquema proporcionados por ownCloud o una aplicación.
• Una consulta lenta conocida con un plan de ejecución ineficiente: un administrador de la base de datos debe inspeccionar la consulta y el plan. Un índice específico puede ser útil, pero las columnas y el orden propuestos deben coincidir con la consulta y la definición de la tabla.
• Cargas lentas, bloqueos o contención generalizada: investigue las transacciones, la latencia del almacenamiento, la capacidad de la base de datos y el bloqueo de archivos. Estos síntomas por sí solos no demuestran la falta de un índice.
• Instalación pequeña de SQLite para uso multiusuario: considere migrar a MySQL/MariaDB o PostgreSQL. ownCloud describe SQLite como adecuado para pruebas y pequeñas cargas de trabajo de un solo usuario, mientras que las implementaciones multiusuario en producción deberían usar una base de datos de servidor compatible.

Un índice no es una solución general para aumentar la velocidad. Si bien un mayor número de índices puede mejorar ciertas búsquedas, también puede incrementar el tamaño de la base de datos y la latencia de escritura. El resultado depende de la estructura de la consulta, el tamaño de la tabla, la distribución de los datos, el motor de la base de datos y el estado de la caché.

Prepare una ventana de mantenimiento segura

1. Registre las versiones exactas y la base de datos. Desde el directorio de instalación de ownCloud, ejecute sudo -u www-data ./occ status. Anote la versión de ownCloud, las versiones de las aplicaciones instaladas, el tipo de base de datos y el prefijo de la tabla de config/config.php. Reemplace www-datacon la cuenta del servidor web en su distribución.
2. Registra la operación lenta. Anota la pantalla o aplicación afectada, el tiempo aproximado y si la demora se repite. Revisa los registros de ownCloud y el diagnóstico de consultas lentas de tu base de datos. Habilita el registro de consultas solo según las indicaciones del proveedor de tu base de datos, ya que los registros pueden contener valores SQL confidenciales y crecer rápidamente.
3. Realice una copia de seguridad de la base de datos y la configuración. Utilice un método de copia de seguridad que sea coherente con la base de datos y confirme que la copia de seguridad sea legible. La documentación de copias de seguridad de ownCloud utiliza mysqldump --single-transactioncomo ejemplo bases de datos compatibles con MySQL; adapte los valores de host, usuario y base de datos a su configuración. No introduzca la contraseña de la base de datos directamente en el historial de la consola ni en la lista de procesos.
4. Planifique los cambios con responsabilidad. Una actualización de esquema o la creación de índices puede consumir E/S de disco, CPU y bloqueos. En instalaciones con mucha actividad o de gran tamaño, informe a los usuarios sobre el período de tiempo necesario y supervise la carga de la base de datos. Utilice el modo de mantenimiento de ownCloud solo cuando el procedimiento de actualización o mantenimiento correspondiente lo requiera; no lo habilite como sustituto de una copia de seguridad.

Primero, aplique las actualizaciones de esquema administradas por ownCloud.

Si hay una actualización pendiente del núcleo o de la aplicación ownCloud, utilice el proceso de actualización documentado para su método de instalación. En una instalación convencional de Linux, el comando OCC se ejecuta como el usuario HTTP desde el directorio raíz de ownCloud. Al seguir las instrucciones de actualización manual, el comando es:

sudo -u www-data ./occ upgrade

No lo ejecute en una instalación cuyos archivos se hayan actualizado solo parcialmente. Primero, prepare los archivos de la versión correspondiente y siga los pasos de actualización oficiales para esa versión. Para implementaciones de Docker, utilice la invocación OCC documentada del contenedor en lugar de una ruta de host que apunte a un entorno PHP diferente.

Lea la salida completa del comando y los registros. Un comando exitoso debería finalizar sin que se reporte ningún error de migración; sin embargo, esto no garantiza que se solucionen todas las consultas lentas. Si la actualización reporta un error de migración, deténgase e investigue dicho error en lugar de ejecutar repetidamente el comando o editar manualmente las tablas del esquema. Consulte la documentación de actualización de ownCloud específica de la versión y al responsable del mantenimiento de la aplicación cuando se requiera una migración de la aplicación.

La referencia de ownCloud 10.15 OCC enumera comandos de base de datos como db:convert-type, db:convert-mysql-charset, y db:restore-default-row-format, pero no enumera db:add-missing-indices. Dado que la disponibilidad de comandos puede variar según la versión y el código instalado, puede inspeccionar su propia instancia con sudo -u www-data ./occ list dbo sudo -u www-data ./occ help db:add-missing-indices. Si este último informa un comando desconocido, no copie el comando de un tutorial de Nextcloud en ownCloud. Consulte la documentación para su versión exacta de ownCloud y utilice la ruta de actualización o migración de aplicación compatible.

¿Cuándo resulta apropiado un índice manual?

La consulta SQL manual es una opción para el administrador de la base de datos en caso de un problema de consulta verificado, no una optimización rutinaria de ownCloud. Primero, capture la consulta lenta exacta y ejecute la herramienta de inspección del plan del motor, como EXPLAINla de MySQL/MariaDB o PostgreSQL. Confirme si el plan escanea una cantidad innecesariamente grande de filas y si se está ignorando un índice existente. El prefijo de tabla de ownCloud es configurable, así que nunca asuma que los nombres de las tablas comienzan con oc_.

Antes de crear un índice, compare las columnas propuestas con los filtros, las uniones y el orden de clasificación de la consulta. El orden de las columnas de un índice compuesto es importante; duplicar un índice existente puede aumentar el costo sin mejorar el plan. Consulte con un administrador de bases de datos para que tenga en cuenta el comportamiento de la versión de la base de datos, la compatibilidad con la creación de índices en línea o simultánea, el espacio disponible en disco, el impacto de los bloqueos y el procedimiento de reversión. Estos detalles dependen del motor y la versión, por lo que no existe una única instrucción SQL segura para todas las instalaciones de ownCloud 10.

No modifique las tablas de ownCloud ni elimine índices solo porque un nombre parezca redundante. Estos cambios pueden entrar en conflicto con una migración posterior del núcleo o de la aplicación, y pueden dañar una función que utilice una consulta diferente a la que inspeccionó. Mantenga un registro escrito de cualquier cambio manual en el esquema y asegúrese de que se pueda recrear después de la restauración o migración. Si el índice faltante es un defecto del esquema del producto, utilice un parche o una versión de la aplicación de ownCloud compatible.

Comparar alternativas a nivel de base de datos

Si el plan ya utiliza un índice adecuado, es poco probable que añadir otro solucione un retraso causado por otro motivo. Compare estas opciones con el cuello de botella observado:

• MySQL o MariaDB: una opción común para implementaciones cuyos administradores ya utilizan estos motores. Antes de modificar la configuración del servidor, revise la memoria del grupo de búferes, la latencia del disco, las conexiones y los planes de consultas lentas.
• PostgreSQL: una alternativa compatible con ownCloud 10 donde el conector de base de datos PHP y la implementación estén configurados correctamente. Sus planes de consulta y herramientas de mantenimiento de índices difieren de MySQL, por lo que se recomienda seguir las recomendaciones específicas de PostgreSQL.
• SQLite: fácil de usar para pruebas o para un solo usuario, pero no es la opción predeterminada para una carga de trabajo de producción concurrente y multiusuario. La optimización de índices no elimina las limitaciones de concurrencia de la implementación.

Cambiar el motor de la base de datos es un proyecto de migración, no un simple ajuste de índice. ownCloud ofrece occ db:convert-typeconversiones compatibles; revise sus requisitos previos, haga una copia de seguridad primero y pruebe la instancia convertida antes de que los usuarios accedan a ella.

Verifica el resultado y detente si la evidencia no lo confirma.

Repita la misma acción del usuario en condiciones similares y compare la duración de la consulta, el plan de ejecución, las filas examinadas, la E/S de la base de datos y la carga del servidor. Confirme que la página o aplicación de ownCloud correspondiente se complete correctamente y que los registros no muestren errores de base de datos ni de migración. Un resultado más rápido en una solicitud no demuestra una mejora general; compare varias solicitudes representativas y tenga en cuenta las cachés activas.

Si la misma consulta sigue siendo lenta incluso utilizando un índice adecuado, investigue los bloqueos, el almacenamiento, la latencia de la red, los procesos PHP y los límites de recursos de la base de datos. Si el plan de consulta o la estructura de la tabla no están claros, deténgase antes de ejecutar DDL manual y solicite a un administrador de bases de datos o al soporte de ownCloud que lo revise. El resultado óptimo es un esquema alineado con la versión de ownCloud instalada y las consultas medidas, sin cambios de índice no registrados.

Referencias oficiales

• Referencia de comandos OCC de ownCloud Server 10.15
• Procedimiento de actualización manual de ownCloud Server 10.15
• Guía de conversión de base de datos de ownCloud Server 10.15
• Documentación de copia de seguridad de ownCloud Server 10.15
• Documentación de administración de ownCloud Server 10.15