Premiers pas
Bases du CLI
SQLite stocke une base entière dans un seul fichier. Le CLI sqlite3 ouvre ou crée un fichier .sqlite/.db à la demande. Contrairement à MySQL/PostgreSQL, pas de processus serveur — les applications lient directement la bibliothèque SQLite. .dump exporte toute la base en SQL texte pour backup ou migration.
# open/create a database file
sqlite3 mydb.sqlite
# at the sqlite> prompt
.help # show help
.tables # list tables
.schema users # show CREATE statement for users
.databases # list attached databases
.dump # dump entire DB as SQL text
.quit # exit
# execute SQL from a file
sqlite3 mydb.sqlite < script.sql
# execute a query from command line
sqlite3 mydb.sqlite "SELECT COUNT(*) FROM users;"Commandes point (dot commands)
Les dot commands sont interprétés par le CLI sqlite3, pas le moteur SQL — ils n'exigent jamais de point-virgule et ne sont pas disponibles via les API de programmation. .mode contrôle le formatage de sortie (essayez 'column' avec .header on pour un usage interactif lisible). .schema montre les CREATE ; .fullschema ajoute index, vues et triggers. Utilisez .help pour en découvrir plus.
-- dot commands are CLI-only, NOT SQL (no semicolon needed)
.help -- list all dot commands
.tables -- list all tables
.schema -- schema for all tables
.schema users -- schema for the users table
.fullschema -- schema incl. indexes, triggers, views
.indices users -- list indexes on users
.header on -- show column headers
.mode column -- column-aligned output
.mode list -- default, pipe-separated
.mode csv -- CSV output
.mode json -- JSON output
.show -- show current settings
.width 10 20 30 -- set column widths
.timer on -- show query execution timeGestion du fichier de base
ATTACH DATABASE permet à une connexion d'interroger jusqu'à 10 fichiers de base simultanément comme schémas (main, temp, plus attachées). L'URI :memory: crée une base purement en mémoire qui disparaît à la fermeture — idéal pour des tests ou calculs jetables. Les noms de fichiers URI (file:...) activent les modes lecture seule, cache partagé, etc. Chaque base attachée est un fichier séparé sur disque.
-- attach another database file to the current connection
ATTACH DATABASE 'archive.sqlite' AS archive;
DETACH DATABASE archive;
-- list attached databases (main + attached)
.databases
-- the in-memory database (never written to disk)
sqlite3 :memory:
-- temporary database (deleted when connection closes)
sqlite3 "" -- empty arg => temp DB
-- open read-only
sqlite3 "file:mydb.sqlite?mode=ro" --readonly
-- query the underlying page size / file format
PRAGMA page_size;
PRAGMA journal_mode;En-têtes et formatage de sortie
Le formatage de sortie n'affecte que le CLI, jamais les données. Le mode 'column' avec .headers on est le plus lisible pour l'humain. 'list' (défaut) est le meilleur pour les pipelines shell. 'json' et 'csv' font de SQLite un convertisseur pratique. .output redirige les résultats vers un fichier ; pensez à revenir avec .output stdout. .mode box/table dessine des bordures ASCII.
-- readable interactive mode
.headers on
.mode column
.width 15 20 10
SELECT id, name, email FROM users LIMIT 5;
-- pipe-separated (good for scripts)
.mode list
.separator "|"
SELECT id, name FROM users;
-- boxed table output (sqlite 3.36+)
.mode box
.mode table
-- JSON output for piping to other tools
.mode json
SELECT id, name FROM users;
-- write output to a file
.output users.txt
SELECT id, name FROM users;
.output stdoutExécuter des scripts et fichiers SQL
.read exécute un fichier SQL dans une session CLI ouverte ; une redirection avec < l'exécute avant l'invite interactive. --bail arrête le lot à la première erreur (sinon SQLite continue, ce qui peut masquer des échecs). .parameter (3.44+) lie des paramètres nommés depuis le shell, évitant l'interpolation de chaînes. Vérifiez toujours vos scripts avec .echo on en développement.
-- run a .sql file from the shell
sqlite3 mydb.sqlite ".read setup.sql"
-- or piped in
sqlite3 mydb.sqlite < setup.sql
-- inside the CLI
.read setup.sql
-- stop on first error (shell flag)
sqlite3 mydb.sqlite --bail < script.sql
-- echo commands as they run
.echo on
.read migrations.sql
-- show EXPLAIN before each statement (debug)
.explain on
-- parameterize from the shell (sqlite 3.44+)
sqlite3 mydb.sqlite \
-cmd ".parameter set @min 18" \
"SELECT name FROM users WHERE age >= @min"Tables et types de données
Créer des tables
INTEGER PRIMARY KEY est un alias du rowid — auto-incrémenté et la clé la plus rapide possible. AUTOINCREMENT change l'algorithme pour que les IDs supprimés ne soient jamais réutilisés (légèrement plus lent ; généralement inutile). DEFAULT (expr) autorise des expressions arbitraires comme datetime('now'). CREATE TABLE AS SELECT crée une table préchargée avec les résultats de la requête mais ne copie ni contraintes ni index.
CREATE TABLE users (
id INTEGER PRIMARY KEY AUTOINCREMENT,
username TEXT NOT NULL UNIQUE,
email TEXT NOT NULL UNIQUE,
age INTEGER CHECK (age >= 0),
role TEXT NOT NULL DEFAULT 'user',
created TEXT NOT NULL DEFAULT (datetime('now'))
);
CREATE TABLE IF NOT EXISTS orders (
id INTEGER PRIMARY KEY,
user_id INTEGER NOT NULL,
total REAL NOT NULL DEFAULT 0,
FOREIGN KEY (user_id) REFERENCES users(id)
ON DELETE CASCADE ON UPDATE CASCADE
);
-- quick table from a query
CREATE TABLE archive AS
SELECT * FROM orders WHERE created < '2024-01-01';Classes de stockage et affinité de type
SQLite utilise le typage dynamique : toute colonne peut contenir n'importe laquelle des 5 classes de stockage. « L'affinité de type » tente de convertir les valeurs quand possible (ex. '42' dans une colonne INTEGER devient l'entier 42) mais n'