digna CLI Reference 2026.04¶

2026-04-08

Esta página documenta el conjunto completo de comandos disponibles en la CLI de digna versión 2026.04, incluidos ejemplos de uso y opciones.

Conceptos básicos de la CLI¶

help¶

La opción --help proporciona información sobre los comandos disponibles y su uso. Hay dos formas principales de usar esta opción:

1. Mostrar ayuda general:

   Use --help inmediatamente después del comando dignacli
   

   dignacli --help
   

2. Obtener ayuda para comandos específicos:

   Para obtener información detallada sobre un comando específico, añada --help a ese comando. Por ejemplo, para obtener ayuda del comando add-user, ejecute:

   dignacli add-user --help
   

   ### salida:

   • Descripción del comando: Ofrece una descripción detallada de lo que hace el comando.
   • Sintaxis: Muestra la sintaxis exacta, incluidos los argumentos requeridos y opcionales.
   • Opciones: Lista las opciones específicas del comando, junto con sus explicaciones.
   • Ejemplos: Proporciona ejemplos de cómo ejecutar el comando de forma efectiva.

check-config¶

El comando check-config es una utilidad de la CLI de digna diseñada para probar la configuración de digna. Este comando verifica que los componentes de digna puedan encontrar los elementos de configuración necesarios en el archivo config.toml.

Opciones¶

• --configpath, -cp: Archivo o directorio que contiene la configuración. Si se omite, se usará ../config.toml.

Uso del comando¶

dignacli check-config

Al ejecutarse correctamente, el comando muestra una confirmación de que la configuración está completa.

Si la configuración está incompleta, se listarán los elementos de configuración faltantes.

check-repo-connection¶

El comando check-repo-connection es una utilidad de la CLI de digna diseñada para probar la conectividad y el acceso a un repositorio de digna especificado. Este comando asegura que la CLI pueda interactuar con el repositorio.

Uso del comando¶

dignacli check-repo-connection

Al ejecutarse correctamente, el comando muestra una confirmación de la conexión, junto con detalles sobre el repositorio: versión del repositorio, host, base de datos y esquema.

Si la conexión al repositorio no tiene éxito, verifique el archivo config.toml para comprobar la configuración.

version¶

Para comprobar la versión instalada de dignacli, use la opción --version.

Uso del comando¶

dignacli --version

Ejemplo de salida¶

dignacli version 2026.04

opciones de registro¶

Por defecto, la salida por consola de los comandos de digna está diseñada para ser minimalista. La mayoría de los comandos ofrecen la posibilidad de proporcionar información adicional utilizando las siguientes opciones:

-- verbose (-v)
-- debug (-d)
-- logfile (lf)

“verbose” y “debug” definen el nivel de detalle, mientras que la opción “logfile” permite redirigir la salida para que se almacene en un archivo en lugar de mostrarse en la consola.

Gestión de usuarios¶

add-user¶

El comando add-user en la CLI de digna se utiliza para añadir un nuevo usuario al sistema de digna.

Uso del comando¶

dignacli add-user [OPTIONS] USER_NAME USER_FULL_NAME USER_PASSWORD

Argumentos¶

• USER_NAME: El nombre de usuario del nuevo usuario (requerido).
• USER_FULL_NAME: El nombre completo del nuevo usuario (requerido).
• USER_PASSWORD: La contraseña del nuevo usuario (requerido).

Opciones¶

• --is_superuser, -su: Flag para designar al nuevo usuario como administrador.
• --valid_until, -vu: Establece una fecha de expiración para la cuenta del usuario en el formato YYYY-MM-DD HH:MI:SS. Si no se establece, la cuenta no tendrá fecha de caducidad.

Ejemplo¶

Para añadir un nuevo usuario con nombre de usuario jdoe, nombre completo John Doe y contraseña password123:

dignacli add-user [OPTIONS] USER_NAME USER_FULL_NAME USER_PASSWORD

Para añadir un nuevo usuario y establecer una fecha de expiración de la cuenta:

dignacli add-user jdoe "John Doe" password123 --valid_until "2024-12-31 23:59:59"

delete-user¶

El comando delete-user en la CLI de digna se utiliza para eliminar un usuario existente del sistema de digna.

Uso del comando¶

dignacli delete-user USER_NAME

Argumentos¶

• USER_NAME: El nombre de usuario del usuario a eliminar (requerido). Este es el único argumento requerido por el comando.

Ejemplo¶

dignacli delete-user jdoe

Al ejecutar este comando se eliminará el usuario jdoe del sistema de digna, revocando su acceso y borrando los datos y permisos asociados en el repositorio.

modify-user¶

El comando modify-user en la CLI de digna se utiliza para actualizar los datos de un usuario existente en el sistema de digna.

Uso del comando¶

dignacli modify-user <USER_NAME> <USER_FULL_NAME> [options]

Argumentos¶

• USER_NAME: El nombre de usuario del usuario a modificar (requerido).
• USER_FULL_NAME: El nuevo nombre completo del usuario (requerido).

Opciones¶

• --is_superuser, -su: Establece al usuario como superusuario, otorgándole privilegios elevados. Este flag no requiere un valor.
• --valid_until, -vu: Establece una fecha de expiración para la cuenta del usuario en el formato YYYY-MM-DD HH:MI:SS. Si no se proporciona, la cuenta permanecerá válida indefinidamente.

Ejemplo¶

Para modificar el nombre completo del usuario jdoe a “Johnathan Doe” y convertirlo en superusuario:

dignacli modify-user jdoe "Johnathan Doe" --is_superuser

modify-user-pwd¶

El comando modify-user-pwd en la CLI de digna se utiliza para cambiar la contraseña de un usuario existente en el sistema de digna.

Uso del comando¶

dignacli modify-user-pwd <USER_NAME> <USER_PWD>

Argumentos¶

• USER_NAME: El nombre de usuario del cual se va a cambiar la contraseña (requerido).
• USER_PWD: La nueva contraseña del usuario (requerido).

Ejemplo¶

Para cambiar la contraseña del usuario jdoe a newpassword123:

dignacli modify-user-pwd jdoe newpassword123

list-users¶

El comando list-users en la CLI de digna muestra una lista de todos los usuarios registrados en el sistema de digna.

Uso del comando¶

dignacli list-users

Al ejecutar este comando, la CLI de digna se conectará al repositorio de digna y listará todos los usuarios, mostrando su ID, nombre de usuario, nombre completo, estado de superusuario y timestamps de expiración.

Gestión del repositorio¶

upgrade-repo¶

El comando upgrade-repo en la CLI de digna se utiliza para actualizar o inicializar el repositorio de digna. Este comando es esencial para aplicar actualizaciones o configurar la infraestructura del repositorio por primera vez.

Uso del comando¶

dignacli upgrade-repo [options]

Opciones¶

• --simulation-mode, -s: Cuando está habilitado, este modo ejecuta el comando en modo simulación, que imprime las sentencias SQL que se ejecutarían pero no las ejecuta realmente. Esto es útil para ver los cambios sin modificar el repositorio.

Ejemplo¶

Para actualizar el repositorio de digna, puede ejecutar el comando sin opciones:

dignacli upgrade-repo

dignacli upgrade-repo --simulation-mode

Este comando es crucial para mantener el sistema de digna, asegurando que el esquema de la base de datos y otros componentes del repositorio estén actualizados con la última versión del software.

encrypt¶

El comando encrypt en la CLI de digna se utiliza para cifrar una contraseña.

Uso del comando¶

dignacli encrypt <PASSWORD>

Argumentos¶

• PASSWORD: La contraseña que necesita ser cifrada (requerido).

Ejemplo¶

Para cifrar una contraseña, debe proporcionar la contraseña como argumento.
Por ejemplo, para cifrar la contraseña mypassword123, usaría:

dignacli encrypt mypassword123

generate-key¶

El comando generate-key se utiliza para generar una clave Fernet, que es esencial para proteger las contraseñas almacenadas en el repositorio de digna.

Uso del comando¶

dignacli generate-key

Gestión de datos¶

clean-up¶

El comando clean-up en la CLI de digna se utiliza para eliminar perfiles, predicciones y datos del sistema de semáforo (traffic light system) para una o varias fuentes de datos dentro de un proyecto especificado. Este comando es esencial para la gestión del ciclo de vida de los datos, ayudando a mantener un entorno de datos organizado y eficiente al limpiar datos obsoletos o innecesarios.

Uso del comando¶

dignacli clean-up <PROJECT_NAME> <FROM_DATE> <TO_DATE> [options]

Argumentos¶

• PROJECT_NAME: El nombre del proyecto del que se eliminarán los datos (requerido). Usar la palabra clave all-projects en este argumento indica a digna que itere sobre todos los proyectos existentes y aplique este comando.
• FROM_DATE: La fecha y hora de inicio para la eliminación de datos. Los formatos aceptables incluyen %Y-%m-%d, %Y-%m-%dT%H:%M:%S, o %Y-%m-%d %H:%M:%S (requerido).
• TO_DATE: La fecha y hora de fin para la eliminación de datos, siguiendo los mismos formatos que FROM_DATE (requerido).

Opciones¶

• --table-name, -tn: Limita la operación de limpieza a una tabla específica dentro del proyecto.
• --table-filter, -tf: Filtros para limitar la limpieza a tablas que contengan la subcadena especificada en sus nombres.
• --timing, -tm: Muestra la duración del proceso de limpieza después de su finalización.
• --help: Muestra información de ayuda para el comando clean-up y sale.

Ejemplo¶

Para eliminar datos del proyecto ProjectA entre el 1 de enero de 2023 y el 30 de junio de 2023:

dignacli clean-up ProjectA 2023-01-01 2023-06-30

Para eliminar datos solo de una tabla específica llamada Table1:

dignacli clean-up ProjectA 2023-01-01 2023-06-30 --table-name Table1

Este comando ayuda a gestionar el almacenamiento de datos y a garantizar que el repositorio solo contenga información relevante.

remove-orphans¶

El comando remove-orphans en la CLI de digna se utiliza para tareas de mantenimiento en el repositorio de digna.
Cuando un usuario elimina proyectos o fuentes de datos, los perfiles y predicciones pueden permanecer en el repositorio. Con este comando, esas filas huérfanas se eliminarán del repositorio.

Uso del comando¶

dignacli list-projects

list-projects¶

El comando list-projects en la CLI de digna se utiliza para mostrar una lista de todos los proyectos disponibles en el sistema de digna.

Uso del comando¶

dignacli list-projects

Este comando es especialmente útil para administradores y usuarios que gestionan múltiples proyectos, proporcionando una visión rápida de los proyectos disponibles en el repositorio de digna.

list-ds¶

El comando list-ds en la CLI de digna se utiliza para mostrar una lista de todas las fuentes de datos disponibles dentro de un proyecto especificado. Este comando es útil para entender los activos de datos disponibles para análisis y gestión en el sistema de digna.

Uso del comando¶

dignacli list-ds <PROJECT_NAME>

Argumentos¶

• PROJECT_NAME: El nombre del proyecto para el cual se listan las fuentes de datos (requerido).

Ejemplo¶

Para listar todas las fuentes de datos en el proyecto llamado ProjectA:

dignacli list-ds ProjectA

Este comando proporciona a los usuarios una visión general de las fuentes de datos disponibles en un proyecto, ayudándoles a navegar y gestionar el panorama de datos de forma más efectiva.

inspect¶

El comando inspect en la CLI de digna se utiliza para crear perfiles, predicciones y datos del sistema de semáforo para una o varias fuentes de datos dentro de un proyecto especificado. Este comando ayuda a analizar y monitorizar los datos durante un período definido. Al completar la inspección, se devuelve el valor del sistema de semáforo calculado:
- 0: OK
- 1: INFO
- 2: WARNING

Uso del comando¶

dignacli inspect <PROJECT_NAME> <FROM_DATE> <TO_DATE> [options]

Argumentos¶

• PROJECT_NAME: El nombre del proyecto que se va a inspeccionar (requerido). Usar la palabra clave all-projects en este argumento indica a digna que itere sobre todos los proyectos existentes y aplique este comando.
• FROM_DATE: La fecha y hora de inicio para la inspección de datos. Los formatos aceptables incluyen %Y-%m-%d, %Y-%m-%dT%H:%M:%S, o %Y-%m-%d %H:%M:%S (requerido).
• TO_DATE: La fecha y hora de fin para la inspección de datos, siguiendo los mismos formatos que FROM_DATE (requerido).

Opciones¶

• --table-name, -tn: Limita la inspección a una tabla específica dentro del proyecto.
• --table-filter, -tf: Filtra para inspeccionar solo tablas que contengan la subcadena especificada en sus nombres.
• --enable_notification, -en: Habilita el envío de notificaciones en caso de alertas.
• --bypass-backend, -bb: Omite el backend y ejecuta la inspección directamente desde la CLI (¡solo para pruebas!).

Ejemplo¶

Para inspeccionar datos del proyecto ProjectA desde el 1 de enero de 2024 hasta el 31 de enero de 2024:

dignacli inspect ProjectA 2024-01-01 2024-01-31

Para inspeccionar solo una tabla específica y forzar el recálculo de predicciones:

dignacli inspect ProjectA 2024-01-01 2024-01-31 --table-name Table1 --force-prediction

inspect-async¶

El comando inspect-async en la CLI de digna se utiliza para crear perfiles, predicciones y datos del sistema de semáforo para una o varias fuentes de datos dentro de un proyecto especificado. Este comando ayuda a analizar y monitorizar datos durante un periodo definido. A diferencia del comando síncrono, este no espera a que la inspección termine. En su lugar, devuelve el id de la solicitud para la inspección enviada. Para consultar el progreso del proceso de inspección, use el comando inspect-status.

Uso del comando¶

dignacli inspect-async <PROJECT_NAME> <FROM_DATE> <TO_DATE> [options]

Argumentos¶

• PROJECT_NAME: El nombre del proyecto que se va a inspeccionar (requerido). Usar la palabra clave all-projects en este argumento indica a digna que itere sobre todos los proyectos existentes y aplique este comando.
• FROM_DATE: La fecha y hora de inicio para la inspección de datos. Los formatos aceptables incluyen %Y-%m-%d, %Y-%m-%dT%H:%M:%S, o %Y-%m-%d %H:%M:%S (requerido).
• TO_DATE: La fecha y hora de fin para la inspección de datos, siguiendo los mismos formatos que FROM_DATE (requerido).

Opciones¶

• --table-name, -tn: Limita la inspección a una tabla específica dentro del proyecto.
• --table-filter, -tf: Filtra para inspeccionar solo tablas que contengan la subcadena especificada en sus nombres.
• --enable_notification, -en: Habilita el envío de notificaciones en caso de alertas.

Ejemplo¶

Para inspeccionar datos del proyecto ProjectA desde el 1 de enero de 2024 hasta el 31 de enero de 2024:

dignacli inspect-async ProjectA 2024-01-01 2024-01-31

inspect-status¶

El comando inspect-status en la CLI de digna se utiliza para comprobar el progreso de una inspección asincrónica basada en el ID de la solicitud.

Uso del comando¶

dignacli inspect-status <REQUEST ID>

Argumentos¶

• REQUEST_ID: El id de la solicitud devuelto por el comando inspect-async.

Ejemplo¶

Para comprobar el progreso de una inspección con request ID 12345:

dignacli inspect-status 12345

inspect-cancel¶

El comando inspect-cancel en la CLI de digna se utiliza para cancelar inspecciones basadas en el ID de la solicitud o puede usarse para cancelar todas las solicitudes actuales.

Uso del comando¶

dignacli inspect-cancel <REQUEST ID>
dignacli inspect-cancel --killall

Argumentos¶

• REQUEST_ID: El id de la solicitud devuelto por el comando inspect-async.

Ejemplo¶

Para cancelar la inspección con request ID 12345:

dignacli inspect-cancel 12345

Para cancelar todas las solicitudes que se estén ejecutando o estén pendientes:

dignacli inspect-cancel --killall

export-ds¶

El comando export-ds en la CLI de digna se utiliza para crear una exportación de las fuentes de datos desde el repositorio de digna. Por defecto, se exportarán todas las fuentes de datos de un proyecto dado.

Uso del comando¶

dignacli export-ds <PROJECT_NAME> [options]

Argumentos¶

• PROJECT_NAME: El nombre del proyecto desde el cual se exportarán las fuentes de datos.

Opciones¶

• --table_name, -tn: Exporta una fuente de datos particular de un proyecto.
• --exportfile, -ef: Especifica el nombre de archivo para la exportación.

Ejemplo¶

Para exportar todas las fuentes de datos del proyecto llamado ProjectA:

dignacli export-ds ProjectA

Este comando exporta todas las fuentes de datos de ProjectA como un documento JSON que puede importarse a otro proyecto o repositorio de digna.

import-ds¶

El comando import-ds en la CLI de digna se utiliza para importar fuentes de datos a un proyecto destino y crear un informe de importación.

Uso del comando¶

dignacli import-ds <PROJECT_NAME> <EXPORT_FILE> [options]

Argumentos¶

• PROJECT_NAME: El nombre del proyecto al que se importarán las fuentes de datos.
• EXPORT_FILE: El nombre del archivo de exportación de las fuentes de datos a importar.

Opciones¶

• --output-file, -o: Archivo donde guardar el informe de importación (si no se especifica, se imprime en la terminal en forma tabular).
• --output-format, -f: Formato para guardar el informe de importación (json, csv).

Ejemplo¶

Para importar todas las fuentes de datos del archivo de exportación my_export.json en ProjectB:

dignacli import-ds ProjectB my_export.json

Después de la importación, este comando también mostrará un informe de los objetos importados y omitidos. Solo se importarán nuevas fuentes de datos en ProjectB. Para saber qué objetos serían importados y cuáles omitidos, puede usar el comando plan-import-ds.

plan-import-ds¶

El comando plan-import-ds en la CLI de digna se utiliza para analizar una exportación de fuentes de datos respecto a un proyecto destino y crear un informe previo a la importación.

Uso del comando¶

dignacli plan-import-ds <PROJECT_NAME> <EXPORT_FILE> [options]

Argumentos¶

• PROJECT_NAME: El nombre del proyecto al que se importarían las fuentes de datos.
• EXPORT_FILE: El nombre del archivo de exportación de las fuentes de datos que se analizará antes de la importación.

Opciones¶

• --output-file, -o: Archivo donde guardar el informe de importación (si no se especifica, se imprime en la terminal en forma tabular).
• --output-format, -f: Formato para guardar el informe de importación (json, csv).

Ejemplo¶

Para comprobar qué fuentes de datos se importarían y cuáles se omitirían desde el archivo de exportación my_export.json al importarlo en ProjectB:

dignacli plan-import-ds ProjectB my_export.json

Este comando solo mostrará un plan de importación de objetos a importar y a omitir.