Saltearse al contenido

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 defecto 0, desactivado; por ejemplo 24h o 7d) conserva restaurable cada versión confirmada de esa ventana. POST /v0/admin/backup (multi-tenant: /:namespace/v0/admin/backup) acepta as_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 agrega source_created_at. Nuevo GET /v0/admin/restore-points (multi-tenant: /:namespace/v0/admin/restore-points, que no abre el namespace) devuelve los puntos earliest y latest de la ventana y páginas de puntos, del más reciente al más antiguo. Códigos de error nuevos: invalid_as_of y as_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 y NAMIDB_COMPACTION_INTERVAL=0s. Cada sweep registra restore_window_retained y restore_window_bytes. La CLI suma namidb restore-points --from <uri> y namidb 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 1s e ignoraba POST /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, Apply no correlacionado, filtro, proyección, DISTINCT, agrupación y agregación, ORDER BY y top-k, comprensiones de patrones, el join multivía, la proyección de los algoritmos de grafos, y reduce, comprensiones y cuantificadores de listas. Un ORDER BY protegido 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, Bolt TransactionTimedOut) o de cancelación (HTTP 409, Bolt Transaction.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_BYTES valen 0 (sin límite) por defecto; NAMIDB_VECTOR_FILTER_MAX_DISTINCT y NAMIDB_VECTOR_FILTER_MAX_BYTES nunca se leían y ya no se documentan; namidb-mcp lista 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_BYTES solo medía la memoria cuando una consulta empezaba, así que una consulta admitida que materializaba un resultado grande (un UNWIND de 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 defecto auto: 50% de NAMIDB_MEMORY_MAX_BYTES, desactivado cuando ese valor es 0; una cantidad exacta de bytes también funciona sin tope; 0 lo 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 413 query_memory_limit (Bolt Neo.ClientError.Statement.ResourceLimitExceeded, GQLSTATUS 54000; no se puede reintentar sin cambios); si se detiene porque el pool está lleno o el proceso llegó a su tope, falla con 503 memory_pressure (Bolt Neo.TransientError.General.DatabaseUnavailable, 53000; reintentable). Una escritura cuya respuesta HTTP no cabría se revierte. NAMIDB_QUERY_ROW_CAP se 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 define NAMIDB_MEMORY_MAX_BYTES obtiene el presupuesto al actualizar; define NAMIDB_QUERY_MEMORY_MAX_BYTES=0 para no usarlo.

Cambiado

  • El 503 de una consulta rechazada en la admisión de memoria ahora lleva code: "memory_pressure", neo4j_code y gql_status, como cualquier otro error del ejecutor. El texto de error no cambia.
  • El límite de filas ahora también se aplica a algunas rutas de lookup y de DISTINCT que retornaban antes de tiempo.

3.2.0 — 2026-10-31

Agregado

  • POST /:namespace/v0/admin/restore para 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-uri se 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ás ns. 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 LIMIT simple sobre una expansión ya no vuelve a leer sus semillas.
  • Un OPTIONAL MATCH que 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_path produce una cuarta columna, path.
  • MATCH nunca vincula la misma relación dos veces; OPTIONAL MATCH hace match con su patrón completo o con nada.
  • Python: merge_nodes fusiona en nodos existentes (put_nodes reemplaza); 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_rows en cypher, limit= en los scans, iter_label / iter_edge_type perezosos, sweep(), compactación y sweep automáticos en el cliente embebido.
  • algo.shortest_path acepta un target opcional y retorna la ruta.
  • --fence-policy steal|yield y NAMIDB_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; stores file:// en bind mounts FUSE; sintaxis de Neo4j 5 para el DDL vectorial y full-text; --write-timeout obtiene su propio valor por defecto de 60 s.
  • 2.6.3: POST /v0/admin/compact vacía el nivel 0 y bloquea; las columnas del resultado siguen el orden del RETURN.
  • 2.6.10: borrar un nodo conectado sin DETACH retorna 409.
  • 2.6.14 – 2.6.19: CREATE INDEX sobre 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/queries y POST /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 para UNWIND range(…).

2.4.x — 2026-08

  • Índices compuestos (CREATE INDEX … ON (n.a, n.b)).
  • shortestPath bidireccional para un par vinculado.
  • Backup administrativo para servidores multi-tenant; group commit para namespaces multi-tenant.
  • namidb run acepta 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-auth para desactivarla explícitamente).
  • Los extremos de shortestPath deben estar vinculados por un MATCH anterior.
  • '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 los algo.*; 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: MERGE indexado, sondeos exactos de relaciones, cargas masivas sostenidas, NAMIDB_CACHE_MAX_BYTES como un único tope para todo el proceso, filtros vectoriales aplicados antes de k, el gobernador de memoria del proceso y la admisión de mensajes Bolt.

1.x — 2026-06

  • 1.5.0: filter en search.vector, search.bm25, search.hybrid y db.index.vector.queryNodes; IF NOT EXISTS en 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), subconsultas CALL { … }, 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.