Saltearse al contenido

Límites

Modelo de datos

LímiteValor
Nombre de namespace[a-z0-9][a-z0-9_-]{0,62} (1–63 caracteres)
Relaciones entre dos nodosUna por (type, start node, end node); un segundo CREATE del mismo triple reemplaza el primero
Id de nodoUn UUID, asignado al crearlo (o indicado como _id en la API de carga masiva)
Writers por namespaceUno a la vez; cualquier cantidad de lectores
Restricciones e índicesSolo sobre propiedades de nodos
Valores enterosCon signo de 64 bits; la aritmética da la vuelta al desbordarse
Tipos temporalesSolo 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ímitePor defectoVariable
Nombres de propiedad distintos por archivo de datos65.536NAMIDB_NODE_PROPERTY_MAX_PROPERTIES
Longitud de un nombre de propiedad1.024 bytesNAMIDB_NODE_PROPERTY_MAX_NAME_BYTES
Un valor de propiedad64 MiBNAMIDB_NODE_PROPERTY_MAX_VALUE_BYTES
Profundidad de anidamiento de un valor32NAMIDB_NODE_PROPERTY_MAX_VALUE_DEPTH
Elementos en un valor1.000.000NAMIDB_NODE_PROPERTY_MAX_VALUE_ELEMENTS
Página de propiedades decodificada65 MiBNAMIDB_NODE_PROPERTY_MAX_PAGE_BYTES
Catálogo de propiedades por archivo16 MiBNAMIDB_NODE_PROPERTY_MAX_CATALOG_BYTES

Presupuestos de consulta (servidor)

LímitePor defectoAjusteResultado al superarse
Tiempo de una sentencia de lectura30 s--query-timeout504 timeout
Tiempo de una sentencia de escritura60 s--write-timeout504 timeout, no se confirma nada
Filas que cualquier operador de lectura puede materializar1.000.000--query-row-cap413 row_cap
Memoria de trabajo de una sentencia50% de --memory-max-bytes (desactivado sin tope)--query-memory-max-bytes413 query_memory_limit
Memoria de trabajo de todas las sentencias en ejecución75% de --memory-max-bytesderivado503 memory_pressure
Petición HTTP completa≥ 120 s (derivado)--http-request-timeout408
Espera por el lock del writer30 s--writer-lock-timeout503
Espera por la admisión de lecturas5 sNAMIDB_QUERY_ADMISSION_WAIT_MS503
Lecturas concurrentesnúcleos de CPU (mínimo 4)NAMIDB_MAX_CONCURRENT_QUERIESen cola, luego 503
Full scans concurrentes4NAMIDB_MAX_CONCURRENT_SCANSen cola
Peticiones HTTP concurrentes1.024NAMIDB_HTTP_MAX_CONCURRENCYen 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ímitePor defectoAjuste
Cuerpo HTTP de /v0/cypher2 MiBfijo
Mensaje Bolt antes de autenticar64 KiBfijo
Mensaje Bolt después de autenticar64 MiB--bolt-max-message-bytes
Conexiones Bolt1.024NAMIDB_BOLT_MAX_CONNECTIONS
Tiempo inactivo de una transacción Bolt30 s--bolt-tx-timeout
Vida de una transacción Bolt5 minNAMIDB_BOLT_MAX_TX_LIFETIME

Envía las escrituras grandes como varios lotes UNWIND $rows dentro de estos tamaños.

Búsqueda

LímitePor defectoAjuste
Tamaño de un resultado full-text sin límite64 MiBNAMIDB_SEARCH_MAX_RESULT_BYTES (413 search_result_limit)
Tamaño de documento para BM25 exacto1 MiBNAMIDB_BM25_MAX_DOCUMENT_BYTES (413 search_document_limit)
Memoria transitoria de búsqueda256 MiBNAMIDB_SEARCH_WORKSPACE_MAX_BYTES (503 search_workspace_capacity)
Valores string/booleanos distintos por propiedad de filtro dentro de un índice vectorial4.096fijo; por encima, la propiedad se filtra por la ruta exacta, más lenta
Postings de filtros por cuerpo de índice vectorial64 MiBfijo; mismo fallback
Candidatos de side-car para un filtro que el índice no puede aplicar8.192NAMIDB_VECTOR_FILTER_ID_CANDIDATE_CAP (0 desactiva)
Candidatos BM25 en una búsqueda híbrida filtrada65.536NAMIDB_HYBRID_TEXT_FILTER_CANDIDATE_CAP
Segmentos vivos por índice de búsqueda8 (2–32)NAMIDB_SEARCH_LSM_MAX_SEGMENTS
Cuantización int8solo 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ímitePor defectoAjuste
Namespaces abiertos100 (se desaloja el inactivo más antiguo)--max-namespaces (0 = ilimitado)
Tiempo inactivo antes del desalojo1 h--namespace-idle-timeout
Lecturas concurrentes por namespacedesactivadoNAMIDB_MAX_CONCURRENT_QUERIES_PER_NAMESPACE
Backups / restores concurrentes por proceso1 (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.