Ou tapez /cassandra-guide dans une session Claude Code, ou décrivez simplement votre besoin — le skill se déclenche automatiquement via le skill-router.
🔑 Déclencheurs automatiques
Le skill s'active automatiquement quand votre demande contient :
Modéliser par les requêtes — Lister tous les patterns de requêtes de l'application. Créer une table par requête (query-driven modeling). Définir les partition keys pour distribuer uniformément les données et les clustering columns pour le tri intra-partition.
Concevoir le schéma CQL — Définir les types de données appropriés (UUID, TIMEUUID, TEXT, FROZEN). Utiliser les User Defined Types (UDT) pour les données imbriquées. Créer des materialized views ou des tables de dénormalisation pour les requêtes secondaires.
Configurer la réplication — Choisir la stratégie de réplication : SimpleStrategy (développement) ou NetworkTopologyStrategy (production multi-datacenter). Définir le replication factor (RF=3 minimum en production). Configurer les consistency levels par requête (QUORUM, LOCAL_QUORUM).
Optimiser la compaction — Sélectionner la stratégie de compaction adaptée : SizeTieredCompactionStrategy (STCS) pour les écritures intensives, LeveledCompactionStrategy (LCS) pour les lectures intensives, TimeWindowCompactionStrategy (TWCS) pour les time-series.
Gérer le cluster — Configurer nodetool pour les opérations de maintenance (repair, cleanup, compact). Planifier les réparations régulières avec cassandra-reaper. Gérer l'ajout et le retrait de noeuds avec nodetool decommission et nodetool bootstrap.
Implémenter les requêtes — Utiliser les prepared statements systématiquement pour les performances et la sécurité. Implémenter la pagination avec le paging state. Éviter les requêtes ALLOW FILTERING et les IN sur les partition keys.
Monitorer le cluster — Déployer les métriques JMX vers Prometheus avec cassandra-exporter. Surveiller les indicateurs critiques : latence P99, pending compactions, dropped mutations, GC pauses, partition size.
Planifier la capacité — Estimer la taille des partitions (max 100 MB recommandé). Calculer le stockage nécessaire avec le replication factor. Prévoir le nombre de noeuds en fonction du throughput cible et du ratio lecture/écriture.
Règles
Ne jamais dépasser 100 MB par partition ; utiliser le bucketing temporel ou un identifiant composite pour fragmenter les partitions volumineuses.
Toujours utiliser LOCAL_QUORUM en production multi-datacenter pour garantir la consistance sans impacter la latence inter-datacenter.
Ne jamais utiliser des secondary indexes Cassandra sur des colonnes à haute cardinalité ; préférer la création de tables de lookup dédiées.
Exécuter nodetool repair régulièrement (au moins tous les gc_grace_seconds) pour éviter la résurrection de données supprimées (tombstone).
Toujours tester les migrations de schéma en rolling fashion, noeud par noeud, pour éviter les interruptions de service.