Visualizador CSV

Esta página é o guia canónico para pré-visualizar CSV com o CSV Viewer da DevUtilities. Abra um ficheiro acima e use as secções sobre delimitador/cabeçalhos, ordenação, limites de ficheiros grandes, codificação e transferência para JSON/CSV. A análise fica no browser.

CSV Viewer é uma pré-visualização de tabela no cliente para valores separados por vírgulas. Trata a primeira linha como cabeçalhos, mostra uma grelha ordenável e mantém o texto completo em memória para inspecionar exportações antes de ETL, conversão JSON ou anexo.

O que obtém

• Seletor / arrastar e largar via FileReader (texto)
• Análise estilo RFC 4180: vírgulas, campos entre aspas, aspas escapadas
• Primeira linha como cabeçalhos de coluna
• Ordenação ao clicar (localeCompare, asc/desc)
• Contagens de linhas e colunas na interface
• Apenas local — o conteúdo não é carregado

Use este visualizador quando

• Vista rápida de uma exportação sem abrir o Excel
• Verificar cabeçalhos e forma das linhas antes de transforms JSON/CSV
• Confirmar que aspas e vírgulas sobreviveram à exportação
• Manter-se offline com CSV de clientes ou salários

Como esta ferramenta ajuda

1. Abra um .csv do disco.
2. Confirme que os nomes do cabeçalho coincidem com o schema do produtor.
3. Verifique a contagem de linhas face ao tamanho esperado.
4. Clique num cabeçalho para ordenar; clique de novo para inverter.
5. Procure linhas irregulares ou valores que pareçam fundidos.
6. Se caracteres parecerem errados (é, ’), corrija a codificação na origem e recarregue.
7. Para transforms, copie o CSV para JSON ↔ CSV, Dev Toolkit Columns → JSON ou o seu ETL.

O analisador é delimitado por vírgulas. A primeira linha lógica não vazia torna-se cabeçalhos; cada linha seguinte é de dados alinhada por índice de coluna.

O que é detetado

• Vírgula (,) como separador de campos
• Campos entre aspas duplas que podem conter vírgulas e novas linhas
• Aspas escapadas como aspas duplicadas ("")
• Terminadores de linha CRLF e LF

O que não é detetado automaticamente

• Delimitadores ponto e vírgula (;) ou tab (\t) comuns em Excel UE
• Interruptor «tem cabeçalho» — a linha 0 é sempre cabeçalho
• Inferência de tipos (números/datas permanecem strings)

Dica prática

Dica prática

A ordenação é lexicográfica via localeCompare em cadeias. Ideal para categorias e IDs, não para magnitude numérica.

• Clique no cabeçalho para ascendente; clique de novo para descendente
• Colunas numéricas ordenam como texto («10» antes de «2»)
• Células vazias como strings vazias; linhas irregulares podem deslocar valores
• O estado de ordenação reinicia ao carregar um ficheiro novo
• Use a linha linhas × colunas para validar a exportação

Um fornecedor enviou overnight.csv. Antes de o carregar no job do warehouse, confirme cabeçalhos, contagem de linhas e que vírgulas entre aspas não partiram campos.

Como esta ferramenta ajuda

1. Abra o ficheiro e leia o cabeçalho face ao schema do contrato.
2. Compare a contagem mostrada com o manifesto do fornecedor.
3. Ordene uma coluna-chave (order_id, email) e detete vazios ou duplicados.
4. Abra células suspeitas — campos de morada entre aspas devem ficar numa coluna.
5. Rejeite ou peça de novo o ficheiro se a forma estiver errada antes do ETL.

Resultado: deteta o problema na pré-visualização, não após uma falha no pipeline.

Precisa de objetos para um mock de API ou schema de ferramenta LLM, mas a fonte de verdade continua a ser um CSV.

Como esta ferramenta ajuda

1. Pré-visualize no CSV Viewer para confirmar cabeçalhos limpos (sem nomes em branco nem títulos duplicados).
2. Copie o CSV para Dev Toolkit → Columns → JSON para um array de objetos, ou use JSON ↔ CSV para ida e volta.
3. Valide um objeto de amostra no JSON Formatter antes de ligar mocks.
4. Mantenha o CSV como artefacto de auditoria; faça commit só de amostras saneadas.

Resultado: deteta o problema na pré-visualização, não após uma falha no pipeline.

Nomes aparecem como José ou aspas tipográficas como ’. As partes interessadas pensam que os dados estão corruptos.

Como esta ferramenta ajuda

1. Carregue o ficheiro — FileReader usa a descodificação de texto do browser (tipicamente UTF-8).
2. Se aparecer mojibake, o ficheiro é provavelmente Windows-1252/Latin-1 mal etiquetado como UTF-8 (ou o inverso).
3. Reexporte do Excel/Sheets como CSV UTF-8, ou converta com uma ferramenta de codificação.
4. Recarregue e confirme diacríticos e símbolos de moeda.

Resultado: deteta o problema na pré-visualização, não após uma falha no pipeline.

O ficheiro inteiro é guardado como string e analisado numa tabela em memória. O teto é a memória do separador — não um motor de streaming.

• CSV de centenas de MB podem congelar ou crashar o separador — divida ou pré-visualize uma amostra
• Ordenar copia o array de linhas; tabelas largas + altas amplificam a memória
• Não há scroll virtualizado para milhões de linhas — use base de dados ou CLI (csvkit, DuckDB)
• Para verificações pontuais, exporte as primeiras 1–5k linhas

Sintomas: algumas linhas mostram menos células, valores sob o cabeçalho errado, ou um campo com vírgulas parte-se em colunas extra.

Por que acontece

Vírgulas sem aspas dentro de campos, aspas desalinhadas ou linhas truncadas a meio da exportação quebram o alinhamento. Ficheiros com ponto e vírgula analisados como vírgulas colapsam numa coluna.

Diagnóstico

Encontre a primeira linha má. Verifique se moradas/nomes têm vírgulas sem aspas. Confirme que o ficheiro usa vírgulas, não ponto e vírgula.

Correções

1. Reexporte com aspas corretas (Excel: CSV UTF-8; bases de dados: FORCE QUOTE).
2. Converta ponto e vírgula/TSV para separado por vírgulas antes de abrir.
3. Corrija aspas desequilibradas na linha problemática.
4. Recarregue e verifique que a contagem de colunas coincide com o comprimento do cabeçalho.

Sintomas: acentos, símbolos ou texto CJK aparecem como lixo latino (Ã, Â, â€).

Por que acontece

Os bytes foram descodificados com o conjunto de caracteres errado. Este visualizador lê ficheiros como texto via browser (expectativa UTF-8 para CSV moderno).

Diagnóstico

Abra o mesmo ficheiro num editor que mostre a codificação. Se parecer correto como Windows-1252 mas errado aqui, converta para UTF-8.

Correções

1. Guarde de novo como CSV UTF-8 da folha ou ferramenta BI.
2. Converta com iconv ou um conversor de codificação, depois recarregue.
3. Garanta que os produtores declaram UTF-8 nos pipelines (especialmente ERP legado).

Corrija a codificação na origem — ordenar e a transferência JSON só propagarão a corrupção.

Exportações CSV costumam conter PII, folhas de pagamento ou listas de clientes.

• Prefira pré-visualização local a sites «CSV online» desconhecidos
• Remova ou faça hash de emails/IDs antes de partilhar capturas
• Não faça commit de CSV de produção em repos públicos
• Cuidado com injeção de fórmulas (=, +, -) ao colar depois em folhas