Sprawdź poprawność pliku CSV

Jak sprawdzić poprawność pliku CSV

1. Otwórz plik .csv, .tsv lub .txt. Ogranicznik i znacznik BOM dla UTF-8 lub UTF-16 są wykrywane automatycznie; jeśli kolumny wyglądają nieprawidłowo, wybierz inny ogranicznik lub starsze kodowanie w ustawieniach importu.
2. Opcjonalnie podaj liczbę kolumn, którą musi mieć każdy rekord. Jeśli zostawisz pole puste, użyta zostanie liczba kolumn nagłówka.
3. Opcjonalnie dodaj reguły dla interesujących Cię kolumn: typ, to, czy wartość jest wymagana lub musi być unikatowa, dozwolone wartości, minimum i maksimum, zakres długości albo wzorzec.
4. Uruchom sprawdzanie i przejrzyj raport: najpierw błędy, potem ostrzeżenia. Popraw wartości w edytorze CSV lub uporządkuj je w narzędziu Czyszczenie danych CSV, a potem sprawdź plik ponownie.

Aby przed napisaniem reguł zobaczyć typy, puste komórki i różne wartości każdej kolumny, sprawdź plik w profilu kolumn.

Kontrole struktury każdego rekordu

Wartość w cudzysłowie, który nigdy się nie zamyka, przerywa sprawdzanie błędem wskazującym rekord, w którym się zaczyna, bo reszty pliku nie da się wtedy wiarygodnie podzielić na rekordy.

Reguły kolumn: typy, wymagane, unikatowe i wzorce

Reguła dotyczy kolumny, której nagłówek dokładnie odpowiada nazwie w regule; reguły dla kolumn, których nie ma w pliku, są pomijane. Reguły możesz zapisać jako plik JSON w formacie Table Schema i wczytać ponownie przy kolejnym eksporcie; nieznane typy i klucze we wczytanym schemacie są ignorowane.

Jak czytać raport

• Numery wierszy oznaczają rekordy danych po nagłówku (nagłówek to wiersz 0). Wartość z podziałem wiersza w cudzysłowie nadal stanowi jeden rekord, więc numer wiersza może się różnić od numeru linii w edytorze tekstu.
• Każdy problem podaje kolumnę i przytacza wartość, dzięki czemu wyszukasz ją w przeglądarce CSV lub w edytorze.
• Błędy naruszają strukturę lub regułę; ostrzeżenia wskazują dane, które są poprawnym CSV, ale często powodują problemy przy imporcie.
• Wyświetlanych jest do 5000 problemów. Powyżej tej liczby sumy dla każdego rodzaju problemu są nadal liczone, a lista jest oznaczona jako obcięta.

Limity walidacji i prywatność

Walidator odczytuje po jednym rekordzie, więc pliki większe niż 25 MB (limit pracy interaktywnej) są sprawdzane strumieniowo w tle, z paskiem postępu i możliwością anulowania. W trybie strumieniowym rekordy z mniejszą liczbą pól niż nagłówek są obecnie uzupełniane przed sprawdzeniem, więc jako błąd liczby pól zgłaszane są tylko rekordy z nadmiarowymi polami.

Walidacja odbywa się w Twojej przeglądarce. Plik CSV nie jest wysyłany na żaden serwer.

Przykład: sprawdzanie eksportu rejestracji czterema regułami

Eksport rejestracji sprawdzony czterema regułami: id to wymagana, unikatowa liczba całkowita; email to wymagany tekst w formacie e-mail; signup_date to data; plan dopuszcza basic, pro i team. Wynik to raport walidatora – po podsumowaniu jeden problem w każdym wierszu: niemożliwa data, adres e-mail bez końcówki domeny, Pro z niewłaściwą wielkością liter, powtórzony id, brakujący e-mail oraz team ze spacją na końcu, co jest jednocześnie ostrzeżeniem i niedozwoloną wartością.

id,email,signup_date,plan
1,ana@example.com,2024-02-30,pro
2,kim@example,2024-03-01,Pro
2,bao@example.com,2024-03-04,basic
4,,2024-03-05,team 

{"rows":4,"errors":6,"warnings":1,"truncated":false}
{"code":"type","row":1,"column":"signup_date","value":"2024-02-30","params":{"type":"date"}}
{"code":"format","row":2,"column":"email","value":"kim@example","params":{"format":"email"}}
{"code":"enum","row":2,"column":"plan","value":"Pro","params":{"allowed":"basic, pro, team"}}
{"code":"unique","row":3,"column":"id","value":"2","params":{"first":2}}
{"code":"whitespace","row":4,"column":"plan","value":"team ","params":{}}
{"code":"required","row":4,"column":"email","value":"","params":{}}
{"code":"enum","row":4,"column":"plan","value":"team ","params":{"allowed":"basic, pro, team"}}