Exportação de dados históricos

A exportação do histórico gera arquivos em segundo plano, sendo adequada para preservar dados brutos detalhados ou analisá-los em outras ferramentas, sem manter o navegador aguardando o fim da consulta.

Etapas de exportação

1. Selecione os pontos e o período; para pontos compartilhados, informe o dispositivo de origem.
2. Consulte a estimativa de espaço em disco e crie a tarefa de exportação.
3. Na lista de tarefas, acompanhe os estados em fila, em execução, concluído ou falhou; cancele se não precisar mais da tarefa.
4. Após a conclusão, obtenha uma credencial temporária de download e baixe o arquivo CSV ou ZIP.

As tarefas estão sujeitas a limites de intervalo de tempo, tamanho de arquivo, concorrência e espaço livre em disco. Se não houver espaço suficiente, a exportação será recusada ou interrompida; os limites específicos dependem da configuração do dispositivo.

Arquivos e dados

• Oferece suporte a valores históricos de aquisição, agregação e compartilhamento; não selecione repetidamente o mesmo ponto do mesmo dispositivo.
• O CSV preserva os marcadores de valor nulo, distinguindo “sem dados” de uma string vazia.
• As credenciais de download têm prazo de validade; obtenha uma nova após a expiração e não as compartilhe publicamente.
• A exportação contém os dados ainda retidos dentro do escopo especificado; históricos já removidos pela política de retenção não podem ser recuperados.

Interfaces de integração

Operação	Interface
Estimar capacidade	GET /ems-data/export/disk-space
Criar tarefa / consultar lista de tarefas	POST /ems-data/export/tasks / GET /ems-data/export/tasks
Consultar / cancelar uma tarefa	GET /ems-data/export/tasks/:taskId / DELETE /ems-data/export/tasks/:taskId
Obter credencial de download	POST /ems-data/export/tasks/:taskId/download-ticket

Ao criar a tarefa, informe format (CSV ou CSV_ZIP), dataKeys, startTime e endTime. O download só fica disponível após o sucesso da tarefa; a aceitação da solicitação não significa que o arquivo já foi gerado.

Para análise pontual, use Consulta ao histórico; para preservação contínua, Arquivamento periódico; para migrar configurações, Backup e restauração. Consulte o uso pelo Agent na Skill de exportação.