ViewCSVAbra ou cole um arquivo CSV e o TSV aparece na prévia; Baixar TSV salva o resultado como arquivo .tsv. Em TSV, vírgulas dentro dos valores não precisam de aspas, então a maioria das linhas sai como texto simples separado por tabulação. A única decisão de verdade é o que fazer com tabulações e quebras de linha dentro de um valor: colocar entre aspas para o Excel e o pandas, escapar com barra invertida para o PostgreSQL ou trocar por espaço para leitores de TSV estrito. A conversão acontece no seu navegador, e o arquivo nunca é enviado.
Como converter CSV em TSV
- Abra um arquivo
.csv,.tsvou.txt, arraste-o para a ferramenta ou cole as linhas. O delimitador é detectado sozinho; se precisar, ajuste-o, ou escolha uma codificação antiga como Windows-1252, em Configurações de importação. - Em Tabulações e quebras de linha nos valores, escolha o estilo que o programa que vai ler o TSV espera. Depois defina as Quebras de linha e a opção Incluir a linha de cabeçalho.
- Escolha a Codificação de saída e clique em Baixar TSV, ou use Copiar para levar o texto.
Para converter vários arquivos CSV com as mesmas configurações, escolha Lote: converter vários arquivos. Cada arquivo é lido com detecção automática do delimitador e com linha de cabeçalho, e os resultados são baixados juntos em um único ZIP.
Opções de tabulação, quebras de linha e codificação
| Colocar o valor entre aspas (Excel, pandas) | É o padrão. Um valor com tabulação, quebra de linha, aspas duplas ou espaço no início ou no fim fica entre aspas duplas, com as aspas internas duplicadas: as mesmas regras do CSV, só que com a tabulação como delimitador. O resto é gravado sem aspas. |
|---|---|
| Escapes com barra invertida \t \n (PostgreSQL) | Nunca usa aspas. A tabulação vira \t, o avanço de linha \n, o retorno de carro \r e a barra invertida \\, de modo que cada registro fica em uma única linha. É o formato de texto que o COPY do PostgreSQL lê; aspas duplas são gravadas como caracteres comuns. |
| Trocar por espaços (TSV estrito) | Cada tabulação, quebra de linha ou par CRLF dentro de um valor vira um espaço, e o arquivo cumpre a regra da IANA de que os campos não contêm tabulações. Barras invertidas e aspas ficam como estão. Isso altera os dados, e a ferramenta informa quantos valores foram afetados. |
| Quebras de linha | Windows (CRLF) (padrão) ou LF (Unix e macOS) depois de cada registro, inclusive o último. |
| Incluir a linha de cabeçalho | Desative para gravar só as linhas de dados, por exemplo ao acrescentar dados a uma tabela que já existe. |
| Proteger contra fórmulas de planilha | Vem ativada. Valores que começam com =, +, -, @, tabulação ou retorno de carro recebem um ' na frente, para que a planilha os mostre como texto. Números simples, como -12.5, não mudam. Desative quando o TSV for para um banco de dados ou script e precisar guardar os valores exatamente como são. |
| Codificação de saída | UTF-8, UTF-8 com BOM (para o Excel), UTF-16 LE (com marca de ordem de byte) ou Windows-1252. Com Windows-1252, a conversão para com uma mensagem que aponta o caractere que essa codificação não consegue guardar. |
Vírgulas, células com várias linhas e IDs no TSV
- Vírgulas entre aspas no CSV não exigem nada em TSV:
"Desk lamp, brass"viraDesk lamp, brass. - Uma célula com várias linhas continua sendo um único valor. Com aspas, ela ocupa várias linhas dentro das aspas; com escapes, é gravada como
Ships in 2 boxes\nfragileem uma linha só. - Zeros à esquerda e IDs longos são gravados exatamente como estão: TSV não tem tipos, então
00731continua00731. - Com escapes, um caminho do Windows como
C:\tempé gravado comoC:\\temp, e um leitor que decodifica escapes recupera o original. - Uma linha com mais valores do que o cabeçalho ganha colunas extras chamadas
Column 4,Column 5…; uma linha mais curta é completada com valores vazios. Cabeçalhos em branco viramColumn 3e repetidos viramname (2).
Quando o TSV é importado errado
- As linhas se partem no meio ao importar. O leitor não entende quebras de linha entre aspas. Escolha Escapes com barra invertida \t \n (PostgreSQL) se ele decodificar escapes, ou Trocar por espaços (TSV estrito) se não decodificar.
- Os valores começam com apóstrofo. É a opção Proteger contra fórmulas de planilha em ação. Desative-a para importar em banco de dados ou script.
- A planilha mostra códigos com barra invertida. Uma célula exibe
\nou\tporque planilhas não decodificam escapes com barra invertida. Use Colocar o valor entre aspas (Excel, pandas) em arquivos que vão para o Excel ou o LibreOffice. - Ficou tudo em uma coluna só. O delimitador de entrada foi detectado errado; defina-o em Configurações de importação e abra o arquivo de novo.
Limites e arquivos grandes
Arquivos de até 25 MB, 100.000 linhas, 250 colunas e 2 milhões de células abrem com prévia ao vivo. Arquivos maiores são convertidos em modo de streaming: o arquivo é lido duas vezes, em partes, uma para achar o registro mais largo e outra para gravar, e o download cobre todas as linhas com a mesma saída que a prévia mostraria. Copiar não fica disponível nesses casos, e cada arquivo de saída tem limite de 4 GB.
No modo de streaming, a decodificação é automática (UTF-8, ou UTF-16 quando o arquivo começa com marca de ordem de byte) e a primeira linha é tratada como cabeçalho.
A conversão roda em um worker em segundo plano nesta aba; Cancelar interrompe o processo. Para trocar o delimitador mantendo as aspas do CSV, use Alterar delimitador e codificação do CSV; para ter uma tabela que você cola na documentação, use CSV para Markdown.
Exemplo: uma lista de pedidos em TSV
Uma lista de pedidos com uma vírgula entre aspas, uma observação em duas linhas e um valor que parece fórmula, convertida com o padrão (Colocar o valor entre aspas (Excel, pandas), proteção contra fórmulas ativada; exibida com quebras de linha LF). Com Escapes com barra invertida \t \n (PostgreSQL), a observação vira Ships in 2 boxes\nfragile em uma linha só e o valor de fórmula é gravado sem aspas.
id,product,note
00731,"Desk lamp, brass","Ships in 2 boxes
fragile"
00732,Cable tidy,"=HYPERLINK(""x"")"id product note
00731 Desk lamp, brass "Ships in 2 boxes
fragile"
00732 Cable tidy "'=HYPERLINK(""x"")"Perguntas frequentes
Qual é a diferença entre CSV e TSV?
Só o delimitador e as convenções que vêm com ele. O TSV separa os campos com tabulação, então vírgulas nos valores dispensam aspas. A definição da IANA proíbe tabulações dentro dos campos, e é por isso que cada ferramenta grava esses casos de um jeito.
Qual opção escolher para o COPY do PostgreSQL?
Escapes com barra invertida \t \n (PostgreSQL), com a proteção contra fórmulas desativada. O formato de texto do PostgreSQL usa tabulação como delimitador padrão e decodifica \t, \n, \r e \\. Um valor vazio é carregado como string vazia, porque o marcador de NULL padrão desse formato é \N; acrescente NULL '' às opções do COPY para carregar valores vazios como NULL.
Dá para converter TSV de volta em CSV?
Sim: abra o TSV em Alterar delimitador e codificação do CSV. O delimitador de tabulação é detectado, e você pode escolher vírgula ou ponto e vírgula na saída. Escapes com barra invertida são lidos como caracteres comuns, sem decodificação.