Referencia de Comandos

Referencia completa de todos los comandos CLI de dataspoc-lens y sus opciones.

Opciones globales

dataspoc-lens --version    # Show version
dataspoc-lens --help       # Show help

init

Inicializa la configuracion de DataSpoc Lens.

dataspoc-lens init

Crea el directorio ~/.dataspoc-lens/ con config.yaml y el subdirectorio transforms/.

add-bucket

Registra un bucket y descubre tablas.

dataspoc-lens add-bucket <uri>

Argumento	Descripcion
uri	URI del bucket: s3://, gs://, az:// o file://

Lee el manifiesto de Pipe o escanea archivos .parquet e imprime las tablas descubiertas.

catalog

Lista todas las tablas de los buckets registrados.

dataspoc-lens catalog [OPTIONS]

Opcion	Por defecto	Descripcion
--detail <table>	—	Muestra el esquema detallado de una tabla especifica
--output <format>	table	Formato de salida: table o json

Ejemplos:

dataspoc-lens catalog
dataspoc-lens catalog --detail orders
dataspoc-lens catalog --output json

query

Ejecuta una consulta SQL e imprime los resultados.

dataspoc-lens query <sql> [OPTIONS]

Argumento / Opcion	Por defecto	Descripcion
sql	—	Consulta SQL a ejecutar
--export, -e	—	Exportar resultados a archivo (formato segun extension: .csv, .json, .parquet)
--output	table	Formato de salida: table o json

Ejemplos:

dataspoc-lens query "SELECT * FROM orders LIMIT 10"
dataspoc-lens query "SELECT * FROM orders" --export results.csv
dataspoc-lens query "SELECT COUNT(*) FROM orders" --output json

shell

Inicia el shell interactivo SQL.

dataspoc-lens shell

Sin opciones. Ve Shell Interactivo para detalles sobre comandos dot y funcionalidades.

ask

Haz una pregunta en lenguaje natural y obtiene resultados SQL.

dataspoc-lens ask <question> [OPTIONS]

Argumento / Opcion	Por defecto	Descripcion
question	—	Pregunta en lenguaje natural
--debug	false	Muestra el prompt enviado al LLM
--export, -e	—	Exportar resultados a archivo (.csv, .json, .parquet)
--output	table	Formato de salida: table o json

Ejemplos:

dataspoc-lens ask "What are the top 10 customers by revenue?"
dataspoc-lens ask "Monthly order trends" --debug
dataspoc-lens ask "Average order value by status" --export report.csv
dataspoc-lens ask "Total revenue" --output json

setup-ai

Instala y configura Ollama para IA local (gratuito, sin API key necesaria).

dataspoc-lens setup-ai

notebook

Abre un notebook interactivo con tablas pre-montadas.

dataspoc-lens notebook [OPTIONS]

Opcion	Por defecto	Descripcion
--marimo	false	Usar Marimo en lugar de JupyterLab

Ejemplos:

dataspoc-lens notebook
dataspoc-lens notebook --marimo

transform run

Ejecuta transformaciones SQL en orden.

dataspoc-lens transform run

Ejecuta todos los archivos .sql numerados en ~/.dataspoc-lens/transforms/ en orden. Ve Transformaciones SQL para detalles.

transform list

Lista los archivos de transformacion disponibles.

dataspoc-lens transform list

cache

Gestiona el cache local de datos Parquet remotos.

dataspoc-lens cache [TABLE] [OPTIONS]

Argumento / Opcion	Por defecto	Descripcion
table	—	Nombre de la tabla a cachear
--list	false	Listar tablas cacheadas
--refresh	false	Forzar re-descarga de datos cacheados
--clear	false	Limpiar datos cacheados (todos o una tabla especifica)
--output	table	Formato de salida: table o json

Ejemplos:

dataspoc-lens cache orders                # Cache the orders table
dataspoc-lens cache --list                # List all cached tables
dataspoc-lens cache --list --output json  # List cached tables as JSON
dataspoc-lens cache orders --refresh      # Force re-download
dataspoc-lens cache --clear               # Clear all cached data
dataspoc-lens cache orders --clear        # Clear specific table cache

mcp

Inicia el MCP server para integracion con agentes de IA.

dataspoc-lens mcp

Ve MCP Server para detalles de configuracion.

ml activate

Activa DataSpoc ML con una clave de licencia.

dataspoc-lens ml activate [KEY]

Sin clave, muestra informacion sobre DataSpoc ML y como adquirir una licencia.

ml status

Muestra el estado de la licencia de DataSpoc ML.

dataspoc-lens ml status

ml train

Entrena un modelo via DataSpoc ML.

dataspoc-lens ml train --target <column> --from <table>

Opcion	Descripcion
--target	Nombre de la columna objetivo para prediccion
--from	Nombre de la tabla o ruta a los datos de entrenamiento

ml predict

Genera predicciones via DataSpoc ML.

dataspoc-lens ml predict --model <name> --from <table>

Opcion	Descripcion
--model	Nombre del modelo a usar para predicciones
--from	Nombre de la tabla o ruta a los datos de entrada

ml models

Lista los modelos ML entrenados.

dataspoc-lens ml models

ml explain

Explica un modelo entrenado via DataSpoc ML.

dataspoc-lens ml explain --model <name>

Opcion	Descripcion
--model	Nombre del modelo a explicar