Presentación comercial: Ver la presentación · Recibir los PDF
Qué es NSAdaDB
nsadadb copia un fichero Adabas a una base de datos relacional o documental, verifica que origen y destino contienen los mismos datos y sincroniza solo lo que ha cambiado. Tres comandos:
copy— carga inicial (modosmerge,empty,drop).compare— informe de diferencias de solo lectura (iguales / faltan / cambiados / sobran). Sale0si coinciden,1si hay diferencias.sync— aplica solo faltantes y cambiados; con-delete-missingborra además los sobrantes en destino.
Destinos: sqlite · postgres · mariadb (mysql) · mssql (sqlserver) · oracle · mongo (mongodb) · elasticsearch · cassandra (scylla) · kafka (solo copy; db2 no está soportado).
Los números de base de datos, ficheros, campos y rutas de los ejemplos son ficticios.
Casos de uso
1. Réplica operacional en SQLite
Carga inicial con recreación de tabla y sincronización nocturna del diff.
nsadadb copy -dbid 50 -fnr 15 -kind sqlite -path ./replica.db -table CUSTOMERS -mode drop
nsadadb sync -dbid 50 -fnr 15 -kind sqlite -path ./replica.db -table CUSTOMERS -delete-missing
2. Migración a PostgreSQL con nombres DDM
Copia usando el diccionario lógico y un fichero de destino para no exponer el DSN.
# dst.yaml
kind: postgres
dsn: postgres://usuario:clave@host:5432/demo?sslmode=disable
table: CUSTOMERS
nsadadb copy -dbid 50 -config ddm50.json -ddmname MI-FICHERO -target dst.yaml -mode drop
nsadadb compare -dbid 50 -config ddm50.json -ddmname MI-FICHERO -target dst.yaml -json
3. Publicación a Kafka para el lago de datos
Cada ISN viaja como un JSON con clave = ISN (los borrados son tombstones).
nsadadb copy -dbid 50 -fnr 15 -kind kafka -dsn kafka://host:9092/adabas -table CUSTOMERS
4. Conciliación auditable
compare con resumen JSON demuestra que origen y destino coinciden ISN a ISN.
nsadadb compare -dbid 50 -fnr 15 -kind oracle -dsn "oracle://u:p@host:1521/svc" -table CUSTOMERS -json -outfile diff.json
5. MU/PE en tablas hijas
Con -mu-pe child los grupos se normalizan en <tabla>__<grupo> con PK(isn, idx); los MU escalares van a una columna VALUE. Los borrados propagan en cascada.
nsadadb copy -dbid 50 -fnr 15 -kind postgres -dsn "..." -table CUSTOMERS -mu-pe child -mode drop
Referencia de opciones
| Opción | Descripción |
|---|---|
copy|compare|sync | Comando a ejecutar (primer argumento). |
-dbid | Base Adabas de origen. Obligatorio. |
-fnr / -ddmname -config | Fichero por número o por nombre lógico DDM. |
-kind, -dsn/-path, -table | Destino, conexión y tabla/colección/índice/topic. O todo en -target YAML. |
-fields, -search, -sortby | Selección del origen (no -fields con -mu-pe child). |
-fromisn, -toisn, -limit | Ventana de ISN y tope de registros. |
-mode merge|empty|drop | Modo de copy (defecto merge). |
-delete-missing | Tratar también las filas solo-destino (se omite con origen filtrado). |
-mu-pe json|child | Grupos MU/PE como JSON (defecto) o tablas hijas (solo relacionales). |
-batch, -workers | Filas por escritura bulk (500) y workers paralelos (4). |
-state, -resume | Checkpoint cada 5000 registros y reanudación. |
-dry-run | Previsualiza sin escribir. |
-json, -outfile | Resumen máquina y fichero de detalle (hasta 10.000 líneas). |
-multifetch, -blocksize | Ajuste de lectura Adabas. |
-silence, -debug | Silencio y traza de diagnóstico. |
Códigos de salida
0— éxito (compare: mismos datos).1— error de parámetros, ocompareencontró diferencias.2— error de configuración, conexión o aplicación.
Licencia
Licencia propia del producto: license.key firmado para app=nsadadb en
$NS_HOME/licenses/nsadadb.key (modo 0600). Sin licencia válida el binario no
opera; no existe trial automático (un trial es una licencia firmada emitida con
nslm issue --trial). -license-status muestra el estado, la vigencia y el
fingerprint de esta aplicación en esta máquina. Las builds demo se detienen a
los 50 registros.