Límites
Modelo de datos
| Límite | Valor |
|---|---|
| Nombre de namespace | [a-z0-9][a-z0-9_-]{0,62} (1–63 caracteres) |
| Relaciones entre dos nodos | Una por (type, start node, end node); un segundo CREATE del mismo triple reemplaza el primero |
| Id de nodo | Un UUID, asignado al crearlo (o indicado como _id en la API de carga masiva) |
| Writers por namespace | Uno a la vez; cualquier cantidad de lectores |
| Restricciones e índices | Solo sobre propiedades de nodos |
| Valores enteros | Con signo de 64 bits; la aritmética da la vuelta al desbordarse |
| Tipos temporales | Solo DATE y DATETIME en UTC; sin duraciones, horas, zonas horarias ni puntos |
Límites de propiedades por nodo
Se verifican cuando se construyen los archivos de datos de nodos (flush y compactación). Superar uno hace fallar la construcción con un error explícito en lugar de truncar datos.
| Límite | Por defecto | Variable |
|---|---|---|
| Nombres de propiedad distintos por archivo de datos | 65.536 | NAMIDB_NODE_PROPERTY_MAX_PROPERTIES |
| Longitud de un nombre de propiedad | 1.024 bytes | NAMIDB_NODE_PROPERTY_MAX_NAME_BYTES |
| Un valor de propiedad | 64 MiB | NAMIDB_NODE_PROPERTY_MAX_VALUE_BYTES |
| Profundidad de anidamiento de un valor | 32 | NAMIDB_NODE_PROPERTY_MAX_VALUE_DEPTH |
| Elementos en un valor | 1.000.000 | NAMIDB_NODE_PROPERTY_MAX_VALUE_ELEMENTS |
| Página de propiedades decodificada | 65 MiB | NAMIDB_NODE_PROPERTY_MAX_PAGE_BYTES |
| Catálogo de propiedades por archivo | 16 MiB | NAMIDB_NODE_PROPERTY_MAX_CATALOG_BYTES |
Presupuestos de consulta (servidor)
| Límite | Por defecto | Ajuste | Resultado al superarse |
|---|---|---|---|
| Tiempo de una sentencia de lectura | 30 s | --query-timeout | 504 timeout |
| Tiempo de una sentencia de escritura | 60 s | --write-timeout | 504 timeout, no se confirma nada |
| Filas que cualquier operador de lectura puede materializar | 1.000.000 | --query-row-cap | 413 row_cap |
| Memoria de trabajo de una sentencia | 50% de --memory-max-bytes (desactivado sin tope) | --query-memory-max-bytes | 413 query_memory_limit |
| Memoria de trabajo de todas las sentencias en ejecución | 75% de --memory-max-bytes | derivado | 503 memory_pressure |
| Petición HTTP completa | ≥ 120 s (derivado) | --http-request-timeout | 408 |
| Espera por el lock del writer | 30 s | --writer-lock-timeout | 503 |
| Espera por la admisión de lecturas | 5 s | NAMIDB_QUERY_ADMISSION_WAIT_MS | 503 |
| Lecturas concurrentes | núcleos de CPU (mínimo 4) | NAMIDB_MAX_CONCURRENT_QUERIES | en cola, luego 503 |
| Full scans concurrentes | 4 | NAMIDB_MAX_CONCURRENT_SCANS | en cola |
| Peticiones HTTP concurrentes | 1.024 | NAMIDB_HTTP_MAX_CONCURRENCY | en cola |
Los resultados se materializan antes de retornarse, y por eso existen el
límite de filas y el presupuesto de memoria por consulta: detienen un
producto cruzado descontrolado o un UNWIND enorme antes de que agote la
memoria. Pagina los resultados grandes con ORDER BY … SKIP … LIMIT o con
un rango de claves. Ver Memoria.
Cada operador revisa el deadline y la marca de cancelación mientras trabaja
(desde 3.3.0, incluidos productos cartesianos, joins, filtros, proyecciones,
DISTINCT, agrupaciones, ordenamientos y expresiones de listas), así que
una sentencia se detiene a milisegundos de su presupuesto o de
POST /v0/admin/queries/:id/cancel. Aun así, evita los productos
cartesianos sin anclaje de labels grandes (MATCH (a:Big), (b:Big)): son
costosos y suelen llegar al límite de filas o al timeout.
El cliente de Python embebido no tiene presupuestos por defecto; pasa
timeout_ms y max_rows en cada llamada.
Tamaños de peticiones y mensajes
| Límite | Por defecto | Ajuste |
|---|---|---|
Cuerpo HTTP de /v0/cypher | 2 MiB | fijo |
| Mensaje Bolt antes de autenticar | 64 KiB | fijo |
| Mensaje Bolt después de autenticar | 64 MiB | --bolt-max-message-bytes |
| Conexiones Bolt | 1.024 | NAMIDB_BOLT_MAX_CONNECTIONS |
| Tiempo inactivo de una transacción Bolt | 30 s | --bolt-tx-timeout |
| Vida de una transacción Bolt | 5 min | NAMIDB_BOLT_MAX_TX_LIFETIME |
Envía las escrituras grandes como varios lotes UNWIND $rows dentro de
estos tamaños.
Búsqueda
| Límite | Por defecto | Ajuste |
|---|---|---|
| Tamaño de un resultado full-text sin límite | 64 MiB | NAMIDB_SEARCH_MAX_RESULT_BYTES (413 search_result_limit) |
| Tamaño de documento para BM25 exacto | 1 MiB | NAMIDB_BM25_MAX_DOCUMENT_BYTES (413 search_document_limit) |
| Memoria transitoria de búsqueda | 256 MiB | NAMIDB_SEARCH_WORKSPACE_MAX_BYTES (503 search_workspace_capacity) |
| Valores string/booleanos distintos por propiedad de filtro dentro de un índice vectorial | 4.096 | fijo; por encima, la propiedad se filtra por la ruta exacta, más lenta |
| Postings de filtros por cuerpo de índice vectorial | 64 MiB | fijo; mismo fallback |
| Candidatos de side-car para un filtro que el índice no puede aplicar | 8.192 | NAMIDB_VECTOR_FILTER_ID_CANDIDATE_CAP (0 desactiva) |
| Candidatos BM25 en una búsqueda híbrida filtrada | 65.536 | NAMIDB_HYBRID_TEXT_FILTER_CANDIDATE_CAP |
| Segmentos vivos por índice de búsqueda | 8 (2–32) | NAMIDB_SEARCH_LSM_MAX_SEGMENTS |
Cuantización int8 | solo METRIC cosine | — |
Llegar a un tope de filtro o de candidatos cambia el costo, no los resultados: la consulta pasa a una ruta exacta.
Capacidad multi-tenant
| Límite | Por defecto | Ajuste |
|---|---|---|
| Namespaces abiertos | 100 (se desaloja el inactivo más antiguo) | --max-namespaces (0 = ilimitado) |
| Tiempo inactivo antes del desalojo | 1 h | --namespace-idle-timeout |
| Lecturas concurrentes por namespace | desactivado | NAMIDB_MAX_CONCURRENT_QUERIES_PER_NAMESPACE |
| Backups / restores concurrentes por proceso | 1 (los que esperan agotan el tiempo a los 30 s) | fijo |
Throughput
Todas las escrituras de un namespace pasan por su único writer, y cada
commit es una ida y vuelta al store. En un object store, el throughput de
escritura interactiva queda por lo tanto limitado por la latencia de
commit; agrupa las escrituras con UNWIND, usa la API de carga masiva de
Python o habilita --group-commit-window para que los writers concurrentes
compartan commits. Las lecturas escalan con los núcleos y no las bloquean
las escrituras. Reparte los grafos independientes en namespaces para
escalar más las escrituras.