Preguntas frecuentes y solución de problemas
General
¿NamiDB Cloud usa el mismo motor que la versión open source de NamiDB?
Sí. Cloud ejecuta el motor open source, así que la referencia de Cypher, la codificación de valores y los códigos de error son los mismos. Cloud agrega las partes gestionadas: cuentas, organizaciones, keys, límites, backups, la consola y la facturación.
¿Puedo moverme entre Cloud y self-hosted?
Sí. Una exportación es JSON Lines más un
script import.cypher que se carga en un servidor self-hosted (o en Neo4j). En
la otra dirección, carga tus datos con los helpers de carga masiva de los SDKs,
el import de la CLI o lotes con UNWIND $rows.
¿Pago por las bases de datos inactivas?
No por cómputo. Las bases de datos inactivas dejan de usar cómputo y despiertan con la siguiente consulta; pagas por el almacenamiento que usan y las peticiones que atienden. Consulta Escalado a cero.
¿Dónde se guardan mis datos?
En un bucket de almacenamiento dedicado a tu organización, en la ubicación de almacenamiento asignada cuando se creó la organización. Consulta las páginas de Subencargados y Seguridad.
¿Hay un plan gratuito?
Sí: el plan Free, con 2 bases de datos, 2 GB, 100,000 escrituras y 1 millón de lecturas al mes, con topes fijos para que nunca se facture. Se pausa después de 7 días sin actividad.
Keys y autenticación
401 unauthorized
- La key es incorrecta, está revocada o venció: revisa API keys en la consola.
- Enviaste un token de gestión a la API de datos (o una API key a la API de gestión). Cada credencial funciona solo con su propia API.
- La cabecera es
Authorization: Bearer nmdb_live_…(conBearer).
403 database_not_in_scope
La key cubre otras bases de datos. Crea una key que cubra esta, o usa All databases.
403 read_only_key
Se envió una escritura (CREATE, MERGE, SET, DELETE, cambios de esquema)
con una key de solo lectura.
403 ip_not_allowed
La organización o la key tienen una IP allowlist y tu dirección no está en ella. El mensaje indica la dirección que vio NamiDB. Agrégala en API keys → IP allowlist. Consulta IP allowlists.
Perdí mi API key
Las keys se muestran una vez y no se pueden recuperar. Revócala y crea una nueva, o usa Rotate para que la anterior siga funcionando por un tiempo.
Rendimiento
La primera consulta tarda más
La base de datos estaba inactiva y su motor se había detenido (después de 10, 30
o 60 minutos en Free, Pro o Scale). La primera petición espera mientras
arranca; las siguientes son rápidas. En Scale, activa Keep warm. Los SDKs y
los drivers lo esperan; si ves 503 engine_starting, reintenta después de
Retry-After.
429 rate_limited
Más peticiones por segundo o consultas concurrentes de las que permite el plan.
Espera lo que indique Retry-After, agrupa las escrituras con UNWIND $rows y
reutiliza un cliente por proceso. Consulta
Límites de uso.
504 timeout
La consulta superó el timeout del plan (10 s / 30 s / 60 s). Usa EXPLAIN para
ver el plan, agrega un índice o un constraint sobre las propiedades por las que
filtras o haces MERGE, agrega LIMIT y acota los patrones de longitud
variable. El log de consultas lentas de la pestaña Activity agrupa las
sentencias lentas por forma.
413 result_too_large
El resultado supera los 64 MiB. Devuelve menos filas (LIMIT, SKIP) o menos
propiedades.
413 query_memory_limit
La consulta necesita más memoria de trabajo de la que el tamaño de base de
datos de tu plan permite para una sola consulta. Falla igual cada vez, así
que no la reintentes tal cual: filtra y agrega LIMIT antes, pagina, devuelve
menos valores o valores más pequeños, y agrega en lugar de juntar filas
crudas con collect(). Consulta
Errores.
503 memory_pressure
A la base de datos le falta memoria para consultas por un momento, normalmente porque hay varias consultas grandes ejecutándose a la vez. Reintenta con backoff exponencial (los drivers de Neo4j lo hacen por ti). Si persiste, haz más pequeñas las consultas grandes o ejecuta menos a la vez.
Límites y facturación
429 plan_limit
Se agotó una cuota con el spend cap activado (las escrituras se bloquean cuando se agotan el almacenamiento o las peticiones de escritura; todo se bloquea cuando se agotan las lecturas), o la base de datos es de solo lectura después de bajar de plan. Revisa Usage. Sube de plan, desactiva el cap (planes pagos), elimina datos o espera a que se reinicie el periodo.
403 org_paused
Una organización Free se pausó después de 7 días sin actividad. Un owner o admin presiona Resume en la consola.
403 org_suspended
NamiDB suspendió la organización; el mensaje dice por qué. Contacta a soporte. Tus datos siguen siendo exportables.
Drivers y herramientas
Mi driver de Neo4j no se conecta
- Usa
neo4j+s://db.namidb.com:7687obolt+s://…; TLS es obligatorio. - Usuario: cualquiera; contraseña: la API key.
- Nombra la base de datos cuando la key llega a más de una.
- El puerto 7687 tiene que estar abierto para conexiones salientes en tu red.
El cliente MCP no muestra herramientas
Revisa que la URL incluya la base de datos (/v1/<database>/mcp) y que se
envíe la cabecera Authorization: Bearer. El cliente tiene que soportar
servidores remotos (Streamable HTTP).
Los enteros pierden precisión en JavaScript
Los números JSON por encima de 2^53 pierden precisión en JavaScript. Guarda los identificadores grandes como strings.
Datos
¿Cómo deshago un error?
Restaura a un punto en el tiempo anterior: página de la base de datos → Restore to a point in time. Crea una base de datos nueva con la original tal como estaba entonces: exacta, al segundo, dentro de las últimas 48 horas en Pro y los últimos 7 días en Scale; a partir del backup más reciente anterior a ese momento en los demás casos. Consulta Backups para ver el punto de recuperación por plan.
Mi importación es lenta
Crea un constraint de unicidad sobre la clave con la que haces MERGE antes de
importar, para que cada fila sea una búsqueda en lugar de un recorrido
completo. Importa los nodos antes que las relaciones.
¿Puedo restaurar sobre una base de datos existente?
No. Las restauraciones siempre crean una base de datos nueva, así que los datos en uso nunca se sobrescriben. Apunta tu aplicación a la nueva, o elimina la anterior y vuelve a restaurar con su nombre.