Cypher soportado
NamiDB implementa un subconjunto amplio y estricto de openCypher 9 y GQL (ISO/IEC 39075:2024), y acepta la sintaxis de Neo4j 5 donde existe. “Estricto” significa que todo lo que el parser acepta se ejecuta con la semántica estándar o falla con un error tipado; nunca se ejecuta con un significado distinto de forma silenciosa.
Todo lo que aparece en las tablas siguientes se verificó contra el motor 3.2.0; 3.2.1 y 3.3.0 no cambian la superficie de Cypher. La misma superficie la sirven el cliente de Python, la API HTTP, Bolt y la CLI.
Cláusulas
| Cláusula | Soportada | Notas |
|---|---|---|
MATCH, OPTIONAL MATCH | sí | Partes de patrón separadas por comas; varias cláusulas MATCH seguidas. Un OPTIONAL MATCH hace match con su patrón completo o produce NULLs. |
WHERE | sí | En MATCH, OPTIONAL MATCH y WITH. |
RETURN, RETURN DISTINCT, RETURN * | sí | Las columnas vuelven en el orden del RETURN. |
WITH, WITH DISTINCT, WITH * | sí | Con WHERE, ORDER BY, SKIP, LIMIT. |
ORDER BY … ASC / DESC | sí | Cualquier expresión; se aceptan ASCENDING / DESCENDING. NULLS FIRST/LAST no. |
SKIP, LIMIT | sí | Un literal entero no negativo o un $parameter; no una expresión arbitraria. |
UNWIND | sí | UNWIND null y UNWIND [] no producen filas. |
UNION, UNION ALL | sí | Cada rama debe retornar los mismos nombres de columna en el mismo orden. |
CREATE | sí | Nodos, relaciones, cadenas, varias partes; mapas de propiedades a partir de literales, expresiones o un $map. |
MERGE | sí | Patrón de nodo o de relación, ON CREATE SET, ON MATCH SET. |
SET | sí | n.p = v, n = {…} (reemplaza), n += {…} (fusiona), n:Label[:Label2], varios elementos. |
REMOVE | sí | Propiedades y labels, varios elementos. |
DELETE, DETACH DELETE | sí | Nodos y relaciones. Un DELETE de un nodo que todavía tiene relaciones falla (HTTP 409). |
FOREACH (x IN list | …) | sí | El cuerpo puede contener CREATE, MERGE, SET, REMOVE, DELETE o un FOREACH anidado. |
CALL { … } | sí | No correlacionada, y correlacionada con un WITH a, b que importa variables. Se permiten subconsultas de escritura. UNION dentro de una subconsulta no correlacionada. |
CALL proc(…) YIELD … | sí | Solo procedimientos integrados db.*, search.* y algo.*. El CALL debe ser la primera cláusula de la consulta. Filtra lo que produce con un WITH … WHERE posterior. |
EXPLAIN [RAW] [VERBOSE] | sí | Retorna el plan en lugar de ejecutar la consulta (HTTP, Bolt, CLI, Python). |
SHOW CONSTRAINTS, SHOW INDEXES | sí | Solo la forma simple (sin YIELD, BRIEF, VERBOSE). |
CREATE CONSTRAINT, CREATE INDEX, CREATE VECTOR INDEX, CREATE FULLTEXT INDEX, DROP INDEX, DROP VECTOR INDEX | sí | Debe ser la única sentencia de la petición. Consulta Esquema. |
PROFILE | no | Usa EXPLAIN VERBOSE. |
LOAD CSV | no | Haz cargas masivas desde Python (put_nodes, load_parquet_*) o con UNWIND $rows. |
USE <graph> | no | Elige el namespace con la conexión (URI, ruta / header HTTP, base de datos Bolt). |
CALL { … } IN TRANSACTIONS | no | |
DROP CONSTRAINT | no | |
BEGIN / COMMIT en Cypher | no | Cada sentencia hace auto-commit. Los drivers Bolt pueden ejecutar transacciones explícitas. |
Patrones
| Elemento | Soportado | Notas |
|---|---|---|
(n), (n:Label), (:A:B), (n {k: v}) | sí | Varios labels significan “todos ellos”. Los mapas de propiedades inline aceptan literales o parámetros. |
Disyunción de labels (n:A|B) | sí | Algunas formas de OPTIONAL MATCH la rechazan con un error explícito “not supported yet”. |
WHERE n:Label, WHERE NOT n:Label | sí | Predicados de label en expresiones. |
(n:A&B), (n:!A), (n:%) | no | Expresiones de label de GQL. Usa :A:B o WHERE. |
-[r:T]->, <-[r:T]-, -[r:T]-, -->, <--, -- | sí | |
Alternancia de tipos -[r:A|B]-> | sí | |
Propiedades de relación inline -[r:T {k: v}]-> | sí | También en saltos de longitud variable (se aplica a cada salto). |
Longitud variable *, *n, *n..m, *..m, *n.., *0..m | sí | Los límites pueden ser $parameters (*1..$hops). Se permite * abierto. Una variable de relación en un salto de longitud variable se vincula a la lista de relaciones. |
Variable de camino p = (a)-[…]->(b) | sí | En MATCH, incluida la longitud variable. No en CREATE ni en MERGE. |
shortestPath(…), allShortestPaths(…) | sí | MATCH p = shortestPath((a)-[:T*..15]-(b)): requiere variable de camino, un único salto de relación con límite superior finito y ambos extremos vinculados por un MATCH anterior. |
Búsqueda por {_id: $x} | sí | Requiere un label: MATCH (n:Person {_id: $x}). |
Expansión de $map en un patrón MATCH | no | Indica las claves explícitamente, por ejemplo en WHERE. |
Patrones de camino cuantificados ((a)-[]->(b)){1,3} | no | Usa relaciones de longitud variable. |
Un MATCH nunca vincula la misma relación dos veces dentro de un patrón.
Expresiones
| Categoría | Soportado |
|---|---|
| Literales | enteros, flotantes (1.5, .5, 1e3), strings en '…' o "…" con escapes \ (\', \", \n, \uXXXX), true / false / null, listas, mapas |
| Parámetros | $name en cualquier lugar donde se permita un valor |
| Acceso a propiedades | n.prop, map.key, n._id (el id del nodo) |
| Aritmética | + - * / % ^; la / entera trunca; ^ retorna un flotante |
| Concatenación de strings | 'a' + 1 → 'a1'; 'a' + {…} / listas / nodos es un error de tipos |
| Operaciones con listas | concatenación +, [i], índice negativo, slices [a..b], [..b], [a..], IN |
| Comparación | = <> < > <= >=; 1 = 1.0 es true; comparar tipos incompatibles produce NULL |
| Booleanos | AND OR XOR NOT con lógica de tres valores |
| Pruebas de null | IS NULL, IS NOT NULL |
| Predicados de strings | STARTS WITH, ENDS WITH, CONTAINS, =~ (regex de coincidencia completa, (?i) para no distinguir mayúsculas) |
CASE | simple (CASE x WHEN …) y con búsqueda (CASE WHEN …) |
| List comprehension | [x IN list WHERE pred | expr] |
| Cuantificadores | any(…), all(…), none(…), single(…) |
| Fold | reduce(acc = init, x IN list | expr) |
| Pattern comprehension | [(a)-[:T]->(b) | b.name], como elemento de proyección de nivel superior |
| Existenciales | EXISTS { MATCH … [WHERE …] }, EXISTS { (a)-->() }, exists((a)-->()), predicado de patrón simple WHERE (a)-[:T]->() |
| No soportado | proyección de mapas n {.a, .b}, subconsultas COUNT { … } / COLLECT { … }, size((a)-->()), exists(n.prop) (usa IS NOT NULL), predicados de tipo x IS :: INTEGER, literales hexadecimales, duplicar comillas '' (usa \') |
La lista completa de funciones está en Operadores y funciones.
Tipos
| Tipo | Notas |
|---|---|
INTEGER | Con signo de 64 bits. El desbordamiento aritmético da la vuelta; mantén los valores bien dentro del rango. |
FLOAT | IEEE 754 de 64 bits. |
STRING, BOOLEAN, NULL | |
LIST | Heterogénea. Una lista de flotantes guardada en una propiedad cubierta por un índice vectorial se convierte en VECTOR. |
MAP | Claves string. |
BYTES | A partir de parámetros bytes de Python; base64 en JSON. |
VECTOR | Vector denso f32 (vector([…]), o una lista de flotantes bajo un índice vectorial). size(v) es su dimensión. |
DATE | date(), date('YYYY-MM-DD'). Comparable; el acceso a componentes (d.year) retorna NULL. |
DATETIME | UTC, precisión de microsegundos. datetime(), datetime('…ISO-8601…') (los offsets se convierten a UTC); localdatetime(…) se trata como UTC. |
NODE, RELATIONSHIP, PATH | |
| No soportado | DURATION, TIME, LOCALTIME, fechas y horas con zona horaria, POINT |
La semántica de NULL es de tres valores: null = null es null,
null AND false es false, null OR true es true, y WHERE descarta
las filas cuyo predicado es null. Las agregaciones omiten los null
(count(n.missing) es 0, avg sin valores es null).
Procedimientos
CALL solo ejecuta procedimientos integrados; los namespaces desconocidos
como apoc.* o dbms.* fallan con una lista de lo que está disponible.
| Procedimiento | Propósito | Página |
|---|---|---|
db.labels(), db.relationshipTypes(), db.propertyKeys(), db.schema.visualization() | Introspección del esquema | Esquema |
search.vector, db.index.vector.queryNodes, search.bm25, search.hybrid | Recuperación vectorial, full-text e híbrida | Búsqueda |
algo.wcc, algo.scc, algo.pagerank, algo.degree, algo.triangle_count, algo.label_propagation, algo.louvain, algo.betweenness, algo.shortest_path, algo.fastRP | Algoritmos de grafos | Algoritmos |
Transacciones y visibilidad
- Cada sentencia es su propia transacción: se confirma por completo o no se confirma en absoluto.
- Una sentencia ve sus propias cláusulas anteriores:
CREATE (a:T) WITH a MATCH (b:T) RETURN count(b)cuenta el nodo nuevo. - Cada sentencia ve todas las escrituras confirmadas antes de que empezara.
- Los drivers Bolt pueden agrupar varias sentencias en una transacción
explícita (
session.execute_write(…)); consulta Bolt.
Errores
Una construcción no soportada falla antes de que se ejecute nada, con un
error tipado: parse_error para sintaxis que el parser no acepta,
unsupported o plan_error para construcciones que parsea pero no puede
ejecutar. Por HTTP son respuestas 400; consulta la
taxonomía de errores.