Saltearse al contenido

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áusulaSoportadaNotas
MATCH, OPTIONAL MATCHsí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.
WHEREsí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 / DESCsíCualquier expresión; se aceptan ASCENDING / DESCENDING. NULLS FIRST/LAST no.
SKIP, LIMITsíUn literal entero no negativo o un $parameter; no una expresión arbitraria.
UNWINDsíUNWIND null y UNWIND [] no producen filas.
UNION, UNION ALLsíCada rama debe retornar los mismos nombres de columna en el mismo orden.
CREATEsíNodos, relaciones, cadenas, varias partes; mapas de propiedades a partir de literales, expresiones o un $map.
MERGEsíPatrón de nodo o de relación, ON CREATE SET, ON MATCH SET.
SETsín.p = v, n = {…} (reemplaza), n += {…} (fusiona), n:Label[:Label2], varios elementos.
REMOVEsíPropiedades y labels, varios elementos.
DELETE, DETACH DELETEsí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 INDEXESsíSolo la forma simple (sin YIELD, BRIEF, VERBOSE).
CREATE CONSTRAINT, CREATE INDEX, CREATE VECTOR INDEX, CREATE FULLTEXT INDEX, DROP INDEX, DROP VECTOR INDEXsíDebe ser la única sentencia de la petición. Consulta Esquema.
PROFILEnoUsa EXPLAIN VERBOSE.
LOAD CSVnoHaz cargas masivas desde Python (put_nodes, load_parquet_*) o con UNWIND $rows.
USE <graph>noElige el namespace con la conexión (URI, ruta / header HTTP, base de datos Bolt).
CALL { … } IN TRANSACTIONSno
DROP CONSTRAINTno
BEGIN / COMMIT en CyphernoCada sentencia hace auto-commit. Los drivers Bolt pueden ejecutar transacciones explícitas.

Patrones

ElementoSoportadoNotas
(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:LabelsíPredicados de label en expresiones.
(n:A&B), (n:!A), (n:%)noExpresiones 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..msí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 MATCHnoIndica las claves explícitamente, por ejemplo en WHERE.
Patrones de camino cuantificados ((a)-[]->(b)){1,3}noUsa relaciones de longitud variable.

Un MATCH nunca vincula la misma relación dos veces dentro de un patrón.

Expresiones

CategoríaSoportado
Literalesenteros, 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 propiedadesn.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 listasconcatenación +, [i], índice negativo, slices [a..b], [..b], [a..], IN
Comparación= <> < > <= >=; 1 = 1.0 es true; comparar tipos incompatibles produce NULL
BooleanosAND OR XOR NOT con lógica de tres valores
Pruebas de nullIS NULL, IS NOT NULL
Predicados de stringsSTARTS WITH, ENDS WITH, CONTAINS, =~ (regex de coincidencia completa, (?i) para no distinguir mayúsculas)
CASEsimple (CASE x WHEN …) y con búsqueda (CASE WHEN …)
List comprehension[x IN list WHERE pred | expr]
Cuantificadoresany(…), all(…), none(…), single(…)
Foldreduce(acc = init, x IN list | expr)
Pattern comprehension[(a)-[:T]->(b) | b.name], como elemento de proyección de nivel superior
ExistencialesEXISTS { MATCH … [WHERE …] }, EXISTS { (a)-->() }, exists((a)-->()), predicado de patrón simple WHERE (a)-[:T]->()
No soportadoproyecció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

TipoNotas
INTEGERCon signo de 64 bits. El desbordamiento aritmético da la vuelta; mantén los valores bien dentro del rango.
FLOATIEEE 754 de 64 bits.
STRING, BOOLEAN, NULL
LISTHeterogénea. Una lista de flotantes guardada en una propiedad cubierta por un índice vectorial se convierte en VECTOR.
MAPClaves string.
BYTESA partir de parámetros bytes de Python; base64 en JSON.
VECTORVector denso f32 (vector([…]), o una lista de flotantes bajo un índice vectorial). size(v) es su dimensión.
DATEdate(), date('YYYY-MM-DD'). Comparable; el acceso a componentes (d.year) retorna NULL.
DATETIMEUTC, precisión de microsegundos. datetime(), datetime('…ISO-8601…') (los offsets se convierten a UTC); localdatetime(…) se trata como UTC.
NODE, RELATIONSHIP, PATH
No soportadoDURATION, 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.

ProcedimientoPropósitoPágina
db.labels(), db.relationshipTypes(), db.propertyKeys(), db.schema.visualization()Introspección del esquemaEsquema
search.vector, db.index.vector.queryNodes, search.bm25, search.hybridRecuperación vectorial, full-text e híbridaBúsqueda
algo.wcc, algo.scc, algo.pagerank, algo.degree, algo.triangle_count, algo.label_propagation, algo.louvain, algo.betweenness, algo.shortest_path, algo.fastRPAlgoritmos de grafosAlgoritmos

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.