Aby poprawnie zaimportować dane z pliku CSV, użyj spójnego kodowania, właściwego separatora i nagłówków dopasowanych do pól docelowego systemu. Zadbaj o jednolity format dat i liczb, prawidłowe cytowanie pól oraz przetestuj import na próbce danych.
Podstawowe zasady formatowania CSV dla importu
- Kodowanie: ustaw UTF-8. W niektórych importerach można również użyć UTF-8 z BOM.
- Separator: wybierz przecinek lub średnik i stosuj go konsekwentnie w całym pliku.
- Nagłówek: pierwsza linia powinna zawierać nazwy kolumn dopasowane do pól docelowego systemu.
- Cytowanie pól: jeśli pole zawiera przecinek, nową linię lub cudzysłów, otaczamy je podwójnymi cudzysłowami; wewnątrz pola podwajasz cudzysłowy.
- Format dat: używaj ISO 8601 (YYYY-MM-DD) lub zapisz daty jako tekst w jednolitym formacie.
- Wieloliniowe pola: unikaj wielolinijkowych danych; jeśli to konieczne, użyj cytowania i unikaj bezpośredniego wstawiania nowych linii.
- Liczby: określ separator dziesiętny zgodny z importerem (często kropka); unikaj mieszanych formatów w jednym pliku.
- Nazwy kolumn: trzymaj się prostych identyfikatorów (bez spacji i specjalnych znaków); łącz nazwy podkreśleniami.
- Kolejność kolumn: dopasuj kolejność kolumn do wymagań systemu importu.
- Znaki końca wiersza: używaj CRLF lub LF zgodnie z wymaganiami importerów.
Zalecane praktyki i konkretne formatowanie
- Walidacja na etapie przygotowania: sprawdź liczbę kolumn, typy pól i zgodność wartości z oczekiwanymi typami.
- Testowa próbka: zanim załadujesz cały plik, przetestuj import na małej próbce (5–10 wierszy).
- Standaryzacja danych: usuń nadmiarowe spacje, normalizuj nazwy produktów i jednostki miar.
- Escaping w polach: w polach zawierających znaki specjalne stosuj podwójne cytowanie.
- Unikanie ukrytych formatów: daty, liczby i wartości boolean powinny być jawne, bez zależności od ustawień regionalnych.
- Mapowanie pól: przed importem upewnij się, że każdy kolumna odpowiada właściwemu polu w systemie docelowym.
Przykładowy fragment pliku CSV
- Przykładowe nagłówki: imie,nazwisko,data_urodzenia,kwota
- Przykładowy wiersz: Piotr,Nowak,,1234.56
Krótka checklista (szybki przegląd)
- Kodowanie: UTF-8
- Separator: wybrany i jednolity
- Nagłówek zgodny z wymaganiami importu
- Cytowanie pól tam, gdzie to konieczne
- Daty w formacie ISO 8601
- Brak wieloliniowych pól bez odpowiedniego cytowania
- Kolejność kolumn dopasowana do systemu
- Test importu na próbce i sprawdzenie logów
Często Zadawane Pytania
Jakie kodowanie pliku CSV jest najlepsze do importu?
Najlepiej UTF-8; jeśli importer wymaga, można użyć UTF-8 z BOM.
Którym separatorem się posługiwać w CSV do importu?
Użyj przecinka lub średnika i trzymaj się wybranego separatora w całym pliku.
Czy plik CSV potrzebuje nagłówka?
Zależy od systemu; jeśli importer wymaga mapowania pól, nagłówek jest konieczny.
Jak formatować daty w pliku CSV?
Stosuj format ISO 8601: YYYY-MM-DD, aby uniknąć niejednoznaczności.
Jak postępować z cudzysłowami w polach zawierających przecinek?
Pole wówczas otaczamy podwójnymi cudzysłowami, a wewnątrz podwajamy podwójne cudzysłowy.
Co zrobić, aby plik nie był źle interpretowany przez Excel?
Zapisuj jako CSV z UTF-8 i unikaj domyślnych formatowań; używaj spójnych formatów danych.
Jak zweryfikować poprawność pliku CSV przed importem?
Sprawdź liczbę kolumn, typy pól i zgodność wartości; przetestuj import na kopii danych.
Co zrobić, gdy import nie odzwierciedla wartości w kolumnach?
Sprawdź kolejność kolumn, nagłówki i sposób escapingu; upewnij się, że dane są prawidłowo zescapowane.