Installer SQLite sur Windows, macOS et Linux

SQLite est déjà installé sur votre machine (probablement)

Avant d'installer quoi que ce soit, jetez un œil à ce que vous avez déjà. SQLite est livré d'office avec macOS, avec la plupart des distributions Linux, et il se cache dans une foule d'applications que vous utilisez tous les jours. Ouvrez un terminal et lancez :

sqlite3 --version

Si vous voyez quelque chose du genre 3.43.2 2023-10-10 ..., c'est bon — filez directement à la section de vérification en bas de cette page. Si vous obtenez command not found ou une version antérieure à 3.35, continuez votre lecture. On va passer en revue Windows, macOS et Linux, dans cet ordre.

Ce que vous installez ici, c'est l'outil en ligne de commande sqlite3. La bibliothèque utilisée par les programmes pour s'y lier est un paquet distinct, mais la plupart des installeurs regroupent les deux.

Installer SQLite sur Windows et l'ajouter au PATH

Windows n'embarque pas SQLite par défaut, et il n'existe pas vraiment d'installeur classique : SQLite est distribué sous la forme d'une petite archive zip contenant des exécutables, à placer où bon te semble.

1. Rendez-vous sur sqlite.org/download.html.
2. Sous Precompiled Binaries for Windows, téléchargez le fichier nommé sqlite-tools-win-x64-*.zip.
3. Décompressez-le dans un dossier de votre choix. C:\sqlite est un emplacement classique.
4. Ajoutez ce dossier à votre PATH pour pouvoir lancer sqlite3 depuis n'importe quel répertoire.

Pour ajouter le dossier au PATH : ouvrez le menu Démarrer, tapez « variables d'environnement », cliquez sur Modifier les variables d'environnement système, puis sur Variables d'environnement…, repérez Path dans les variables utilisateur, cliquez sur Modifier et ajoutez C:\sqlite comme nouvelle entrée.

Ouvrez une nouvelle fenêtre de terminal (les modifications du PATH ne s'appliquent pas aux terminaux déjà ouverts) et vérifiez :

sqlite3 --version

Vous devriez voir s'afficher le numéro de version. Si vous obtenez 'sqlite3' is not recognized, c'est que le dossier n'est pas dans votre PATH, ou bien que le nouveau terminal n'a pas encore pris en compte la modification.

macOS : installer SQLite avec Homebrew pour avoir la dernière version

macOS embarque déjà sqlite3 par défaut, mais la version système traîne souvent un an ou deux de retard sur la version officielle. Pour suivre un tuto ou un usage occasionnel, ça passe sans souci. En revanche, si vous voulez profiter des nouveautés récentes (tables STRICT, améliorations JSON, fonctions de fenêtrage plus complètes), installez une version à jour via Homebrew :

brew install sqlite

Homebrew installe SQLite dans son propre préfixe et évite volontairement d'écraser la version fournie par le système. Pour utiliser la version Homebrew par défaut, il faut l'ajouter en tête de votre PATH. Ajoutez la ligne suivante dans votre ~/.zshrc :

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

(Sur les Mac Intel, utilisez plutôt /usr/local/opt/sqlite/bin.) Rechargez votre shell avec source ~/.zshrc, puis vérifiez :

sqlite3 --version

Si la version affichée reste l'ancienne, c'est que le sqlite3 du système a gagné la course du PATH — vérifiez bien que votre ligne export est placée avant toute autre modification du PATH.

Linux : passez par votre gestionnaire de paquets

SQLite est disponible dans les dépôts officiels de quasiment toutes les distributions Linux. La commande à utiliser dépend de votre distro :

# 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

Le paquet s'appelle sqlite3 sur les systèmes de la famille Debian, et tout simplement sqlite sur la plupart des autres. Dans tous les cas, l'installation vous fournit l'outil en ligne de commande sqlite3 ainsi que la bibliothèque partagée utilisée par les autres programmes pour embarquer SQLite.

Si vous avez besoin de la toute dernière version et que votre distribution traîne un peu, vous pouvez compiler depuis les sources : récupérez l'archive amalgamation sur sqlite.org puis lancez ./configure && make && sudo make install. Cela dit, pour 99 % des cas, la version fournie par le gestionnaire de paquets fait largement l'affaire.

Vérifier l'installation de SQLite

Quelle que soit la méthode choisie, la même vérification en deux étapes confirme que tout fonctionne. On commence par la version :

sqlite3 --version

Vous devriez voir s'afficher un numéro de version, une date et un hash de build. Lancez ensuite le shell SQLite sans aucun argument — vous obtenez ainsi une base de données en mémoire pour vous faire la main :

sqlite3

Vous arrivez sur une invite du type sqlite>. Tapez une petite requête pour vérifier que le moteur tourne bien :

SELECT sqlite_version(), 'Bonjour depuis SQLite' AS greeting;

Vous devriez voir s'afficher le numéro de version ainsi que le message de bienvenue. Pour sortir du shell, tapez .quit puis appuyez sur Entrée. Attention au point au début : c'est comme ça que SQLite fait la différence entre une commande du shell (.quit, .help, .tables) et une instruction SQL.

Les pièges classiques

Voici les quelques galères qu'on rencontre souvent lors d'une première installation :

• sqlite3: command not found après l'installation. Le binaire est bien quelque part, mais pas dans votre PATH. Sous Windows, revérifiez la variable d'environnement. Sur macOS avec Homebrew, assurez-vous que la ligne export PATH=... est bien présente dans la configuration de votre shell, et ouvrez un nouveau terminal.
• Mauvaise version qui s'affiche sur macOS. Le sqlite3 du système se trouve dans /usr/bin/sqlite3 et prend presque toujours le dessus. Lancez which sqlite3 pour voir laquelle votre shell utilise. La version Homebrew doit apparaître plus tôt dans le PATH.
• .quit ne fonctionne pas. Vous avez sans doute tapé quit sans le point, ce que SQLite tente d'interpréter comme du SQL. Commencez toujours les commandes du shell par ..
• Erreurs de permissions à la création d'un fichier de base. SQLite a besoin d'un accès en écriture sur le dossier depuis lequel vous le lancez. Soit faites un cd vers un dossier où vous pouvez écrire, soit indiquez un chemin explicite : sqlite3 ~/mydb.db.

Si sqlite3 --version répond correctement et que vous arrivez à exécuter un SELECT, c'est tout bon. Tout le reste du parcours s'appuie sur la CLI que vous venez d'installer.

La suite : la CLI SQLite

Maintenant que sqlite3 est dans votre PATH, l'étape suivante consiste à apprendre à s'en servir. Le shell propose un petit ensemble de commandes-point (.tables, .schema, .mode, .import) qui en font un client de base de données étonnamment puissant — c'est précisément ce que la page suivante va couvrir.