התקנת SQLite: הגדרה ב-Windows, ב-macOS וב-Linux

SQLite כבר נמצאת במחשב שלכם (כנראה)

לפני שמתקינים משהו, בדקו מה כבר יש לכם. SQLite מגיעה עם macOS, עם רוב הפצות Linux ובתוך אינספור אפליקציות שאתם כבר משתמשים בהן. פתחו טרמינל והריצו:

sqlite3 --version

אם אתם רואים משהו כמו 3.43.2 2023-10-10 ..., סיימתם: דלגו לחלק על האימות בתחתית העמוד. אם מתקבל command not found או גרסה ישנה מ-3.35, המשיכו לקרוא. נעבור על Windows, macOS ו-Linux לפי הסדר.

מה שאתם מתקינים הוא כלי שורת הפקודה sqlite3. הספרייה שתוכנות מתקשרות אליה היא חבילה נפרדת, אבל רוב תוכנות ההתקנה מאגדות את שתיהן יחד.

Windows: הורדה והוספה ל-PATH

Windows לא מגיעה עם SQLite, ואין תוכנת התקנה רגילה: SQLite מופצת כקובץ zip קטן של קובצי הרצה שמניחים איפה שרוצים.

1. היכנסו ל-sqlite.org/download.html.
2. תחת Precompiled Binaries for Windows, הורידו את הקובץ בשם sqlite-tools-win-x64-*.zip.
3. חלצו אותו לתיקייה. C:\sqlite היא בחירה נפוצה.
4. הוסיפו את התיקייה ל-PATH כדי שתוכלו להריץ sqlite3 מכל תיקייה.

כדי להוסיף ל-PATH: פתחו את תפריט התחל, חפשו "environment variables", לחצו על Edit the system environment variables, ואז על Environment Variables..., מצאו את Path תחת משתני המשתמש, לחצו על Edit והוסיפו את C:\sqlite כרשומה חדשה.

פתחו חלון טרמינל חדש (שינויים ב-PATH לא חלים על טרמינלים שכבר פתוחים) ובדקו:

sqlite3 --version

אתם אמורים לראות את מחרוזת הגרסה. אם מתקבל 'sqlite3' is not recognized, התיקייה לא נמצאת ב-PATH או שהטרמינל החדש עוד לא קלט את השינוי.

macOS: השתמשו ב-Homebrew לגרסה העדכנית

macOS כוללת את sqlite3 מהקופסה, אבל גרסת המערכת מפגרת אחרי הגרסה הרשמית בשנה או שנתיים. למדריכים ולשימוש מזדמן זה בסדר. אם אתם רוצים תכונות חדשות (טבלאות STRICT, שיפורים ב-JSON, window functions טובות יותר), התקינו גרסה עדכנית עם Homebrew:

brew install sqlite

Homebrew מתקין את SQLite בתיקייה משלו ובכוונה לא דורס את העותק של המערכת. כדי להשתמש בגרסת Homebrew כברירת מחדל, הוסיפו אותה לתחילת ה-PATH. הוסיפו את השורה הזו ל-~/.zshrc:

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

(במחשבי Mac עם מעבד Intel השתמשו במקום זאת ב-/usr/local/opt/sqlite/bin.) טענו מחדש את המעטפת עם source ~/.zshrc ובדקו:

sqlite3 --version

אם הגרסה עדיין נראית ישנה, ה-sqlite3 של המערכת מנצח במרוץ על ה-PATH: בדקו שוב ששורת ה-export מופיעה לפני כל שינוי אחר ב-PATH.

Linux: השתמשו במנהל החבילות

כמעט לכל הפצת Linux יש SQLite במאגרים ברירת המחדל שלה. הפקודה משתנה לפי ההפצה:

# 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

שם החבילה הוא sqlite3 במערכות ממשפחת Debian ופשוט sqlite ברוב האחרות. כולן מתקינות את כלי שורת הפקודה sqlite3 ואת הספרייה המשותפת שתוכנות אחרות משתמשות בה כדי להטמיע את SQLite.

אם אתם צריכים את הגרסה החדשה ביותר וההפצה שלכם מפגרת, אפשר לבנות מקוד המקור: הורידו את קובץ ה-tarball של ה-amalgamation מ-sqlite.org והריצו ./configure && make && sudo make install. ל-99% מהמשתמשים, הגרסה של מנהל החבילות מספיקה.

אימות ההתקנה

לא משנה באיזו דרך הלכתם, אותה בדיקה בשני שלבים תגיד לכם שהכול עובד. קודם, הגרסה:

sqlite3 --version

אתם אמורים לראות מספר גרסה, תאריך ו-hash של הבנייה. אחר כך פתחו את מעטפת SQLite בלי ארגומנטים, מה שנותן לכם מסד נתונים בזיכרון להתנסות בו:

sqlite3

תגיעו לשורת פקודה שנראית כמו sqlite>. הקלידו שאילתה קטנטנה כדי לוודא שהמנוע באמת רץ:

SELECT sqlite_version(), 'Hello from SQLite' AS greeting;

אתם אמורים לקבל בחזרה את מחרוזת הגרסה ואת הברכה. כדי לצאת מהמעטפת, הקלידו .quit ולחצו Enter. הנקודה בהתחלה חשובה: כך SQLite מבחינה בין פקודות מעטפת (.quit, .help, .tables) לבין פקודות SQL.

תקלות נפוצות

כמה דברים שמכשילים אנשים בהתקנה הראשונה:

• sqlite3: command not found אחרי ההתקנה. קובץ ההרצה נמצא איפשהו, אבל לא ב-PATH. ב-Windows, בדקו שוב את משתנה הסביבה. ב-macOS עם Homebrew, ודאו ששורת ה-export PATH=... נמצאת בקובץ ההגדרות של המעטפת ושפתחתם טרמינל חדש.
• גרסה לא נכונה מופיעה ב-macOS. ה-sqlite3 של המערכת נמצא ב-/usr/bin/sqlite3 וכמעט תמיד מנצח כברירת מחדל. הריצו which sqlite3 כדי לראות באיזה מהם המעטפת בוחרת. העותק של Homebrew צריך להופיע מוקדם יותר ב-PATH.
• .quit לא עובד. כנראה הקלדתם quit בלי הנקודה בהתחלה, ו-SQLite מנסה לפענח את זה כ-SQL. תמיד התחילו פקודות מעטפת ב-..
• שגיאות של חוסר הרשאת כתיבה ביצירת קובץ מסד נתונים. SQLite צריכה הרשאת כתיבה לתיקייה שבה אתם מריצים אותה. או שתעשו קודם cd למקום שאפשר לכתוב בו, או שתעבירו נתיב מפורש: sqlite3 ~/mydb.db.

אם sqlite3 --version עובד ואתם יכולים להריץ SELECT, אתם מוכנים. כל השאר בתוכנית הלימודים הזו נבנה על ה-CLI שהרגע התקנתם.

הצעד הבא: ה-CLI של SQLite

עכשיו ש-sqlite3 נמצא ב-PATH, הצעד הבא הוא ללמוד לתפעל אותו. למעטפת יש סט קטן של פקודות נקודה (.tables, .schema, .mode, .import) שהופכות אותה ללקוח מסד נתונים מסוגל באופן מפתיע, ועל זה העמוד הבא.