Declaración de integridad de datos

Este documento responde a tres preguntas: qué contiene exactamente tu copia, si puedes fiarte de ella y en qué casos no estará completa.

Resumen

Cada copia es una copia completa.
Una copia incluye páginas, bases de datos y fuentes de datos, vistas de bases de datos, filas de bases de datos, bloques, comentarios (se pueden activar o desactivar), usuarios, archivos adjuntos y archivos multimedia externos (se pueden activar o desactivar).
El mismo contenido se guarda una sola vez. Los datos en sí y los archivos independientes se almacenan deduplicados, y borrar una versión no daña los archivos que otras versiones siguen usando.
Cada copia produce un informe completo, con el recuento de páginas, bases de datos, filas de bases de datos, bloques, comentarios, vistas y usuarios, además de avisos o errores.
La exportación y la importación del archivo llevan verificación de integridad.
La integridad tiene límites: el contenido fuera de los permisos de la integración, los campos que la Notion API no devuelve, unos pocos problemas conocidos del lado de Notion y el límite de objetos por tarea de la versión gratuita.

1. Qué contiene una copia

Una copia incluye:

Páginas: cuerpo, propiedades, icono, portada y relaciones de jerarquía
Bases de datos y fuentes de datos: estructura de propiedades, opciones y relaciones
Vistas de bases de datos: la configuración de cada vista (tabla, tablero, calendario, cronograma, galería, lista, etc.) y sus condiciones de filtro, orden y agrupación
Filas de bases de datos: los valores de propiedad de cada fila
Bloques (el contenido del cuerpo): formato en línea y estructura anidada
Comentarios: los comentarios sin resolver sobre un archivo o un bloque. La Notion API no devuelve los comentarios resueltos, así que no se pueden copiar. Puedes activar o desactivar la copia de comentarios
Usuarios: la información de los colaboradores que aparece en el contenido, para reconstruir «quién lo escribió»
Archivos adjuntos: imágenes y archivos alojados en Notion
Archivos multimedia externos: archivos externos enlazados en las páginas, como PDF, imágenes o vídeos. Puedes activar o desactivar la descarga de estos archivos

Los archivos que se descargan se actualizan a referencias relativas dentro del repositorio, así que mover el directorio del repositorio o cambiar de máquina no rompe ninguna referencia.

Todo esto se guarda en el directorio de repositorio que indiques. Las instantáneas estructuradas están en el archivo de base de datos local del repositorio, y los archivos descargados, en el directorio attachments del repositorio.

2. Cómo se garantiza la integridad

Captura completa. Cada copia recorre entero el ámbito que compartes con la integración y vuelve a confirmar el estado actual de cada objeto, uno por uno. La Notion API no ofrece un flujo de cambios fiable, así que en teoría no se puede hacer una copia incremental que garantice la integridad.

Omisión en la escritura. Una captura completa no es una reescritura completa: las instantáneas cuyo contenido no ha cambiado no hace falta reescribirlas, y el mismo contenido no se almacena dos veces. Los recuentos de «cambios / omitidos» del informe describen justo esa diferencia.

Seguridad ante fallos. Si el dispositivo se queda sin corriente o el programa se cierra a mitad de una copia, la tarea puede reanudarse sin peligro y no daña la integridad de los datos que ya había.

Deduplicación por contenido. El contenido de los bloques se guarda según el hash de su contenido y se cuentan las referencias.

Deduplicación de archivos independientes. Los archivos adjuntos se deduplican por un identificador de archivo estable.

Informe de la copia. Al terminar la copia se muestra un recuento: el número de páginas, bases de datos, filas de bases de datos, bloques, comentarios, vistas y usuarios, además de los cambios y las omisiones, los fallos y los avisos.

Exportación e importación del archivo. El archivo de todo el repositorio (una exportación en un solo archivo para copias en frío) vuelca antes de exportarse las escrituras pendientes de la base de datos del repositorio, de modo que el archivo contiene un estado completo y coherente. Al importarlo se verifica primero la integridad de la base de datos que hay dentro; si la verificación falla, se muestra un error y no se importa.

3. Límites de la integridad

Alcance de la copia. NotionManager ofrece un control más fino: puedes elegir qué se copia. El contenido que no compartes con la integración o que dejas fuera del alcance de la copia no se recorre.

Límites conocidos de la Notion API:

Tipos de bloque no admitidos. La documentación de la Notion API indica claramente que algunos tipos de bloque no son compatibles, y los datos de esos bloques no están disponibles para ninguna aplicación que dependa de la Notion API.
Estilos de vista y propiedades que se pueden mostrar, entre otros: solo afectan a cómo se ve la copia al navegarla en local.

Información de gestión del lado de Notion. El historial de versiones del lado de Notion (el historial de páginas), los datos de la papelera y similares quedan fuera de lo que ofrece la Notion API y, por tanto, también fuera de la copia.

4. Límites de la licencia

NotionManager se puede usar gratis, pero con funciones limitadas. Los límites que afectan a la integridad de los datos son:

Versión gratuita: un límite de objetos por tarea de copia y un límite de vistas (solo puedes ver una vista). El límite de objetos se cuenta por tarea, así que puedes crear más de un perfil y repartir un espacio de trabajo grande entre varias copias. Dentro del límite de cada tarea, los datos se copian enteros.
Licencia personal (Basic y Premium): no admite la exportación ni la importación del archivo de todo el repositorio.

Hay más funciones ligadas a cada licencia, pero no afectan a la integridad de los datos y no las tratamos aquí.

5. Lo que te pedimos

Conserva copias según 3-2-1: basta con copiar todo el directorio del repositorio a otro medio (un disco externo, un NAS, almacenamiento de objetos). Este paso no depende de tu licencia. Una copia local también desaparece si el disco falla, si borras el directorio por error o si entra un ransomware; «la copia que está en otro sitio o desconectada» existe justo para ese caso. Los usuarios de equipo y de empresa pueden usar además el archivo de todo el repositorio (empaquetado en un solo archivo) para archivarlo o moverlo de máquina.
Revisa el informe de la copia y comprueba que las cantidades de cada tipo de objeto encajan con el tamaño de tu espacio de trabajo. Si un número no cuadra, averigua por qué antes de fiarte de esa copia.
Vigila la salud del disco: los sectores defectuosos del disco donde vive el repositorio dañan la copia directamente. Pon el repositorio en un almacenamiento fiable y guarda las copias desconectadas en medios distintos.