MagnusBilling
Operations

Importar CSV no MagnusBilling: converter quebras de linha UNIX para DOS

Corrija importações CSV que informam sucesso, mas não carregam registros, identificando e convertendo quebras de linha incompatíveis.

ENPTES

Quando o MagnusBilling informa sucesso na importação CSV, mas nenhum registro aparece, as quebras de linha do arquivo podem não corresponder ao formato esperado pelo importador. Windows, Linux e macOS clássico usam historicamente caracteres diferentes.

Imagem original do guia de conversão CSV de Unix para DOS.
Imagem original do guia de conversão CSV de Unix para DOS.

Formatos de quebra de linha

OrigemQuebra de linhaNotação visível
WindowsRetorno de carro + avanço de linha\r\n
Linux / UnixAvanço de linha\n
macOS clássicoRetorno de carro\r

Por que a importação pode falhar

O importador legado usa LOAD DATA LOCAL INFILE do MySQL, cuja opção LINES TERMINATED BY é configurada para um separador. Se o CSV usa outro separador, o importador pode interpretar todo o arquivo como uma única linha.

Detecte o formato atual

Trabalhe em uma cópia. O comando file normalmente identifica terminadores CRLF; os outros comandos tornam retornos de carro visíveis.

file FILE.csv
cat -v FILE.csv | head
hexdump -C FILE.csv | head

Converta uma cópia para CRLF do Windows

Instale dos2unix, preserve o arquivo original e execute unix2dos na cópia que será importada.

apt update
apt install dos2unix -y
cp FILE.csv FILE.original.csv
unix2dos FILE.csv
file FILE.csv

Valide antes de importar

  • Mantenha exatamente os cabeçalhos exigidos pela tela de importação selecionada no MagnusBilling.
  • Use o delimitador esperado e coloque entre aspas os campos que contêm esse delimitador.
  • Salve o texto em UTF-8, a menos que a versão instalada documente outra codificação.
  • Confira se todas as linhas possuem a mesma quantidade de colunas.
  • Teste com um arquivo pequeno antes de importar dados de produção.

Não confunda com a importação de DIDs

Este artigo corrige quebras de linha para qualquer importação CSV afetada. O guia de DIDs documenta as colunas Number, Setup price e Monthly price da tela de importação de DIDs.

Abrir o guia de importação de DIDs por CSV

Artigo original

Ler o artigo original arquivado