Importar y exportar
Importar
Desde la consola
Abre una base de datos y luego Import (owners, admins y developers):
- Elige un archivo: CSV o TSV con una fila de encabezado, un array JSON de objetos, o JSON Lines. El archivo se lee en tu navegador.
- Mapéalo a nodos de un label (elige los tipos de las propiedades, una
clave opcional para hacer
MERGEy, opcionalmente, un constraint de unicidad sobre esa clave), o a relaciones entre nodos existentes que se encuentran por clave. - Previsualiza las primeras filas y luego presiona Import.
Las filas se cargan en lotes; cada lote es una petición de escritura. El
importador espera cuando hay límites de uso, divide los lotes demasiado grandes
y aísla una fila que falla para que el resto se cargue igual; las filas
fallidas se listan al final con su número de registro. Puedes pausar, reanudar
o detener una ejecución: los lotes con MERGE se pueden repetir sin problema.
| Plan | Archivo más grande | Máximo de registros por archivo |
|---|---|---|
| Free | 10 MB | 100,000 |
| Pro | 100 MB | 1,000,000 |
| Scale | 250 MB | 2,500,000 |
Cada importación queda en el registro de auditoría con sus conteos. Una base de datos vacía también ofrece Load sample dataset (un grafo de películas con 18 películas, 47 personas y 81 relaciones) desde la pestaña Query.
Desde código
Los SDKs agrupan las filas en lotes por ti (1,000 filas o 1 MiB por lote por defecto), esperan cuando hay límites de uso y arranques en frío, y dividen un lote demasiado grande.
import { NamiDB } from '@namidb/cloud';
const db = new NamiDB();await db.query('movies', 'CREATE CONSTRAINT IF NOT EXISTS FOR (p:Person) REQUIRE p.id IS UNIQUE');
await db.importNodes('movies', people, { label: 'Person', key: 'id' });await db.importRelationships('movies', follows, { type: 'FOLLOWS', from: { label: 'Person', key: 'id' }, to: { label: 'Person', key: 'id' },});
// Any statement that reads $rows:await db.bulkWrite('movies', 'UNWIND $rows AS row MERGE (m:Movie {title: row.title})', titles, { idempotent: true });from namidb_cloud import NamiDB
db = NamiDB()db.query("movies", "CREATE CONSTRAINT IF NOT EXISTS FOR (p:Person) REQUIRE p.id IS UNIQUE")
db.import_nodes("movies", people, label="Person", key="id")db.import_relationships( "movies", follows, rel_type="FOLLOWS", from_label="Person", from_key="id", to_label="Person", to_key="id",)
db.bulk_write("movies", "UNWIND $rows AS row MERGE (m:Movie {title: row.title})", titles, idempotent=True)namidb import movies people.csv --label Person --key idnamidb import movies follows.jsonl --type FOLLOWS --from Person.id --to Person.idConsejos:
- Crea primero un constraint de unicidad sobre la clave, para que cada
MERGEsea una búsqueda puntual en lugar de un recorrido completo. - Importa los nodos antes que las relaciones que los conectan.
- Las cargas grandes de una sola vez usan muchas peticiones de escritura: una importación de 10 millones de filas a 1,000 filas por lote son 10,000 peticiones de escritura.
Exportar
Una exportación es una copia portable de una base de datos, escrita como archivos que descargas. Es un snapshot de un punto en el tiempo: contiene la base de datos exactamente como estaba cuando empezó la exportación. Las escrituras hechas mientras se ejecuta no se incluyen, así que los totales y las relaciones siempre coinciden.
Desde la consola: página de la base de datos → Export (owners y admins;
confirma con tu segundo factor si usas uno). Con la API:
POST /databases/{database}/exports (scope write), y luego consulta
GET /exports/{id}. Con la CLI: namidb exports create movies --wait, y luego
namidb exports download <id> import.cypher.
Recibes un email cuando está lista, y la
alerta export.ready llega a tus webhooks y
a los destinatarios elegidos en la página Alerts. Cada exportación contiene:
| Archivo | Contenido |
|---|---|
nodes.jsonl | Un nodo por línea: id, labels, propiedades |
relationships.jsonl | Una relación por línea: tipo, ids de los nodos de inicio y fin, propiedades |
import.cypher | Una sentencia por línea que recrea el esquema (restricciones e índices de rango, de texto completo y vectoriales), los nodos y las relaciones en NamiDB o Neo4j |
manifest.json | Conteos, el momento del snapshot (snapshot.taken_at), y el tamaño y el SHA-256 de cada archivo |
- Los archivos se pueden descargar durante 7 días y luego se eliminan
(
410 export_expireddespués de eso). Cada descarga queda en el registro de auditoría. - Una exportación por base de datos a la vez (
409 export_in_progress), y 20 por organización cada 24 horas. - Las exportaciones no se facturan como peticiones. Sus archivos cuentan como almacenamiento mientras existen, y mientras se ejecuta, una exportación trabaja sobre una copia temporal de la base de datos, que cuenta como almacenamiento hasta que la exportación termina.
- Los nodos con muchísimas relaciones se exportan completos.
import.cypherrecrea los índices de texto completo y vectoriales (con la dimensión y la función de similitud). Un índice vectorial que usa opciones de construcción propias de NamiDB se escribe con la sintaxis de NamiDB después de un comentario// NamiDB only; omite esa sentencia al cargar en Neo4j.
Cargar una exportación
import.cypher está pensado para una base de datos vacía. Contiene una
sentencia por línea, cada una terminada en ; y lo bastante pequeña para una
petición, más líneas de comentario //. Ejecuta las sentencias en orden:
# With the CLI's shell (stops at the first error):namidb shell movies-copy < import.cypher
# Or with curl, one statement per request:grep -v '^//' import.cypher | while IFS= read -r stmt; do jq -n --arg q "${stmt%;}" '{query: $q}' | curl -sf https://db.namidb.com/v1/movies-copy/cypher \ -H "Authorization: Bearer $NAMIDB_API_KEY" -H "Content-Type: application/json" -d @- > /dev/null || { echo "failed: ${stmt:0:80}"; break; }doneLos nodos reciben un label y una propiedad temporales durante la carga para que
las relaciones puedan encontrar sus extremos; la última sentencia los quita. El
mismo archivo se carga en un servidor self-hosted o en Neo4j
(cypher-shell -f import.cypher; en Neo4j, elimina también el constraint
temporal que se nombra en el último comentario del archivo).
Exportar cuando no puedes consultar
Tus datos siguen siendo exportables incluso cuando se rechazan las consultas:
- una organización suspendida todavía puede exportar desde la consola;
- una organización eliminada se puede exportar durante su periodo de recuperación de 30 días desde la página de tu cuenta (Exports).