Backups, restauraciones, clones y punto en el tiempo
Primero, la durabilidad
Cada escritura que NamiDB confirma ya está guardada en el almacenamiento de tu
organización. Perder el motor, o un reinicio, no pierde nada que se haya
confirmado. Los backups son para el otro tipo de pérdida: una migración
equivocada, un DETACH DELETE sin WHERE, un bug de la aplicación, o querer
los datos de ayer junto a los de hoy.
Backups
| Plan | Backups programados | Se conservan | Backups bajo demanda se conservan |
|---|---|---|---|
| Free | ninguno | 3 días | |
| Pro | cada 6 horas | 48 horas; el primero de cada día, 7 días | 7 días |
| Scale | cada hora | 48 horas; el primero de cada día, 30 días | 30 días |
- Un backup es un snapshot completo y consistente de una base de datos, guardado en el almacenamiento propio de tu organización. Cuenta como almacenamiento mientras se conserva. Cada backup registra cuándo se confirmó su cambio más reciente, así que una restauración desde él indica exactamente qué contiene.
- Bajo demanda en todos los planes: página de la base de datos →
Backups → Back up now (owners, admins y developers),
POST /databases/{database}/backups,namidb backups create <db> --wait. Se ejecuta un backup por base de datos a la vez (409 backup_in_progress); como máximo 30 backups bajo demanda por organización por hora. - Cada backup muestra su tipo (manual o programado), estado, tamaño y
vencimiento. Un backup programado que falla se reintenta en el siguiente
turno, y la alerta
backup.failedte avisa.
Restaurar
Una restauración copia un backup en una base de datos nueva. Nunca sobrescribe una existente, así que puedes comparar, copiar de vuelta lo que necesites o cambiar tu aplicación para que use la nueva.
- Consola: Backups → Restore en un backup, y luego nombra la base de datos nueva.
- API:
POST /restorescon{"backup_id", "database_name"}, y luego consultaGET /restores/{id}hasta que esté ensucceededofailed. - CLI:
namidb restores create <backup-id> <new-database> --wait. - SDKs:
restores.createcon el id del backup y el nombre nuevo. - Terraform:
namidb_databaseconrestore_from_backup_id.
La base de datos nueva está en restoring (las consultas responden
503 database_unavailable) hasta que termina la copia, y cuenta contra el
límite de bases de datos de tu plan. El tiempo que tarda una restauración crece
con el tamaño de la base de datos.
Para volver a poner los datos restaurados bajo el nombre original: elimina la original y vuelve a restaurar con el nombre liberado, o apunta tu aplicación a la base de datos nueva.
Clones
Un clon es una base de datos nueva con el contenido de una existente. Elige el origen:
| Origen | Qué obtienes |
|---|---|
| Último backup (por defecto) | El backup terminado más reciente. Arranca rápido; no contiene nada más nuevo que ese backup. |
| Snapshot nuevo | Un backup tomado en ese momento y luego copiado. Contiene todo lo confirmado hasta el inicio del snapshot. |
| Punto en el tiempo | La base de datos tal como estaba en el momento que elijas: ver Restauración a un punto en el tiempo. |
Usa clones para copias de staging, para probar una migración con datos reales o
para analítica que no debería competir con producción. Consola: página de la
base de datos → Clone. API: POST /databases/{database}/clones con
{"name", "source"} (latest_backup, fresh_snapshot o point_in_time con
at). CLI:
namidb databases clone movies movies-staging --source fresh_snapshot --wait.
Terraform: namidb_database con clone_from.
Restauración a un punto en el tiempo
Eliges un momento y NamiDB crea una base de datos nueva con la original tal como estaba en ese momento.
- Dentro de la ventana de puntos de restauración (las últimas 48 horas en Pro, los últimos 7 días en Scale) la copia es exacta al segundo: cada cambio confirmado en el momento que elijas o antes, y ninguno posterior.
- Antes de la ventana, y en Free, NamiDB copia el backup más reciente que no contiene nada confirmado después de ese momento. Antes de que confirmes, la consola muestra el punto de recuperación de ese backup: la base de datos nueva contiene la original exactamente como estaba en ese instante, así que los cambios entre el punto de recuperación y el momento que elegiste no están incluidos.
Formas de iniciarla:
- Consola: página de la base de datos → Restore to a point in time.
- API:
POST /restorescon{"database": "movies", "at": "2026-11-02T09:30:00Z", "database_name": "movies-before-incident"}, o lo mismo como clon,POST /databases/{database}/clonescon{"name": "movies-before-incident", "source": "point_in_time", "at": "2026-11-02T09:30:00Z"}. Ambas responden un clon; consultaGET /clones/{id}. - CLI:
namidb restores create movies movies-before-incident --at 2026-11-02T09:30:00Z --wait, o--at 2hpara hace dos horas. - SDKs:
restores.pointInTime(JavaScript) yrestores.point_in_time(Python). - Terraform:
namidb_databaseconclone_from = { database = "movies", at = "…" }.
Lo que informa el clon:
| Campo | Significado |
|---|---|
status | snapshotting mientras se copia el punto en el tiempo, luego restoring, y al final succeeded o failed |
recovery_point | El momento que contiene la base de datos nueva. Los cambios posteriores no están incluidos. Null hasta que existe la copia |
recovery_source | restore_point (una copia exacta desde la ventana) o backup (el backup más reciente en ese momento o antes) |
Un momento dentro de la ventana al que todavía no llegan los puntos de
restauración usa un backup, y recovery_source y recovery_point lo indican.
Eso pasa durante un tiempo después de que empiezan los puntos de restauración
de una base de datos: después de pasar desde Free, la ventana se llena durante
las siguientes 48 horas (Pro) o 7 días (Scale).
Una copia exacta queda en la lista de backups de la base de datos como un backup
point_in_time (con as_of, el instante que contiene) durante el mismo tiempo
que un backup bajo demanda, y cuenta para los backups por hora de abajo.
Errores: 400 bad_request para un momento en el futuro; 409 no_backup_before
cuando nada cubre ese momento; 409 no_backup cuando la base de datos no tiene
ningún backup. Si no se pudo copiar el punto en el tiempo y tampoco lo cubre
ningún backup, el clon y su base de datos nueva fallan, y la
alerta backup.failed te avisa.
Qué punto de recuperación esperar
El objetivo de punto de recuperación (RPO) es cuánto trabajo reciente puede perder una restauración. Dentro de la ventana de puntos de restauración es cero para el momento que elijas: la copia contiene cada cambio confirmado hasta entonces. Fuera de ella, lo define la frecuencia de los backups:
| Plan | Ventana de puntos de restauración (exacta, al segundo) | Antes de la ventana |
|---|---|---|
| Free | ninguna | Tus backups bajo demanda (se conservan 3 días) |
| Pro | últimas 48 horas | Un backup por día, durante 7 días |
| Scale | últimos 7 días | Un backup por día, durante 30 días |
Una restauración nunca incluye cambios hechos después del momento que elijas, ni nada de un momento que no cubre ningún punto de restauración ni backup. Si quieres una copia fija antes de un cambio riesgoso, toma un backup bajo demanda (o un clon de snapshot nuevo) justo antes: se conserva aunque la ventana ya haya avanzado.
Almacenamiento. Mantener la ventana de puntos de restauración significa conservar el historial reciente de la base de datos: aproximadamente lo que la base de datos escribe durante la ventana, además de sus datos vivos. Se mide y se factura como almacenamiento, igual que la base de datos y sus backups.
Límites
| Por organización | |
|---|---|
| Backups bajo demanda, de clones y a un punto en el tiempo | 30 por hora |
| Restauraciones y clones en conjunto | 20 por hora |
| Backups en ejecución | uno por base de datos a la vez |
Las restauraciones, los clones y las restauraciones a un punto en el tiempo requieren el mismo rol que crear una base de datos (owners, admins y developers), y el segundo factor cuando tienes uno registrado.
Fuera de la plataforma
Para una copia fuera de NamiDB Cloud, usa una exportación: archivos JSON Lines y un script Cypher que puedes guardar en cualquier lugar y cargar en NamiDB o Neo4j.