Saltearse al contenido

Operadores y funciones

Los nombres de función no distinguen mayúsculas (toUpper, toupper y TOUPPER son la misma). Una función que no aparece aquí falla con function name is not supported (HTTP 400, code: "unsupported"). Salvo que se indique lo contrario, un argumento NULL da un resultado NULL.

Operadores

OperadorSignificadoEjemplo → resultado
+Suma números; concatena strings o listas1 + 2 → 3, 'a' + 1 → 'a1', [1] + [2] → [1, 2]
-, *Resta, multiplicación7 * 3 → 21
/División. Entero entre entero trunca hacia cero7 / 2 → 3, -7 / 2 → -3, 7.0 / 2 → 3.5
%Resto (con el signo del dividendo)7 % -3 → 1
^Potencia, siempre un flotante2 ^ 10 → 1024.0
-xNegación-3
= <>Igualdad. 1 = 1.0 es true; las listas y los mapas se comparan estructuralmente[1,2] = [1,2] → true
< > <= >=Orden para números, strings, fechas y datetimes. Los tipos incompatibles dan NULL'abc' < 'abd' → true, 1 < 'a' → null
AND OR XOR NOTLógica de tres valoresnull AND false → false, null OR true → true
IS NULL, IS NOT NULLPrueba de nullnull IS NULL → true
INPertenencia a una lista (consciente de NULL)1 IN [1, null] → true, 2 IN [1, null] → null
STARTS WITH, ENDS WITH, CONTAINSPruebas de strings, distinguen mayúsculas'abc' CONTAINS 'b' → true
=~Expresión regular, debe coincidir con el string completo. (?i) para no distinguir mayúsculas'Alice' =~ '(?i)al.*' → true
x[i]Índice de lista, negativo desde el final[1,2,3][-1] → 3
x[a..b], x[..b], x[a..]Slice de lista (final exclusivo)[1,2,3,4][1..3] → [2, 3]
m.key, n.propAcceso a clave de mapa o a propiedad{a: 1}.a → 1

La aritmética entera es de 64 bits y da la vuelta al desbordarse (9223372036854775807 + 1 → -9223372036854775808). La división de flotantes entre cero da Infinity; la división entera entre cero es un error.

Grafo e identidad

FunciónRetorna
id(x)El id de un nodo como string UUID; para una relación, "<src>:<dst>".
elementId(x)El id de un nodo (string UUID); para una relación, "<TYPE>-<src>-><dst>".
labels(n)Lista de labels del nodo, ordenada.
type(r)El tipo de la relación.
keys(x)Claves de propiedades de un nodo, una relación o un mapa.
properties(x)Mapa de propiedades de un nodo o una relación.
nodes(p), relationships(p)Los nodos / relaciones de un camino.
length(p)Cantidad de relaciones en un camino.

n._id lee el id del nodo como una propiedad, y MATCH (n:Label {_id: $id}) busca un nodo por él.

Listas

FunciónRetornaEjemplo → resultado
size(x)Longitud de una lista o string (caracteres), tamaño de un mapa o dimensión de un vectorsize('héllo') → 5
head(l), last(l)Primer / último elemento, null para una lista vacíahead([1,2]) → 1
tail(l)Todos los elementos menos el primerotail([1,2,3]) → [2, 3]
reverse(x)Lista o string invertidosreverse([1,2,3]) → [3, 2, 1]
range(start, end[, step])Rango de enteros inclusivorange(0, 10, 3) → [0, 3, 6, 9], range(5, 1, -2) → [5, 3, 1]
coalesce(a, b, …)Primer argumento no nulocoalesce(null, 3) → 3

Expresiones de listas:

FormaEjemplo → resultado
[x IN list WHERE pred | expr][x IN range(1,5) WHERE x % 2 = 1 | x * 10] → [10, 30, 50]
any / all / none / single(x IN list WHERE pred)single(x IN [1,2] WHERE x = 2) → true
reduce(acc = init, x IN list | expr)reduce(s = 0, x IN [1,2,3] | s + x) → 6
[(a)-[:T]->(b) | b.name] (pattern comprehension)lista de los nombres que hicieron match, por fila

Strings

FunciónEjemplo → resultado
toUpper(s), toLower(s)toUpper('straße') → 'STRASSE'
trim(s), ltrim(s), rtrim(s)trim(' a ') → 'a'
left(s, n), right(s, n)left('abc', 2) → 'ab'
substring(s, start[, length])substring('hello', 1, 3) → 'ell'
replace(s, search, replacement)replace('aXbX', 'X', '-') → 'a-b-'
split(s, delimiter)split('a,b', ',') → ['a', 'b']
reverse(s)reverse('ab') → 'ba'
size(s)Cantidad de caracteres

Conversión

FunciónComportamiento
toString(x)Forma de texto de un número, booleano, string, fecha o datetime (toString(date('2026-11-01')) → '2026-11-01').
toInteger(x)Desde un string o un número; los flotantes truncan hacia cero (3.7 → 3). Entrada no interpretable → null.
toFloat(x)Desde un string o un número. No interpretable → null.
toBoolean(x)Desde 'true' / 'false' (sin distinguir mayúsculas), un booleano o los enteros 0 / 1. Cualquier otra cosa → null.

toStringOrNull, toIntegerOrNull y las demás variantes …OrNull no están implementadas; las funciones simples ya retornan null para la entrada que no pueden interpretar.

Matemáticas

FunciónNotas
abs(x)Mismo tipo que la entrada.
sign(x)-1, 0 o 1 (entero).
round(x), floor(x), ceil(x)Retornan un flotante. round acepta un argumento (sin argumento de precisión); los medios se redondean alejándose de cero.
sqrt(x)Flotante; sqrt(-1) es NaN.

No implementadas: exp, log, log10, e, pi, rand, sin y las demás funciones trigonométricas.

Fechas y horas

FunciónRetorna
date()Hoy (UTC) como DATE.
date('YYYY-MM-DD')Un DATE. Las fechas inválidas son un error.
datetime()Ahora como DATETIME en UTC (precisión de microsegundos).
datetime('ISO-8601')Un DATETIME en UTC. Los offsets se convierten ('2026-11-01T10:00:00+02:00' → 08:00 UTC); una fecha sola significa medianoche UTC.
localdatetime(…)Igual que datetime(…), interpretado como UTC.
timestamp()Milisegundos desde el epoch de Unix, como entero.

Las fechas y los datetimes se comparan con <, = y similares, y se ordenan correctamente. Los argumentos de mapa (date({year: 2026, …})), el acceso a componentes (d.year retorna null), duration, time y los tipos con zona horaria no están soportados. Guarda los instantes como DATETIME o como enteros de epoch.

Vectores y puntuación de texto

FunciónRetorna
vector(list)Un vector denso de flotantes. size(v) es su dimensión.
cosine_similarity(a, b)Similitud coseno; mayor es más cercano. NULL cuando algún vector tiene magnitud cero.
dot_product(a, b)Producto punto; mayor es más cercano.
euclidean_distance(a, b)Distancia euclidiana (L2); menor es más cercano.
bm25(text, query)Una puntuación BM25 por fila de text contra query, sin estadísticas de todo el corpus.

Las funciones vectoriales aceptan vectores o listas de flotantes y requieren dimensiones iguales (si no, es un error). Un KNN escrito como ORDER BY cosine_similarity(n.embedding, $q) DESC LIMIT k usa un índice vectorial cuando existe; consulta Búsqueda.

Agregaciones

FunciónNotas
count(*)Filas en el grupo.
count(x)Valores no nulos.
sum(x)0 si no hay valores.
avg(x)Flotante; null si no hay valores.
min(x), max(x)Números, strings, fechas.
collect(x)Lista de valores no nulos.
stdev(x), stdevp(x)Desviación estándar muestral / poblacional.
percentileCont(x, p), percentileDisc(x, p)p entre 0.0 y 1.0; valor interpolado / más cercano.

Todas las agregaciones aceptan DISTINCT: count(DISTINCT n.city), collect(DISTINCT n.age). Las claves de agrupación son los elementos no agregados del mismo RETURN o WITH.