cassandra-guide

Cassandra Guide

1. Modéliser par les requêtes (Query-Driven Design)

Cassandra n'est pas relationnel : le schéma découle des requêtes, pas l'inverse.

Étapes :

1. Lister exhaustivement les patterns de requête de l'application.
2. Créer une table par requête — la dénormalisation est normale et attendue.
3. Choisir la partition key pour distribuer uniformément les données entre nœuds.
4. Choisir les clustering columns pour le tri intra-partition et les filtres de range.

Critères de choix de partition key :

• Cardinalité élevée → distribution uniforme (évite les "hot partitions").
• Pas de colonne nullable ni à faible cardinalité (statut booléen, enum à 3 valeurs).
• Si une seule colonne ne suffit pas, utilisez une clé composite : PRIMARY KEY ((user_id, month), event_time).

-- Table events par utilisateur et mois (bucketing temporel)
CREATE TABLE events_by_user (
    user_id    UUID,
    month      TEXT,          -- ex. '2026-06'
    event_time TIMEUUID,
    payload    TEXT,
    PRIMARY KEY ((user_id, month), event_time)
) WITH CLUSTERING ORDER BY (event_time DESC);

2. Concevoir le schéma CQL

Types recommandés :

• UUID / TIMEUUID pour les identifiants (TIMEUUID = ordonné chronologiquement).
• FROZEN<map<text,text>> pour les structures imbriquées immuables.
• TEXT plutôt que VARCHAR (identiques, TEXT préféré par convention).
• COUNTER uniquement dans des tables dédiées (non mixable avec d'autres colonnes writables).

User Defined Types (UDT) :

CREATE TYPE address (
    street TEXT,
    city   TEXT,
    zip    TEXT
);

CREATE TABLE customers (
    id      UUID PRIMARY KEY,
    name    TEXT,
    address FROZEN<address>
);

Materialized Views — attention :

• Utiles pour les requêtes secondaires, mais coût d'écriture doublé.
• En production haute charge, préférer des tables de lookup manuelles + batch logged.

3. Configurer la réplication

Contexte	Stratégie	Config
Dev / single DC	SimpleStrategy	replication_factor: 1
Prod single DC	SimpleStrategy	replication_factor: 3
Prod multi-DC	NetworkTopologyStrategy	RF par DC (dc1: 3, dc2: 3)