Instalacja SQLite: Windows, macOS i Linux krok po kroku

SQLite (prawdopodobnie) już jest na twoim komputerze

Zanim cokolwiek zainstalujesz, sprawdź, co już masz. SQLite jest dołączony do macOS, większości dystrybucji Linuksa i niezliczonych aplikacji, z których już korzystasz. Otwórz terminal i uruchom:

sqlite3 --version

Jeśli widzisz coś w rodzaju 3.43.2 2023-10-10 ..., gotowe: przejdź do sekcji weryfikacji na dole tej strony. Jeśli dostajesz command not found albo wersję starszą niż 3.35, czytaj dalej. Omówimy po kolei Windows, macOS i Linuksa.

Instalujesz narzędzie wiersza poleceń sqlite3. Biblioteka, z którą łączą się programy, to osobny pakiet, ale większość instalatorów dostarcza oba razem.

Windows: pobierz i dodaj do PATH

Windows nie ma SQLite w zestawie i nie ma tradycyjnego instalatora: SQLite jest rozprowadzany jako małe archiwum zip z plikami wykonywalnymi, które umieszczasz, gdzie chcesz.

1. Wejdź na sqlite.org/download.html.
2. W sekcji Precompiled Binaries for Windows pobierz plik o nazwie sqlite-tools-win-x64-*.zip.
3. Rozpakuj go do folderu. Popularny wybór to C:\sqlite.
4. Dodaj ten folder do PATH, żeby móc uruchamiać sqlite3 z dowolnego katalogu.

Żeby dodać go do PATH: otwórz menu Start, wyszukaj „zmienne środowiskowe”, kliknij Edytuj zmienne środowiskowe systemu, potem Zmienne środowiskowe..., znajdź Path wśród zmiennych użytkownika, kliknij Edytuj i dodaj C:\sqlite jako nowy wpis.

Otwórz nowe okno terminala (zmiany PATH nie dotyczą terminali, które już są otwarte) i sprawdź:

sqlite3 --version

Powinien pojawić się numer wersji. Jeśli dostajesz 'sqlite3' is not recognized, folderu nie ma w PATH albo nowy terminal jeszcze nie widzi zmiany.

macOS: najnowsza wersja przez Homebrew

macOS zawiera sqlite3 od razu po instalacji systemu, ale wersja systemowa jest rok lub dwa za wersją główną. Do samouczków i codziennego użytku to wystarczy. Jeśli chcesz nowszych funkcji (tabele STRICT, ulepszenia JSON, lepsze funkcje okna), zainstaluj aktualną wersję przez Homebrew:

brew install sqlite

Homebrew instaluje SQLite we własnym katalogu i celowo nie nadpisuje kopii systemowej. Żeby domyślnie używać wersji z Homebrew, dodaj ją na początek PATH. Dopisz to do ~/.zshrc:

export PATH="/opt/homebrew/opt/sqlite/bin:$PATH"

(Na Macach z procesorem Intel użyj zamiast tego /usr/local/opt/sqlite/bin.) Przeładuj powłokę przez source ~/.zshrc i sprawdź:

sqlite3 --version

Jeśli wersja nadal wygląda na starą, wygrywa systemowe sqlite3. Upewnij się, że linia z export jest przed wszystkimi innymi zmianami PATH.

Linux: użyj menedżera pakietów

Prawie każda dystrybucja Linuksa ma SQLite w domyślnych repozytoriach. Polecenie zależy od dystrybucji:

# Debian, Ubuntu, Mint
sudo apt update
sudo apt install sqlite3

# Fedora, RHEL, CentOS Stream
sudo dnf install sqlite

# Arch, Manjaro
sudo pacman -S sqlite

# Alpine
sudo apk add sqlite

W systemach z rodziny Debiana pakiet nazywa się sqlite3, a w większości pozostałych po prostu sqlite. Wszystkie instalują narzędzie wiersza poleceń sqlite3 oraz bibliotekę współdzieloną, której inne programy używają do osadzania SQLite.

Jeśli potrzebujesz najnowszej wersji, a twoja dystrybucja jest w tyle, możesz zbudować SQLite ze źródeł: pobierz archiwum amalgamation ze strony sqlite.org i uruchom ./configure && make && sudo make install. Dla 99% użytkowników wersja z menedżera pakietów w zupełności wystarczy.

Sprawdzenie instalacji

Niezależnie od wybranej drogi to samo dwuetapowe sprawdzenie powie ci, czy wszystko działa. Najpierw wersja:

sqlite3 --version

Powinien pojawić się numer wersji, data i skrót kompilacji. Potem otwórz powłokę SQLite bez argumentów: dostaniesz bazę w pamięci do zabawy:

sqlite3

Trafisz do wiersza poleceń, który wygląda tak: sqlite>. Wpisz małe zapytanie, żeby upewnić się, że silnik naprawdę działa:

SELECT sqlite_version(), 'Cześć z SQLite' AS greeting;

Powinien wrócić numer wersji i powitanie. Żeby wyjść z powłoki, wpisz .quit i naciśnij Enter. Kropka na początku jest ważna: po niej SQLite odróżnia polecenia powłoki (.quit, .help, .tables) od instrukcji SQL.

Częste problemy

Kilka rzeczy, na które ludzie trafiają przy pierwszej instalacji:

• sqlite3: command not found po instalacji. Plik wykonywalny gdzieś jest, ale nie w PATH. Na Windows sprawdź ponownie zmienną środowiskową. Na macOS z Homebrew upewnij się, że linia export PATH=... jest w konfiguracji powłoki i że otwarto nowy terminal.
• Na macOS pokazuje się zła wersja. Systemowe sqlite3 jest w /usr/bin/sqlite3 i domyślnie prawie zawsze wygrywa. Uruchom which sqlite3, żeby zobaczyć, którą wersję wybiera powłoka. Kopia z Homebrew musi być wcześniej w PATH.
• .quit nie działa. Najpewniej wpisano quit bez kropki na początku, a SQLite próbuje to przetworzyć jako SQL. Polecenia powłoki zawsze zaczynaj od ..
• Błędy braku uprawnień do zapisu przy tworzeniu pliku bazy. SQLite potrzebuje prawa zapisu w katalogu, w którym go uruchamiasz. Najpierw przejdź przez cd do miejsca z prawem zapisu albo podaj jawną ścieżkę: sqlite3 ~/mydb.db.

Jeśli sqlite3 --version działa i możesz wykonać SELECT, wszystko gotowe. Cała reszta tych materiałów opiera się na zainstalowanym właśnie CLI.

Dalej: CLI SQLite

Skoro sqlite3 jest już w PATH, kolejny krok to nauka obsługi. Powłoka ma mały zestaw poleceń z kropką (.tables, .schema, .mode, .import), które zamieniają ją w zaskakująco sprawnego klienta bazy danych. O tym jest następna strona.