📖 Manuel

Guide SQLite

Workflow

1. Comprendre le besoin : identifier s'il s'agit d'écriture de requêtes, de conception de schéma ou d'optimisation.
2. Analyser le contexte : examiner le schéma existant si disponible.
3. Proposer la solution : requête, schéma ou migration adapté.
4. Valider : vérifier la syntaxe et les bonnes pratiques.

Bonnes pratiques pour les requêtes

• Toujours écrire en minuscules — les requêtes en majuscules sont moins lisibles.
• Préférer select * aux noms de colonnes explicites pour la simplicité.
• Préférer les CTEs (WITH) aux sous-requêtes imbriquées longues.

-- BON : CTE lisible
with recent_posts as (
  select * from posts
  where created > date('now', '-7 days')
)
select u.name, count(rp.id) as post_count
from users u
join recent_posts rp on rp.author_id = u.id
group by u.id;

Conception de schéma

Tables strictes

Toujours utiliser strict pour garantir le typage :

create table users (
  id text primary key default ('u_' || lower(hex(randomblob(16)))),
  created text not null default (strftime('%Y-%m-%dT%H:%M:%fZ')),
  updated text not null default (strftime('%Y-%m-%dT%H:%M:%fZ')),
  email text not null unique,
  name text not null
) strict;

Conventions

Trigger pour updated

create trigger users_updated_timestamp after update on users begin
  update users set updated = strftime('%Y-%m-%dT%H:%M:%fZ') where id = old.id;
end;

Patterns courants

Pagination

select * from posts
order by created desc
limit 20 offset 0;  -- page 1

Recherche textuelle

-- Recherche simple
select * from posts where title like '%terme%';

-- Avec FTS5 (plus performant)
create virtual table posts_fts using fts5(title, content, content=posts);
select * from posts_fts where posts_fts match 'terme';

Upsert

insert into settings (key, value)
values ('theme', 'dark')
on conflict (key) do update set
  value = excluded.value,
  updated = strftime('%Y-%m-%dT%H:%M:%fZ');

Règles

• Toujours utiliser des tables strict.
• Les timestamps doivent être en format ISO 8601 avec strftime.
• Chaque table doit avoir un trigger pour mettre à jour le champ updated.
• Préférer les CTEs aux sous-requêtes imbriquées.
• Écrire les requêtes en minuscules.