CLI Dattos: comandos e capacidades

CLI Dattos: comandos e capacidades

Este artigo é a referência dos comandos da CLI Dattos, organizados por área. Todos aceitam --help para a documentação completa de flags, e dattos status-glossary explica o significado de qualquer status retornado pela plataforma. Para instalação e autenticação, veja "CLI Dattos: instalação e primeiros passos".

Fluxos e execução (dattos etl)

O grupo central da CLI — cobre o ciclo de vida dos fluxos de preparação de dados e conciliação:

• Criar e construir com o Dattos AI: etl create --name <nome> cria a análise; etl add-source --etl <id> --file <arquivo> adiciona fontes (xlsx, csv, pdf, xml); etl pipeline create "<descrição em linguagem natural>" --etl <id> constrói o fluxo completo com inteligência artificial (aceita --rules <documento> com as regras de negócio). O atalho etl new faz tudo em uma chamada.

• Executar: etl start <id> --date <AAAA-MM-DD> dispara a execução para uma data de referência; --file sobe o arquivo antes, --wait acompanha até concluir, --incremental preserva os dados já carregados.

• Acompanhar e gerenciar: etl execution-status <id> --date <data>, etl list, etl get <id>, etl resolve <código> (traduz código para identificadores), etl datasources <id>, etl publish <id> (promove o rascunho a versão publicada) e etl activate/etl deactivate.

• Backup e restauração: etl download <id> baixa o blueprint .xdtt do fluxo; etl upload <id> --file <blueprint> restaura.

• Calendário: etl set-calendar troca o calendário de execução do fluxo.

• Construção avançada: para montar o fluxo etapa a etapa por programação, existem etl add-step, etl connect, etl configure-step, etl set-params, etl add-matching, etl components (catálogo e parâmetros de cada etapa), etl formulas (referência da Fórmula Dattos), etl sql-help, etl step-data (amostra da saída de uma etapa) e etl refresh-sample.

Consulta de resultados

• dattos loads: loads get <análise> <data> retorna o carregamento e seus conjuntos de dados; loads list-dates lista as datas de referência com dados; loads views lista as visões disponíveis.

• dattos datasets: datasets search <análise> <load> <dataset> consulta as linhas do resultado, com paginação e filtros em JSON.

• dattos matching: matching status traz os totais da conciliação (conciliados, pendentes), matching summary o resumo por coluna e matching get os registros. As regras ficam em matching rules (add, update, delete, active), o catálogo em matching configs list, os responsáveis em matching responsible list e o avanço no fluxo de aprovação em matching stage.

Exportação (dattos reports)

• reports generate <análise> --load-id <id> --dataset-id <id> --format csv|xlsx — geração assíncrona.

• reports status acompanha e reports download <análise> <reportId> --output <arquivo> baixa o resultado.

Gestão de Tarefas (dattos tasks)

Leitura e escrita completas sobre o módulo de tarefas:

• Listar e filtrar: tasks list combina filtros de pasta, responsável, etiqueta e prazo, com paginação.

• Detalhar: tasks get <id> traz o detalhe completo, incluindo contadores de comentários e anexos.

• Criar: tasks create aceita título, datas e recorrência — diária, semanal, mensal ou anual, com variações como "somente dias úteis", "3 dias úteis antes do fim do mês" ou "segunda semana do mês".

• Atualizar e mover: tasks update altera campos; a mudança de estágio é sempre por tasks move (nos dois sentidos).

• Registrar: tasks comment adiciona comentário e tasks attach anexa arquivo ou URL.

• Exportar: tasks report --output <arquivo.xlsx> baixa o relatório de tarefas.

Administração

• dattos users: listar, criar, atualizar, bloquear e excluir usuários; users set-roles define os perfis; users sessions e users kill-session tratam das sessões ativas.

• dattos roles: gestão dos perfis de privacidade — CRUD, escopo de pastas (roles folders) e níveis de aprovação de conciliação (roles approval-levels).

• dattos connectors: conectores de banco de dados — criar, testar (connectors test), ativar/desativar.

• dattos calendars: consulta dos calendários de execução.

• dattos batch: operações em massa — batch batch-start executa várias análises em sequência; batch batch-create --file <usuarios.json> cria usuários em lote.

• dattos folders: navegação, seleção do contexto de pasta e criação de pastas.

Utilitários

• dattos doctor [--deep] — diagnóstico de configuração, conectividade, autenticação, versão da instância e pasta ativa.

• dattos config profile list|switch — perfis para múltiplas instâncias/ambientes.

• dattos cache clear — limpa o cache local de consultas (TTL de 5 minutos; operações de escrita invalidam automaticamente).

• dattos mcp install <ferramenta> — configura o servidor MCP local nos assistentes de inteligência artificial. Para o caminho hospedado, que é o recomendado, veja o artigo de MCP.

• dattos version e dattos status-glossary.

Comportamento e limites

• Arquivos aceitos no upload: .csv, .edi, .ofx, .pdf, .rem, .ret, .txt, .xlsx, .xls, .xlsb, .xml.

• Exclusões pedem confirmação: comandos destrutivos (users delete, roles delete, connectors delete, matching rules delete, users kill-session) exigem a flag --yes.

• Limite de requisições: ao receber HTTP 429, a CLI reexecuta automaticamente até 3 vezes com espera progressiva (5s, 10s, 20s).

• Tempo limite: 30s nas chamadas comuns; 120s em upload e download; 10 minutos nos fluxos de inteligência artificial (streaming).

• Códigos de saída: 0 sucesso, 1 erro da API, 2 autenticação/configuração — os erros saem em JSON no stderr com next_step e correlation_id para suporte.

Artigos relacionados

• CLI Dattos: instalação e primeiros passos

• Conectar assistentes de inteligência artificial via MCP

• Introdução às integrações