Referência de Comandos

Referência completa de todos os comandos da CLI dataspoc-lens e suas opções.

Opções globais

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

init

Inicializa a configuração do DataSpoc Lens.

dataspoc-lens init

Cria o diretório ~/.dataspoc-lens/ com config.yaml e subdiretório transforms/.

add-bucket

Registra um bucket e descobre tabelas.

dataspoc-lens add-bucket <uri>

Argumento	Descrição
uri	URI do bucket: s3://, gs://, az:// ou file://

Lê o manifest do Pipe ou escaneia por arquivos .parquet e exibe as tabelas descobertas.

catalog

Lista todas as tabelas dos buckets registrados.

dataspoc-lens catalog [OPTIONS]

Opção	Padrão	Descrição
--detail <table>	—	Mostra schema detalhado de uma tabela específica
--output <format>	table	Formato de saída: table ou json

Exemplos:

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

query

Executa uma consulta SQL e exibe os resultados.

dataspoc-lens query <sql> [OPTIONS]

Argumento / Opção	Padrão	Descrição
sql	—	Consulta SQL a executar
--export, -e	—	Exportar resultados para arquivo (formato pela extensão: .csv, .json, .parquet)
--output	table	Formato de saída: table ou json

Exemplos:

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

Abre o shell SQL interativo.

dataspoc-lens shell

Sem opções. Veja Shell Interativo para detalhes sobre dot commands e funcionalidades.

ask

Faz uma pergunta em linguagem natural e obtém resultados SQL.

dataspoc-lens ask <question> [OPTIONS]

Argumento / Opção	Padrão	Descrição
question	—	Pergunta em linguagem natural
--debug	false	Mostra o prompt enviado ao LLM
--export, -e	—	Exportar resultados para arquivo (.csv, .json, .parquet)
--output	table	Formato de saída: table ou json

Exemplos:

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 e configura o Ollama para IA local (gratuito, sem API key necessária).

dataspoc-lens setup-ai

notebook

Abre um notebook interativo com tabelas pré-montadas.

dataspoc-lens notebook [OPTIONS]

Opção	Padrão	Descrição
--marimo	false	Usar Marimo ao invés de JupyterLab

Exemplos:

dataspoc-lens notebook
dataspoc-lens notebook --marimo

transform run

Executa transformações SQL em ordem.

dataspoc-lens transform run

Executa todos os arquivos .sql numerados em ~/.dataspoc-lens/transforms/ na ordem. Veja Transformações SQL para detalhes.

transform list

Lista os arquivos de transformação disponíveis.

dataspoc-lens transform list

cache

Gerencia o cache local de dados Parquet remotos.

dataspoc-lens cache [TABLE] [OPTIONS]

Argumento / Opção	Padrão	Descrição
table	—	Nome da tabela para cachear
--list	false	Listar tabelas cacheadas
--refresh	false	Forçar re-download dos dados cacheados
--clear	false	Limpar dados cacheados (todos ou uma tabela específica)
--output	table	Formato de saída: table ou json

Exemplos:

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 o servidor MCP para integração com agentes de IA.

dataspoc-lens mcp

Veja MCP Server para detalhes de configuração.

ml activate

Ativa o DataSpoc ML com uma chave de licença.

dataspoc-lens ml activate [KEY]

Sem chave, exibe informações sobre o DataSpoc ML e como adquirir uma licença.

ml status

Mostra o status da licença do DataSpoc ML.

dataspoc-lens ml status

ml train

Treina um modelo via DataSpoc ML.

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

Opção	Descrição
--target	Nome da coluna alvo para predição
--from	Nome da tabela ou caminho para os dados de treino

ml predict

Gera predições via DataSpoc ML.

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

Opção	Descrição
--model	Nome do modelo a usar para predições
--from	Nome da tabela ou caminho para os dados de entrada

ml models

Lista os modelos ML treinados.

dataspoc-lens ml models

ml explain

Explica um modelo treinado via DataSpoc ML.

dataspoc-lens ml explain --model <name>

Opção	Descrição
--model	Nome do modelo a explicar