Changelog
Esta página resume cada versión del motor (el servidor, la CLI, el servidor
MCP, el paquete de Python y las imágenes de contenedor comparten una misma
versión). El historial completo y detallado, con mediciones e internals, es
el CHANGELOG.md
del motor. Los procedimientos de actualización están en
Actualizaciones.
3.3.0 — 2026-11-03
Agregado
- Puntos de restauración: backups a un punto en el tiempo.
--restore-point-retention/NAMIDB_RESTORE_POINT_RETENTION(por defecto0, desactivado; por ejemplo24ho7d) conserva restaurable cada versión confirmada de esa ventana.POST /v0/admin/backup(multi-tenant:/:namespace/v0/admin/backup) aceptaas_of: un instante RFC 3339, que se resuelve a la versión más reciente confirmada en ese instante o antes, o una versión del manifest como entero JSON. La copia es el namespace fila por fila tal como estaba en ese punto, y la respuesta agregasource_created_at. NuevoGET /v0/admin/restore-points(multi-tenant:/:namespace/v0/admin/restore-points, que no abre el namespace) devuelve los puntosearliestylatestde la ventana y páginas de puntos, del más reciente al más antiguo. Códigos de error nuevos:invalid_as_ofyas_of_in_future(400),restore_point_unavailable(404, con los límites de la ventana),namespace_not_found(404),invalid_limit(400). El almacenamiento crece según lo que el namespace escribe durante la ventana. El servidor se niega a arrancar con una retención yNAMIDB_COMPACTION_INTERVAL=0s. Cada sweep registrarestore_window_retainedyrestore_window_bytes. La CLI sumanamidb restore-points --from <uri>ynamidb backup --as-of <instante>. Ver Puntos de restauración.
Cambiado
- Los leases de retención ahora llevan un alcance. Un backup fija solo la versión que copia en lugar de cada versión desde ella hasta la actual, así que hacer backup de un punto de restauración antiguo no obliga a cada sweep a cargar todos los manifests intermedios. Las versiones anteriores leen cada lease como un piso, lo que conserva estrictamente más, así que mezclar versiones sigue siendo seguro.
Corregido
- El timeout de consulta y la cancelación de administración ahora detienen
cualquier operador a mitad de ejecución
(#207). Un producto
cartesiano no hace lecturas de almacenamiento, así que solo revisaba el
deadline entre operadores:
MATCH (a:N), (b:N) RETURN count(*)sobre 3.000 nodos corría más de 40 s con--query-timeout 1se ignorabaPOST /v0/admin/queries/{id}/cancel. Cada loop que trabaja sobre filas ya en memoria ahora revisa el deadline y la marca de cancelación, una vez cada 1.024 filas: productos cartesianos, hash joins y semi-joins,Applyno correlacionado, filtro, proyección,DISTINCT, agrupación y agregación,ORDER BYy top-k, comprensiones de patrones, el join multivía, la proyección de los algoritmos de grafos, yreduce, comprensiones y cuantificadores de listas. UnORDER BYprotegido sobre más de 16.384 filas ordena por tramos y los fusiona, con un resultado idéntico y estable. La sentencia falla con el error de timeout existente (HTTP 504, BoltTransactionTimedOut) o de cancelación (HTTP 409, BoltTransaction.Terminated) en milisegundos. El costo de las revisiones es menor al 2%.
Documentación
- Los README del motor coinciden con el código: Bolt negocia 4.4, 5.0, 5.4
y 5.7;
NAMIDB_EDGE_POINT_MAX_ENTRY_BYTES/NAMIDB_EDGE_POINT_MAX_SST_BYTESvalen0(sin límite) por defecto;NAMIDB_VECTOR_FILTER_MAX_DISTINCTyNAMIDB_VECTOR_FILTER_MAX_BYTESnunca se leían y ya no se documentan;namidb-mcplista sus 14 herramientas.
3.2.1 — 2026-11-02
Corregido
- La memoria de trabajo de una consulta en ejecución ahora está acotada
(#203). La admisión bajo
NAMIDB_MEMORY_MAX_BYTESsolo medía la memoria cuando una consulta empezaba, así que una consulta admitida que materializaba un resultado grande (unUNWINDde 600.000 filas en un contenedor de 384 MiB) podía crecer hasta que el kernel mataba el proceso y, con él, cada petición en curso. Cada sentencia, HTTP y Bolt, lecturas y escrituras, se ejecuta ahora con un presupuesto de memoria de trabajo,--query-memory-max-bytes/NAMIDB_QUERY_MEMORY_MAX_BYTES(por defectoauto: 50% deNAMIDB_MEMORY_MAX_BYTES, desactivado cuando ese valor es0; una cantidad exacta de bytes también funciona sin tope;0lo desactiva). Todas las consultas en ejecución comparten además un pool del 75% del tope. Si supera su propio presupuesto, una consulta falla con 413query_memory_limit(BoltNeo.ClientError.Statement.ResourceLimitExceeded, GQLSTATUS54000; no se puede reintentar sin cambios); si se detiene porque el pool está lleno o el proceso llegó a su tope, falla con 503memory_pressure(BoltNeo.TransientError.General.DatabaseUnavailable,53000; reintentable). Una escritura cuya respuesta HTTP no cabría se revierte.NAMIDB_QUERY_ROW_CAPse sigue aplicando por su cuenta. Métricas nuevas:namidb_query_memory_limit_bytes,namidb_query_memory_pool_bytes{kind},namidb_query_memory_stops_total{reason}. Ver Memoria. Nota de actualización: un servidor que defineNAMIDB_MEMORY_MAX_BYTESobtiene el presupuesto al actualizar; defineNAMIDB_QUERY_MEMORY_MAX_BYTES=0para no usarlo.
Cambiado
- El 503 de una consulta rechazada en la admisión de memoria ahora lleva
code: "memory_pressure",neo4j_codeygql_status, como cualquier otro error del ejecutor. El texto deerrorno cambia. - El límite de filas ahora también se aplica a algunas rutas de lookup y de
DISTINCTque retornaban antes de tiempo.
3.2.0 — 2026-10-31
Agregado
POST /:namespace/v0/admin/restorepara servidores multi-tenant: restaura un backup en un namespace que todavía no existe, a través del propio store del servidor. Reintentar un restore fallido es seguro; las peticiones que abrirían el destino reciben 503 mientras se ejecuta.
Seguridad
--backup-target-urise aplica sobre URIs parseados en lugar de un prefijo de texto: mismo esquema y bucket, una ruta igual o por debajo del prefijo sin segmentos.,..ni vacíos, y exactamente los parámetros de consulta del prefijo másns. Nota de actualización: pon las opciones del store en el prefijo y repítelas en las peticiones.
Corregido
- Abrir un namespace cuyo cuerpo de manifest existe sin puntero (un backup o restore interrumpido) ahora adopta ese cuerpo.
- Las claves numéricas se indexan cuando la restricción o el índice se declara antes que los datos.
3.1.0 — 2026-10-29
Cambiado
- Los vectores, bytes y listas de números se escriben en el WAL y la memtable en binario: WAL más pequeño (23 MB → 8,4 MB para 2.000 embeddings de 1024 dimensiones) y commits y flushes más rápidos. Formato de WAL v2; haz flush antes de volver a 3.0.0.
- Un
LIMITsimple sobre una expansión ya no vuelve a leer sus semillas. - Un
OPTIONAL MATCHque no referencia ninguna variable externa se ejecuta una sola vez. - La iteración de relaciones (
iter_edge_type,scan_edge_type(limit=)) lee los archivos de relaciones por chunks en lugar de completos. - Los scans de labels de tamaño medio solo reconcilian los ids del label.
Corregido
- Borrar nodos ya no desactiva la ruta de postings por label hasta la siguiente compactación.
3.0.0 — 2026-10-29
Incompatible
- Nuevo formato de archivos de datos de nodos que 2.x no puede leer; volver a una versión anterior requiere un backup tomado antes de actualizar.
CALL algo.*rechaza opciones desconocidas;algo.shortest_pathproduce una cuarta columna,path.MATCHnunca vincula la misma relación dos veces;OPTIONAL MATCHhace match con su patrón completo o con nada.- Python:
merge_nodesfusiona en nodos existentes (put_nodesreemplaza); las filas de carga masiva toman el id del nodo de_id.
Agregado
- Clientes de Python de solo lectura (
Client(uri, read_only=True),refresh(),close()),timeout_ms/max_rowsencypher,limit=en los scans,iter_label/iter_edge_typeperezosos,sweep(), compactación y sweep automáticos en el cliente embebido. algo.shortest_pathacepta untargetopcional y retorna la ruta.--fence-policy steal|yieldyNAMIDB_MAX_CONCURRENT_QUERIES_PER_NAMESPACE.- Wheel de Python para macOS x86_64.
Cambiado
- Los embeddings se almacenan en binario; las proyecciones que no los leen los omiten por completo.
- Las transacciones de lectura de Bolt ya no toman el lock del writer; las lecturas de Python se ejecutan sin el lock del writer y liberan el GIL.
- Los nombres de namespace pueden contener
_;memory://acepta?ns=.
2.6.x — 2026-09
- 2.6.0: introspección del esquema en todas las superficies
(
db.labels(),db.relationshipTypes(),db.propertyKeys(),db.schema.visualization()); admisión de lecturas del lado del servidor; storesfile://en bind mounts FUSE; sintaxis de Neo4j 5 para el DDL vectorial y full-text;--write-timeoutobtiene su propio valor por defecto de 60 s. - 2.6.3:
POST /v0/admin/compactvacía el nivel 0 y bloquea; las columnas del resultado siguen el orden delRETURN. - 2.6.10: borrar un nodo conectado sin
DETACHretorna 409. - 2.6.14 – 2.6.19:
CREATE INDEXsobre propiedades numéricas acelera igualdades y rangos. - Muchas correcciones de exactitud y rendimiento para expansiones, caminos de longitud variable y nodos intermedios anónimos.
2.5.x — 2026-08
GET /v0/admin/queriesyPOST /v0/admin/queries/:id/cancel.- El archivo de tokens se recarga en caliente.
- Los flags booleanos aceptan
1/0/true/false/yes/no/on/off; el modo multi-tenant ya no requiere?ns=en--store. - 2.5.1: rutas multi-tenant sin prefijo con el header
X-NamiDB-Namespace; memoria acotada paraUNWIND range(…).
2.4.x — 2026-08
- Índices compuestos (
CREATE INDEX … ON (n.a, n.b)). shortestPathbidireccional para un par vinculado.- Backup administrativo para servidores multi-tenant; group commit para namespaces multi-tenant.
namidb runacepta scripts separados por;.
2.3.0 — 2026-08
- Group commit (
--group-commit-window). - Bolt multi-tenant: las sesiones se enrutan por la base de datos del driver.
POST /v0/admin/backup(en línea, point-in-time).- Bolt 5.7 con metadatos GQLSTATUS.
2.2.x — 2026-08
Incompatible
- El servidor se niega a arrancar sin una fuente de autenticación
(
--no-authpara desactivarla explícitamente). - Los extremos de
shortestPathdeben estar vinculados por unMATCHanterior. 'text' + <map/list/node>es un error de tipos; los errores de timeout y de límite de Bolt tienen sus propios códigos.
Agregado
reduce(…);stdev,stdevp,percentileCont,percentileDisc.- Errores HTTP legibles por máquina (
code,neo4j_code,gql_status). - La imagen oficial corre como uid 65532 y crea previamente
/var/lib/namidb.
2.1.x — 2026-08
- Índices vectoriales y full-text incrementales (base más segmentos delta) con BM25 globalmente exacto entre segmentos.
- Formatos legibles por rangos para datos vectoriales, de texto y de nodos; una caché de páginas en RAM activada por defecto.
EXPLAIN [RAW] [VERBOSE]sobre HTTP y Bolt; control de admisión para full scans concurrentes; el DDL de propiedades sobre datos ya cargados se aplica de inmediato.
2.0.x — 2026-07
- 2.0.0:
DROP INDEX/DROP VECTOR INDEX; Louvain y betweenness; proyecciones de grafos en todos losalgo.*; consultas full-text por frase y prefijo; streaming de Bolt guiado por demanda; salud del writer en/v0/health; flush y backpressure de escritura basados en bytes; esperas acotadas por el lock del writer; backups en línea consistentes; compactación fuera del lock del writer; recuperación automática de writers bloqueados (fenced) o envenenados. - 2.0.1 – 2.0.6:
MERGEindexado, sondeos exactos de relaciones, cargas masivas sostenidas,NAMIDB_CACHE_MAX_BYTEScomo un único tope para todo el proceso, filtros vectoriales aplicados antes dek, el gobernador de memoria del proceso y la admisión de mensajes Bolt.
1.x — 2026-06
- 1.5.0:
filterensearch.vector,search.bm25,search.hybridydb.index.vector.queryNodes;IF NOT EXISTSen el DDL vectorial y full-text; verificación de dimensiones al escribir; binarios del servidor precompilados. - 1.4.0:
search.hybrid(fusión RRF y lineal),search.vector,db.index.vector.queryNodes, las tres métricas desde el índice, cuantización int8, FastRP. - 1.3.0: el índice vectorial sirve KNN de Cypher, con filtros y frescura.
- 1.2.0: restricciones de unicidad compuestas,
IF NOT EXISTS,SHOW CONSTRAINTS/SHOW INDEXES. - 1.1.0: DDL de Cypher (
CREATE CONSTRAINT,CREATE INDEX), subconsultasCALL { … },EXISTS { … },FOREACH, disyunción de labels, caminos de longitud variable abiertos y parametrizados,search.bm25,CREATE FULLTEXT INDEX. - 1.0.0: primera versión estable; siete algoritmos de grafos.
Antes de 1.0
La serie 0.x (mayo–junio de 2026) construyó el motor: el formato de
almacenamiento, el subconjunto de Cypher, el servidor HTTP y Bolt, los
bindings de Python, read-your-own-writes, la compactación, el almacenamiento
de vectores, TLS, métricas, backups y roles de tokens, y el cargador de
vaults de Markdown y el servidor MCP. Consulta el
CHANGELOG.md
completo.