Saltearse al contenido

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 path
db = namidb.Client("file://./data?ns=dev") # relative to the working directory
Ventana de terminal
namidb-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:

Ventana de terminal
# 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/namidb
docker 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.