Tu primera consulta
Esta página construye el mismo grafo de dos personas de tres formas
distintas. Cada una usa un namespace en memoria (memory://), así que nada
se escribe en disco y no hay nada que limpiar. Cambia el URI por file://…
o s3://… cuando quieras que los datos persistan — consulta
URIs de almacenamiento.
pip install namidbimport namidb
db = namidb.Client("memory://demo")
db.cypher("CREATE (:Person {name: 'Alice', age: 30})")db.cypher("CREATE (:Person {name: 'Bob', age: 25})")db.cypher(""" MATCH (a:Person {name: 'Alice'}), (b:Person {name: 'Bob'}) CREATE (a)-[:KNOWS {since: 2020}]->(b)""")
rows = db.cypher( "MATCH (p:Person) WHERE p.age >= $min " "RETURN p.name AS name, p.age AS age ORDER BY name", params={"min": 18},).rows()print(rows)# [{'name': 'Alice', 'age': 30}, {'name': 'Bob', 'age': 25}]
friends = db.cypher( "MATCH (a:Person)-[k:KNOWS]->(b:Person) " "RETURN a.name AS a, b.name AS b, k.since AS since").rows()print(friends)# [{'a': 'Alice', 'b': 'Bob', 'since': 2020}]Cada escritura es durable cuando cypher() retorna. Cualquier resultado se
convierte en DataFrame con .to_pandas(), .to_polars() o .to_arrow().
Sin --store, namidb run usa un namespace en memoria descartable, así que
construye y consulta el grafo en un mismo script. Las sentencias separadas
por ; se ejecutan en orden contra el mismo namespace:
namidb run " CREATE (:Person {name: 'Alice', age: 30}); CREATE (:Person {name: 'Bob', age: 25}); MATCH (a:Person {name: 'Alice'}), (b:Person {name: 'Bob'}) CREATE (a)-[:KNOWS {since: 2020}]->(b); MATCH (a:Person)-[k:KNOWS]->(b) RETURN a.name, b.name, k.since"Cada sentencia se anuncia con un encabezado == statement i/n; la última
imprime:
== statement 4/4a.name | b.name | k.since----------------------------"Alice" | "Bob" | 2020Para conservar el grafo entre invocaciones, apunta --store a un
directorio:
namidb run --store "file:///tmp/namidb-demo?ns=demo" \ "CREATE (:Person {name: 'Alice', age: 30})"namidb run --store "file:///tmp/namidb-demo?ns=demo" \ "MATCH (p:Person) RETURN p.name AS name"Inicia un servidor sobre un namespace en memoria (se muestra Docker; el binario del release acepta los mismos flags):
export NAMIDB_AUTH_TOKEN="$(openssl rand -hex 32)"docker run --rm -p 127.0.0.1:8080:8080 -e NAMIDB_AUTH_TOKEN \ namidb/namidb-server:3.3.0 --store memory://demoEn otra shell, con el mismo NAMIDB_AUTH_TOKEN:
q() { curl -s localhost:8080/v0/cypher \ -H "Authorization: Bearer $NAMIDB_AUTH_TOKEN" \ -H 'Content-Type: application/json' -d "$1"; echo}
q '{"query": "CREATE (:Person {name: \"Alice\", age: 30})"}'q '{"query": "CREATE (:Person {name: \"Bob\", age: 25})"}'q '{"query": "MATCH (a:Person {name: \"Alice\"}), (b:Person {name: \"Bob\"}) CREATE (a)-[:KNOWS {since: 2020}]->(b)"}'q '{"query": "MATCH (p:Person) WHERE p.age >= $min RETURN p.name AS name, p.age AS age ORDER BY name", "params": {"min": 18}}'La última llamada retorna:
{"columns":["name","age"],"rows":[{"age":30,"name":"Alice"},{"age":25,"name":"Bob"}]}columns conserva el orden del RETURN; cada fila es un objeto JSON. Las
sentencias de escritura también retornan un write_outcome con contadores.
Siguientes pasos
- Leer datos y Escribir datos
- Embebido (Python) para almacenamientos durables, cargas masivas y clientes de solo lectura
- Servidor HTTP para configuraciones de producción