Walidator CSV

Walidator CSV

Wczytany plik:

Plik CSV, który bez problemu otwiera się w arkuszu kalkulacyjnym, może mimo to zawieść przy imporcie do bazy danych lub wysyłce do API. Ten walidator czyta plik tak, jak opisuje to RFC 4180, i wylicza każdy błąd struktury wraz z numerem wiersza: cudzysłowy, które nigdy się nie zamykają, wiersze z nieprawidłową liczbą kolumn, puste lub powtórzone nazwy nagłówków, znacznik kolejności bajtów na początku pliku oraz separatory pozostawione na końcu wiersza. Wklej tekst lub wybierz plik, wybierz separator (albo pozwól narzędziu go wykryć) i przeczytaj raport.

Jak sprawdzić plik CSV

  1. 1

    Wklej lub wgraj plik CSV

    Wklej tekst do pola albo wybierz plik .csv, .tsv lub .txt. Akceptowane są pliki do 1 000 000 znaków.

  2. 2

    Wybierz separator i wiersz nagłówka

    Zostaw automatyczne wykrywanie separatora albo wymuś przecinek, średnik, tabulator lub kreskę pionową. Wskaż, czy pierwszy wiersz zawiera nazwy kolumn.

  3. 3

    Przeczytaj raport

    Każdy problem jest wypisany z numerem wiersza i zrozumiałym opisem, oznaczony jako błąd lub ostrzeżenie. Skopiuj raport, aby go komuś przesłać.

  4. 4

    Popraw i sprawdź ponownie

    Popraw wiersze w swoim edytorze, zacznij od nowa i wklej plik jeszcze raz, aż raport pokaże, że nie znaleziono problemów.

Co sprawdza walidator

RFC 4180 jest tym, co w świecie CSV najbardziej przypomina standard. Określa, że rekordy oddziela się końcami wierszy, że pola zawierające separator, cudzysłów lub koniec wiersza trzeba ująć w cudzysłowy, a cudzysłów wewnątrz pola w cudzysłowie zapisuje się dwukrotnie (""). Walidator stosuje te zasady do Twojego tekstu, a następnie dodaje kilka kontroli, które mają znaczenie w praktyce.

Kontrole i sposób ich raportowania

Kontrola Waga Co ją wywołuje
Niezamknięty cudzysłów Błąd Pole w cudzysłowie się otwiera, a plik kończy się przed jego zamknięciem. Pokazany jest wiersz, w którym cudzysłów się otworzył.
Cudzysłów w polu bez cudzysłowu Błąd Znak " w środku pola, które nie zaczyna się od cudzysłowu, na przykład 5" pipe.
Tekst po zamykającym cudzysłowie Błąd Po zamykającym cudzysłowie występuje coś innego niż separator lub koniec wiersza, na przykład "abc"def.
Liczba kolumn Błąd Wiersz ma więcej lub mniej pól niż pierwszy wiersz.
Pusta nazwa nagłówka Błąd Nazwa kolumny w wierszu nagłówka jest pusta.
Powtórzona nazwa nagłówka Błąd Dwie kolumny mają tę samą nazwę po pominięciu spacji i wielkości liter (Name i name).
Znacznik kolejności bajtów Ostrzeżenie Plik zaczyna się niewidocznym znakiem U+FEFF.
Separator na końcu wiersza Ostrzeżenie Wiersz kończy się separatorem, więc ma jedną dodatkową pustą kolumnę.
Pusty wiersz Ostrzeżenie Pusty wiersz między rekordami.

Separatory

Tryb automatyczny analizuje pierwsze 25 niepustych wierszy i wybiera przecinek, średnik, tabulator lub kreskę pionową, który najczęściej dzieli je na tyle samo pól. Separatory wewnątrz pól w cudzysłowie są pomijane, więc "Kowalski, J" nie liczy się jako dwie kolumny. Jeśli dwóch kandydatów ma tyle samo trafień, wygrywa przecinek. Pliki rozdzielane średnikiem są powszechne tam, gdzie przecinek służy za znak dziesiętny (jak w Polsce), dlatego gdy plik miesza oba znaki, wybierz separator samodzielnie.

Numery wierszy

Numery wierszy liczą fizyczne wiersze w podanym tekście, zaczynając od 1. Pole w cudzysłowie zawierające znaki końca wiersza obejmuje kilka fizycznych wierszy, a problem w takim rekordzie jest zgłaszany w wierszu, od którego rekord się zaczyna.

Najczęstsze przyczyny błędów w CSV

  • Eksport z arkusza kalkulacyjnego, który dodaje BOM, a niektóre programy importujące traktują go jako część nazwy pierwszej kolumny.
  • Kolumna z dowolnym tekstem zawierającym przecinki lub cudzysłowy, której skrypt eksportujący nie ujął w cudzysłowy.
  • Łączenie plików o różnej liczbie kolumn.
  • Przecinek na końcu wiersza dodany przez skrypt, który po każdej wartości zapisuje separator.

Najczęściej zadawane pytania

Nie. Jeśli wiersz ma tyle samo pól co pierwszy wiersz, pusta ostatnia wartość to zwykłe dane. Walidator ostrzega przed separatorem na końcu tylko wtedy, gdy dodaje on jedno pole więcej, niż ma pierwszy wiersz, albo gdy sam wiersz nagłówka kończy się separatorem.

Gdy pole w cudzysłowie nigdy się nie zamyka, wszystko po nim jest czytane jako część tego pola, więc kolejnych wierszy nie da się rzetelnie porównać. Popraw cudzysłów w zgłoszonym wierszu i sprawdź plik ponownie, aby zobaczyć, co jest dalej.

Nie. Sprawdza strukturę pliku: cudzysłowy, separatory, liczbę kolumn, nazwy nagłówków, znacznik kolejności bajtów i puste wiersze. Nie weryfikuje, czy wartość jest poprawną liczbą, datą lub adresem e-mail, a tekst odczytuje jako UTF-8.

Nie. Wklejony tekst lub wybrany plik jest odczytywany i sprawdzany w Twojej przeglądarce. Nie trafia na nasze serwery ani do linku strony. Między krokami jest przechowywany tylko w karcie przeglądarki, a rozpoczęcie od nowa go usuwa. W linku widać wyłącznie wybrany separator i ustawienie nagłówka.

Powiązane narzędzia

Narzędzie jest dostępne w innych językach