Sistema de archivos local
file:// guarda un namespace en un directorio del disco local. Usa el mismo
protocolo de commit que los backends de object store: cada puntero del
manifest se crea exactamente una vez, y O_CREAT | O_EXCL da la garantía
PUT-if-absent que S3 da con If-None-Match: *.
import namidb
db = namidb.Client("file:///var/lib/namidb?ns=prod") # absolute pathdb = namidb.Client("file://./data?ns=dev") # relative to the working directorynamidb-server --store "file:///var/lib/namidb?ns=prod" --auth-token "$NAMIDB_AUTH_TOKEN"namidb run --store "file:///var/lib/namidb?ns=prod" "MATCH (n) RETURN count(n) AS n"El directorio se crea si no existe. Un mismo directorio puede contener
muchos namespaces uno al lado del otro (/var/lib/namidb/prod,
/var/lib/namidb/staging, …). Consulta
URIs de almacenamiento
para ver la organización dentro de un namespace.
Un writer por namespace
Solo un proceso puede escribir un namespace a la vez. Un proceso que lo
abre para escritura (un servidor, un run de la CLI, un Client de Python
con escritura, un servidor MCP) lo reclama y bloquea (fencing) al writer
anterior. Para leer un namespace en el que escribe otro proceso, ábrelo con
namidb.Client(uri, read_only=True); consulta
Embebido (Python).
Volúmenes de Docker
La imagen oficial corre como uid/gid 65532 y es dueña de
/var/lib/namidb:
# A named volume inherits the right ownership:docker run -v namidb-data:/var/lib/namidb -e NAMIDB_AUTH_TOKEN \ namidb/namidb-server:3.3.0 --store "file:///var/lib/namidb?ns=prod"
# A bind mount needs the ownership fixed once on the host:sudo chown -R 65532:65532 /srv/namidbdocker run -v /srv/namidb:/var/lib/namidb -e NAMIDB_AUTH_TOKEN \ namidb/namidb-server:3.3.0 --store "file:///var/lib/namidb?ns=prod"Los volúmenes con nombre creados con dueño root por imágenes anteriores a
2.2.0 necesitan el mismo chown.
FUSE y sistemas de archivos de red
Los bind mounts respaldados por FUSE (por ejemplo, el uso compartido de
archivos de Docker Desktop en macOS) y algunos sistemas de archivos de red
reportan metadatos de archivos inestables. Los archivos de datos se
escriben una sola vez con nombres nuevos, así que NamiDB fija las lecturas
a la ruta inmutable en lugar de al ETag derivado de stat, y esos montajes
funcionan. Define NAMIDB_LOCAL_ETAG_PIN=1 para volver a fijar por ETag,
por ejemplo si algo distinto de NamiDB reescribe archivos en el lugar dentro
del directorio del store (no debería).
El sistema de archivos debe respetar la creación exclusiva
(O_CREAT | O_EXCL) para que el protocolo de commit sea seguro. Los discos
locales lo hacen; compruébalo antes de apuntar dos hosts a un mismo
directorio de red compartido, y recuerda que solo uno de ellos puede
escribir un namespace dado.
Espacio temporal
El flush y la compactación escriben archivos temporales. El cliente de
Python los pone por defecto en <root>/.namidb-spool junto al grafo; el
servidor usa NAMIDB_SPOOL_DIR (/var/tmp para el binario solo,
/var/tmp/namidb-spool en la imagen). Mantén el spool en disco, no en un
tmpfs respaldado por RAM. Consulta
Memoria y cachés.
Backups
No copies el directorio de un namespace que está abierto para escritura:
una copia tomada en medio de un commit puede capturar un conjunto
inconsistente de archivos. Usa namidb backup, o el endpoint de backup en
línea del servidor, que fijan una versión consistente. Consulta
Backup y restore.