Una base de datos grande de Home Assistant no necesita reemplazarse automáticamente. El aumento de tamaño, un historial lento o un archivo que sigue siendo grande después de la purga suelen requerir primero ajustes de retención, filtrado, almacenamiento o compactación. El reemplazo resulta más razonable cuando la base de datos no se puede abrir de forma constante, aparecen repetidos errores de integridad o Home Assistant ya la ha aislado como dañada.
Separa la «necesidad de mantenimiento» de la «pérdida de confiabilidad del estado». La primera categoría debería conservar el historial útil. La segunda debería proteger la base de datos dañada, restaurar una copia conocida como buena o iniciar una nueva base de datos de Recorder, e investigar por qué ocurrió la corrupción antes de reanudar las escrituras normales.
El crecimiento rápido es una señal de mantenimiento antes que de reemplazo
Comprueba el tamaño estimado de Recorder y el crecimiento diario. Si unas pocas entidades ruidosas, una retención prolongada del historial sin procesar o eventos innecesarios dominan la base de datos, reduce la carga entrante antes de eliminar todo el archivo.
La guía actual de almacenamiento de Home Assistant recomienda purgar los datos antiguos de Recorder, filtrar lo que se registra y ajustar la retención cuando la base de datos se vuelve demasiado grande.
Si el crecimiento se ralentiza después de cambiar los filtros o la retención, es posible que la base de datos esté en buen estado. Continúa supervisándola en lugar de restablecer el historial simplemente porque el tamaño absoluto del archivo parezca incómodo.
Un archivo grande después de la purga puede necesitar compactación, no reemplazo
Eliminar filas antiguas puede liberar espacio dentro de la base de datos para reutilizarlo sin reducir el tamaño del archivo en el disco. La compactación reescribe la base de datos para que se pueda recuperar espacio del sistema de archivos.
Ejecuta este proceso únicamente con suficiente espacio libre y una copia de seguridad probada. Una base de datos lenta o grande durante la compactación no demuestra que los datos deban descartarse.
Los errores repetidos de formato incorrecto o integridad son señales de advertencia más contundentes
Los errores de base de datos, como páginas con formato incorrecto, comprobaciones de integridad fallidas, errores de E/S repetidos o corrupción que reaparece después de una restauración limpia, requieren una respuesta diferente al crecimiento normal. Conserva el archivo y detén el mantenimiento destructivo mientras determinas si el almacenamiento, la pérdida de energía, la presión de memoria o el sistema de archivos están contribuyendo.
La corrupción irrecuperable de SQLite es un evento de recuperación, no una condición normal de mantenimiento: Home Assistant puede apartar una base de datos de Recorder dañada e iniciar una nueva para que el resto del sistema permanezca en línea. Esta es una señal de reemplazo mucho más contundente que el crecimiento normal del tamaño o las consultas lentas del historial.
Si necesitas una comprobación de SQLite de bajo nivel, PRAGMA integrity_check puede examinar la coherencia de la base de datos. Trabaja sobre una copia o durante una ventana de mantenimiento controlada cuando utilices herramientas manuales de bases de datos.
El reemplazo tiene sentido cuando no se puede confiar en el estado de Recorder
Reemplazar significa restaurar una base de datos conocida como buena o permitir que Home Assistant cree una nueva cuando conservar el historial sea menos importante que devolver Recorder al servicio. No es una optimización de rendimiento de primera línea.
Elige el reemplazo cuando la base de datos falle repetidamente al abrirse, la corrupción persista tras los intentos normales de recuperación, una copia de seguridad conocida como buena sea más segura que la reparación, o perder el historial antiguo sea aceptable y el estado de la configuración sea saludable.
La guía de ZimaSpace sobre capturar el estado antes de realizar tareas de mantenimiento de aplicaciones arriesgadas resulta útil aquí: conserva un recurso de reversión antes de purgar, compactar, reparar SQL manualmente o reemplazar la base de datos.
Usa el patrón de fallo para elegir la siguiente acción
| Síntoma | Primera acción | ¿Reemplazar? |
|---|---|---|
| La base de datos crece rápidamente | Filtrar entidades ruidosas / acortar la retención | No |
| El archivo sigue siendo grande después de la purga | Planificar la compactación con margen de espacio libre | No |
| Las consultas del historial son lentas durante la contención del disco | Medir la latencia del almacenamiento | Normalmente no |
| Errores de formato incorrecto o integridad | Conservar el archivo, comprobar el almacenamiento y restaurar/probar una copia | Posiblemente |
| Corrupción repetida después de la recuperación | Investigar el almacenamiento y la energía, y restaurar un estado conocido como bueno | A menudo |
No elimines home-assistant_v2.db únicamente porque Home Assistant parezca lento. Determina primero si el problema es el volumen de datos, el mantenimiento, el tiempo de servicio del almacenamiento o una corrupción real.
Preguntas frecuentes
¿Debería eliminar home-assistant_v2.db para que Home Assistant sea más rápido?
Por lo general, no. Eliminarlo descarta el historial de Recorder y puede ocultar la causa real. Reduce los registros innecesarios, comprueba el almacenamiento y el espacio libre, y utiliza la purga o la compactación de forma adecuada antes de elegir el reemplazo.
Soporte y Consejos
Más para leer

¿Cuántos usuarios simultáneos puede gestionar Home Assistant antes de ralentizarse?
Home Assistant no tiene un límite fijo de usuarios que resulte útil: evalúa el rendimiento con clientes activos, paneles reales y actualizaciones de entidades,...

¿Puede Home Assistant usar una base de datos externa sin complicar las actualizaciones?
Una base de datos externa de Recorder puede sobrevivir a las actualizaciones, pero añade sus propias responsabilidades de disponibilidad, migración de esquemas, copias de...

Cómo comprobar si el DNS está provocando fallos de conexión con Home Assistant
Demuestra un fallo de DNS de Home Assistant probando el mismo nombre de host desde la ruta afectada, comparando la accesibilidad directa mediante IP...

