تثبيت SQLite على Windows وmacOS وLinux

SQLite موجود على جهازك بالفعل (على الأرجح)

قبل ما تبدأ بأي تثبيت، شوف إيش عندك أصلًا. SQLite يأتي مثبتًا مسبقًا مع macOS، ومع معظم توزيعات Linux، وحتى داخل عدد كبير من التطبيقات التي تستخدمها يوميًا دون أن تشعر. افتح الـ Terminal وجرّب الأمر التالي:

sqlite3 --version

إذا ظهر لك شيء مثل 3.43.2 2023-10-10 ...، فقد انتهيت — انتقل مباشرة إلى قسم التحقق في نهاية هذه الصفحة. أما إذا ظهرت لك رسالة command not found أو إصدار أقدم من 3.35، فتابع القراءة. سنغطي ويندوز وmacOS ولينكس بالترتيب.

ما تقوم بتثبيته فعلياً هو أداة سطر الأوامر sqlite3. أما المكتبة التي ترتبط بها البرامج فهي حزمة منفصلة، لكن معظم برامج التثبيت تجمعهما معاً.

تثبيت sqlite على ويندوز وإضافته إلى PATH

ويندوز لا يأتي بـ SQLite مدمجاً، ولا يوجد مُثبِّت تقليدي بصيغة installer — فـ SQLite يُوزَّع كملف zip صغير يحتوي على ملفات تنفيذية تضعها في المكان الذي يناسبك.

1. ادخل إلى sqlite.org/download.html.
2. تحت قسم Precompiled Binaries for Windows، نزّل الملف المسمى sqlite-tools-win-x64-*.zip.
3. فك ضغط الملف داخل مجلد. الخيار الشائع هو C:\sqlite.
4. أضف هذا المجلد إلى متغير PATH لتتمكن من تشغيل sqlite3 من أي مسار.

لإضافته إلى PATH: افتح قائمة Start وابحث عن "environment variables"، ثم اضغط على Edit the system environment variables، ثم على Environment Variables...، وابحث عن Path ضمن متغيرات المستخدم، واضغط Edit، ثم أضف C:\sqlite كمدخل جديد.

افتح نافذة طرفية جديدة (تغييرات PATH لا تسري على النوافذ المفتوحة مسبقاً)، وتحقق من التثبيت:

sqlite3 --version

من المفترض أن ترى سطر الإصدار. أما إذا ظهرت لك رسالة 'sqlite3' is not recognized، فهذا يعني أن المجلد لم يُضَف إلى متغيّر PATH، أو أن نافذة الطرفية الجديدة لم تلتقط التغييرات بعد.

تثبيت sqlite على macOS باستخدام Homebrew للحصول على أحدث إصدار

يأتي نظام macOS مزوَّدًا بـ sqlite3 جاهزًا، لكن النسخة المضمَّنة في النظام عادةً ما تتأخر عن الإصدار الرسمي بسنة أو سنتين. لا بأس بذلك إن كنت تتابع شروحات تعليمية أو تستخدمه استخدامًا عابرًا. أما إذا أردت الاستفادة من الميزات الحديثة مثل جداول STRICT، وتحسينات JSON، ودوال النوافذ الأفضل، فالأفضل أن تُثبّت إصدارًا حديثًا عبر Homebrew:

brew install sqlite

يقوم Homebrew بتثبيت SQLite في مسار خاص به، ولا يستبدل النسخة الموجودة في النظام عمدًا. لكي تعتمد على نسخة Homebrew بشكل افتراضي، تحتاج إلى إضافتها في بداية متغير PATH. أضف السطر التالي إلى ملف ~/.zshrc:

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

(استخدم /usr/local/opt/sqlite/bin بدلًا من ذلك على أجهزة Mac بمعالج Intel.) أعد تحميل الـ shell عبر source ~/.zshrc ثم تحقق:

sqlite3 --version

إذا ظهرت لك النسخة القديمة، فهذا يعني أن sqlite3 الخاص بالنظام هو من يفوز في ترتيب PATH — تأكد من أن سطر export يأتي قبل أي تعديلات أخرى على PATH.

تثبيت sqlite على لينكس عبر مدير الحزم

تقريبًا كل توزيعات لينكس توفّر SQLite ضمن المستودعات الافتراضية. الأمر يختلف من توزيعة لأخرى:

# ديبيان، أوبونتو، مينت
sudo apt update
sudo apt install sqlite3

# فيدورا، RHEL، CentOS Stream
sudo dnf install sqlite

# آرتش، مانجارو
sudo pacman -S sqlite

# ألبَين
sudo apk add sqlite

اسم الحزمة هو sqlite3 على الأنظمة المبنية على Debian، ومجرد sqlite على معظم الأنظمة الأخرى. كلها تُثبّت أداة سطر الأوامر sqlite3 بالإضافة إلى المكتبة المشتركة التي تستخدمها البرامج الأخرى لتضمين SQLite بداخلها.

إذا كنت بحاجة إلى أحدث إصدار وكانت توزيعتك متأخرة قليلاً، يمكنك البناء من المصدر — نزّل أرشيف amalgamation من موقع sqlite.org ثم نفّذ ./configure && make && sudo make install. لكن بالنسبة لـ 99% من المستخدمين، الإصدار الموجود في مدير الحزم يفي بالغرض.

التحقق من تثبيت sqlite

أيًا كان المسار الذي اتبعته، فإن نفس الفحص المكوّن من خطوتين يخبرك بأن كل شيء يعمل كما ينبغي. أولاً، تحقق من الإصدار:

sqlite3 --version

من المفترض أن يظهر لك رقم الإصدار والتاريخ ثم بصمة البناء (build hash). بعد ذلك، شغّل صدفة SQLite بدون أي وسائط، وبهذه الطريقة تحصل على قاعدة بيانات في الذاكرة (in-memory) تجرّب عليها بحرية:

sqlite3

ستظهر لك شاشة تبدأ بالموجِّه sqlite>. جرّب تنفيذ استعلام بسيط للتأكد من أن المحرك يعمل فعلاً:

SELECT sqlite_version(), 'مرحبًا من SQLite' AS greeting;

من المفترض أن يظهر لك سطر الإصدار ورسالة الترحيب. للخروج من الـ shell، اكتب .quit ثم اضغط Enter. لاحظ النقطة في البداية، فهي مهمة — بهذه الطريقة يميّز SQLite بين أوامر الـ shell (.quit, .help, .tables) وبين جمل SQL.

مشاكل شائعة تواجهك بعد التثبيت

هناك بعض الأمور التي يقع فيها كثيرون عند تثبيت sqlite لأول مرة:

• رسالة sqlite3: command not found بعد التثبيت. الملف التنفيذي موجود في مكانٍ ما، لكنه ليس مُضافًا إلى الـ PATH. على ويندوز، راجع متغيّر البيئة من جديد. على macOS مع Homebrew، تأكد أن سطر export PATH=... موجود في ملف إعدادات الـ shell، ثم افتح نافذة طرفية جديدة.
• يظهر إصدار خاطئ على macOS. نسخة sqlite3 المُرفقة مع النظام موجودة في /usr/bin/sqlite3، وهي التي تُستخدم افتراضيًا في الغالب. شغّل which sqlite3 لترى أيّ نسخة يختارها الـ shell. لكي تُستخدم نسخة Homebrew، يجب أن تأتي قبلها في ترتيب الـ PATH.
• الأمر .quit لا يعمل. على الأرجح كتبت quit بدون النقطة في البداية، فحاول SQLite تفسيرها كجملة SQL. ابدأ دائمًا أوامر الـ shell بنقطة ..
• أخطاء صلاحيات الكتابة عند إنشاء ملف قاعدة بيانات. يحتاج SQLite إلى صلاحية الكتابة في المجلد الذي تشغّله منه. إما أن تنتقل بـ cd إلى مجلد قابل للكتابة، أو تُمرّر مسارًا صريحًا: sqlite3 ~/mydb.db.

إذا نجح أمر sqlite3 --version وتمكّنت من تشغيل جملة SELECT، فأنت جاهز. كل ما يأتي لاحقًا في هذا المنهج مبنيٌّ على الـ CLI الذي ثبّته للتو.

الخطوة التالية: التعرّف على واجهة SQLite CLI

بعد أن أصبح sqlite3 متاحًا في الـ PATH، الخطوة التالية هي تعلّم كيفية استخدامه فعليًا. يحتوي الـ shell على مجموعة صغيرة من الأوامر التي تبدأ بنقطة (.tables, .schema, .mode, .import)، وهذه الأوامر وحدها تحوّله إلى عميل قواعد بيانات قوي بشكل مفاجئ — وهذا ما سنتناوله في الصفحة التالية.