La herramienta de interfaz de línea de comandos (CLI) de SonnetDB, conocida como sndb, permite administrar instancias de bases de datos de forma eficiente sin depender de interfaces gráficas. Distribuida como una herramienta global de .NET, su despliegue y uso están optimizados para entornos de deasrrollo y operaciones.
Instalación de la herramienta global .NET
Para utilizar sndb, es necesario contar con el SDK de .NET 10 o superior instalado en el sistema. El paquete se distribuye a través del repositorio oficial de NuGet.
Ejecute el siguiente comando para realizar la instalación global:
dotnet tool install --global SonnetDB.CLI
Una vez finalizado el proceso, el binario sndb estará disponible en su terminal. Puede verificar que la instalación es correcta consultando la versión actual:
sndb --version
En caso de que ya disponga de la herramienta y desee actualizarla a la versión más reciente, utilice el comando de actualización:
dotnet tool update --global SonnetDB.CLI
Administración de perfiles de conexión
La CLI emplea un sistema de perfiles almacenados en ~/.sonnetdb/profiles.json para facilitar el acceso a múltiples servidores. Esto permite alternar rápidamente entre entornos locales, de prueba o de producción.
# Registrar un nuevo perfil de conexión
sndb config add servidor-local --host 127.0.0.1 --port 8839 --token su-token-de-acceso
# Consultar la lista de perfiles configurados
sndb config list
# Activar un perfil específico
sndb config use servidor-local
# Mostrar los detalles de la configuración activa
sndb config show
Comandos operativos frecuentes
sndb incluye una variedad de utilidades para supervisar y manipular datos de forma directa:
# Verificar la disponibilidad del servidor
sndb health
# Listar todas las métricas (measurements) existentes
sndb list measurements
# Iniciar el modo interactivo para consultas SQL
sndb sql
# Ejecutar una sentencia SQL de forma directa
sndb sql "SELECT * FROM trafico_red LIMIT 5"
# Cargar datos desde un archivo CSV
sndb import --measurement memoria --file estadisticas.csv
# Exportar registros a un archivo CSV
sndb export --measurement memoria --output respaldo_datos.csv
Interacción mediante REPL (SQL)
El comando sndb sql activa un entorno de lectura, evaluación e impresión (REPL) que emula una terminal de base de datos tradicional, con soporte para autocompletado y navegación por historial.
$ sndb sql
SonnetDB CLI v0.6.0
Conectado a sonnetdb://localhost:8839
Use 'exit' para salir o 'help' para ayuda
sndb> CREATE MEASUREMENT clima (estacion TAG, grados FIELD FLOAT);
OK
sndb> INSERT INTO clima (time, estacion, grados) VALUES (1713676800000, 'norte-01', 19.8);
OK (1 registro afectado)
sndb> SELECT time, estacion, grados FROM clima WHERE grados > 15;
time | estacion | grados
1713676800000 | norte-01 | 19.8
(1 fila)
sndb> exit
¡Adiós!
Ejecución de scripts automatizados
Para procesos de integración continua o inicialización de entornos, la herramienta permite procesar archivos de scripts SQL completos de manera no interactiva:
sndb execute --file esquema_inicial.sql
Esta capacidad facilita la integración de cambios en el esquema de la base de datos dentro de flujos de trabajo automatizados, asegurando la consistencia entre diferentes despliegues.