7.2.1. Importowanie plików w formacie CSV

Import pliku w formacie CSV polega na odczytaniu go przez program Kexi, utworzeniu odpowiedniej tabeli i załadowaniu do niej danych z tego pliku. Najczęściej te czynności są wykonywane automatycznie za pomocą funkcji importu danych z plików CSV.

Aby dokonać importu należy (niektóre z tych kroków możesz pominąć):

1. Wykonaj polecenie: Plik -> Importuj -> Tabelę danych.... Pojawi się okno umożliwiające wybór pliku w formacie CSV do załadowania.
   
   Otwieranie pliku z danymi CSV
   
   Znajdź plik, z którego chcesz zaimportować dane. Domyślnie na liście pojawiają się pliki z rozszerzeniem .csv. Jeśli Twój plik ma inne rozszerzenie, możesz użyć rozwijanej listy u dołu okna by pokazywane zmienić typy plików jakie mają się pojawiać w oknie, (np. na .txt lub na * aby widzieć wszystkie pliki). Upewnij się, że wybrany plik jest rzeczywiście plikiem CSV, np. otwierając go w edytorze tekstu.

2. Kliknij przycisk Otwórz. Pojawi się okno Importowanie pliku z danymi CSV.
   
   Okno importu danych CSV
   
   W oknie importu znajdują się następujące elementy (patrząc od góry do dołu):

   • U góry informacja o tym, skąd pochodzą importowane dane (na powyższym obrazku - z pliku osoby.csv).
   • Ustawienia importu umożliwiające wybór znaku rozdzielającego, formatu kolumn, cudzysłowu dla tekstu itd.
   • Podgląd danych w formie tabeli podzielonej na ponumerowane wiersze i nazwane kolumny. Dla uproszczenia i przyśpieszenia działania programu, pokazywane jest tutaj pierwsze 100 wierszy wczytanych z pliku. Zaimportowane zostaną oczywiście wszystkie wiersze.
   Program Kexi dokonał automatycznego rozpoznania znaku rozdzielającego, formatu kolumn, cudzysłowu dla tekstu i innych parametrów importu. Możesz jednak chcieć skorygować te parametry. W przeciwnym przypadku od razu przejdź do punktu 10.

3. Jeśli to konieczne, zmień ustawienie parametr Znak rozdzielający używając listy rozwijanej (program Kexi dokonał automatycznego rozpoznania tego znaku na podstawie zawartości pliku CSV). Do dyspozycji masz następujące wartości:

   • Przecinek ","
   • Średnik ";"
   • Tabulator
   • Spacja " "
   • Inny

   Jeśli wybrałeś wartość Inny, uaktywni się pole pod listą rozwijaną. Wpisz tam żądany znak rozdzielający. Po dokonaniu zmiany znaku rozdzielającego podgląd tabeli danych uaktualni się automatycznie.

4. Jeśli to konieczne, ustaw parametr Cudzysłów dla tekstu. Do wyboru masz cudzysłów podwójny (") lub pojedynczy ('). Możesz też wybrać wartość Brak. Najczęściej domyślna wartość w postaci podwójnego cudzysłowu jest wystarczająca. Po dokonaniu zmiany ustawień cudzysłowu dla tekstu podgląd tabeli danych uaktualni się automatycznie.

5. Podgląd danych powinien już pokazywać sensowne dane. Możesz teraz zaznaczyć lub odznaczyć parametr Pierwszy wiersz zawiera nazwy kolumn. Kexi dokonuje analizy pierwszego wiersza danych CSV w celu automatycznego ustawienia tego parametru. Po dokonaniu zmiany ustawień cudzysłowu dla tekstu podgląd tabeli danych uaktualni się automatycznie.

   Kiedy parametr Pierwszy wiersz zawiera nazwy kolumn nie jest zaznaczony, kolumny przybierają nazwy postaci "Kolumna 1", "Kolumna 2", itd. Możesz zmienić te nazwy. Aby tego dokonać, w podglądzie danych kliknij w pierwszym wierszu wybranej kolumny, po czym wpisz żądaną nazwę. Postępuj tak dla każdej kolumny, której nazwę chcesz zmienić. Możesz używać polskich liter, odstępów, itp.

6. Ustal od którego wiersza chcesz importować dane. Zazwyczaj importuje się całośc danych, jednak możesz opuścić pewną liczbę wierszy podając w polu Od wiersza numer pierwszego wiersza do wczytania. Jest tam też informacja o tym, jaka maksymalna liczba wierszy może być zaimportowana, np. (1-10). Po dokonaniu zmiany tego parametru podgląd tabeli danych uaktualni się automatycznie.

7. Układ kolumn tabeli już się nie zmieni, więc możesz ustalić typ każdej z nich. Typ ten będzie uwzględniony przy tworzeniu tabeli w Twoim projekcie bazy danych, przed zaimportowaniem danych CSV, np. jeśli dana kolumna z założenia ma przechowywać liczby, ustal jej typ jako Liczba.

   Aby zmienić typ kliknij w dowolną komórkę wybranej kolumny w podglądzie danych, po czym wybierz odpowiedni typ z listy rozwijanej Format kolumny. Dostępne typy kolumn to:

   • Tekst
   • Liczba
   • Data - w postaci rok-miesiąc-dzień
   • Czas - w postaci godziny:minuty:sekundy (sekundy są nieobowiązkowe)
   • Data/Czas - data z czasem

   Uwaga: wybranie niewłaściwego typu, np. liczbowego gdy wartości w kolumnie są tekstem może spowodować, że w tej kolumnie zostaną zaimportowane puste wartości.

8. Jeśli to konieczne, ustal kolumnę do której chcesz przypisać klucz podstawowy. Klucz podstawowy jest ważny, gdyż umożliwia poprawną pracę z zaimportowaną tabelą w bazie danych. Niektóre typy baz danych (jak MySQL) obecnie nie umożliwiają dokonywania zmian i usuwania wierszy tabeli jeśli do jednej z kolumn nie przypisano klucza podstawowego.

   Aby przypisać klucz podstawowy do wybranej kolumny, kliknij dowolną należącą do niej komórkę w podglądzie danych, po czym zaznacz pole Klucz podstawowy. Na podglądzie danych, w miejscu gdzie znajduje się nazwa kolumny pojawi się ikona kluczyka .

   Uwagi
   • Pole Klucz podstawowy jest dostępne jedynie dla kolumn o typie danych Liczba.
   • Tylko jedna kolumna w importowanej tabeli może mieć przypisany klucz podstawowy. Jeśli przypiszesz go nowej kolumnie, poprzednie przypisanie zostanie usunięte.

9. Ustaw inne parametry importu, jeśli to konieczne:

   • Zaznacz pole Ignoruj powtórzone znaki rozdz., jeśli w importowanym pliku zdarzają się powtórzone znaki rozdzielające.
   • Aby zobaczyć pozostałe opcje importu, kliknij przycisk Opcje na dole okna. Pojawi się dodatkowe okno Opcje importu CSV.
     
     Okno z dodatkowymi opcjami importu danych CSV
     
     Możesz tu wybrać kodowanie tekstu w jakim są zapisane dane pliku CSV. Domyślne kodowanie jest zależne od Twojego systemu operacyjnego i Twojej lokalizacji: dla systemów Linux lub Unix jest to zwykle Unicode lub ISO, dla MS Windows jest to cp (Code Page) odpowiedni dla lokalizacji w tym systemie.

     Zmień kodowanie tekstu na liście Kodowanie tekstu tylko jeśli jest to niezbędne. Jeśli w przyszłości chcesz zawsze korzystać z nowego ustawienia dotyczącego kodowania tekstu, zaznacz opcję Zawsze używaj tego kodowania przy importowaniu plików z danymi CSV. Kliknij przycisk OK, aby zatwierdzić zmiany dokonane w oknie Opcje importu CSV lub Anuluj, aby je porzucić.

10. Kliknij przycisk Importuj... aby rozpocząć importowanie danych z pliku CSV lub przycisk Anuluj, aby zrezygnować z importowania. Po kliknięciu Importuj... pojawi się okno z pytaniem o tytuł i nazwę tabeli, do której będą zapisane dane CSV.
    
    Wybór tytułu i nazwy tabeli do zapisania danych CSV
    
    Podana nazwa jest domyślnie ustalana na podstawie nazwy pliku z danymi CSV. Nie może to być nazwa istniejącej tabeli. W polu Tytuł możesz wpisywać dowolne znaki, łącznie ze spacjami. Pole Nazwa zostaje automatycznie uzupełnione przy wpisywaniu tytułu (możesz zmienić nazwę jeśli jest taka potrzeba).

11. Kliknij przycisk OK, aby rozpocząć właściwe importowanie danych. Zależnie od ilości danych, może to trwać mgnienie oka lub wiele minut. W drugim przypadku na ekranie pojawi się okno z paskiem postępu i przyciskiem Anuluj, który możesz kliknąć aby zrezygnować z importowania. Częściowo zaimportowane dane zostaną wtedy usunięte, a tabela nie zostanie utworzona.

    Po pomyślnym zaimportowaniu danych pojawi się komunikat to oznajmiający. Tabelę zawierającą zaimportowane dane znajdziesz w Nawigatorze projektu. Po jej otwarciu powinieneś zobaczyć dane podobne do widocznych wcześniej na podglądzie danych w oknie Importowanie pliku z danymi CSV.
    
    Zaimportowana tabela z danymi CSV otwarta w programie Kexi