Bonnes pratiques Redis

Guide complet d'optimisation de la performance pour Redis, incluant Redis Query Engine, la recherche vectorielle et le cache sémantique. Contient 29 règles réparties sur 11 catégories, priorisées par impact pour guider l'optimisation automatisée et la génération de code.

Quand appliquer

Consultez ces directives quand :

• Concevoir des modèles de données Redis et des structures de clés
• Implémenter la mise en cache, les sessions ou les fonctionnalités temps réel
• Utiliser Redis Query Engine (FT.CREATE, FT.SEARCH, FT.AGGREGATE)
• Construire des applications de recherche vectorielle ou RAG avec RedisVL
• Implémenter un cache sémantique avec LangCache
• Optimiser la performance et l'utilisation mémoire de Redis

Catégories de règles par priorité

Référence rapide

1. Structures de données & Clés (HIGH)

• data-choose-structure - Choisir la bonne structure de données
• data-key-naming - Utiliser des conventions de nommage de clés cohérentes

2. Mémoire & Expiration (HIGH)

• ram-limits - Configurer les limites de mémoire et les politiques d'éviction
• ram-ttl - Définir TTL sur les clés de cache

3. Connexion & Performance (HIGH)

• conn-blocking - Éviter les commandes lentes en production
• conn-pipelining - Utiliser le pipelining pour les opérations groupées
• conn-pooling - Utiliser le pooling de connexions ou le multiplexage
• conn-timeouts - Configurer les timeouts de connexion

4. Documents JSON (MEDIUM)

• json-partial-updates - Utiliser les chemins JSON pour les mises à jour partielles
• json-vs-hash - Choisir JSON vs Hash appropriément

5. Redis Query Engine (HIGH)

• rqe-dialect - Utiliser DIALECT 2 pour la syntaxe de requête
• rqe-field-types - Choisir le bon type de champ
• rqe-index-creation - Indexer uniquement les champs interrogés
• rqe-index-management - Gérer les index pour les mises à jour sans interruption
• rqe-query-optimization - Écrire des requêtes efficaces

6. Recherche vectorielle & RedisVL (HIGH)

• vector-algorithm-choice - Choisir HNSW vs FLAT selon les exigences
• vector-hybrid-search - Utiliser la recherche hybride pour de meilleurs résultats
• vector-index-creation - Configurer correctement les index vectoriels
• vector-rag-pattern - Implémenter correctement le pattern RAG

7. Cache sémantique (MEDIUM)

• semantic-cache-best-practices - Configurer correctement le cache sémantique
• semantic-cache-langcache-usage - Utiliser LangCache pour la mise en cache des réponses LLM

8. Streams & Pub/Sub (MEDIUM)

• stream-choosing-pattern - Choisir Streams vs Pub/Sub appropriément

9. Clustering & Réplication (MEDIUM)

• cluster-hash-tags - Utiliser les hash tags pour les opérations multi-clés
• cluster-read-replicas - Utiliser les répliques en lecture pour les charges de lecture intensives

10. Sécurité (HIGH)

• security-acls - Utiliser les ACLs pour un contrôle d'accès granulaire
• security-auth - Toujours utiliser l'authentification en production
• security-network - Sécuriser l'accès réseau

11. Observabilité (MEDIUM)

• observe-commands - Utiliser les commandes d'observabilité pour le débogage
• observe-metrics - Surveiller les métriques clés de Redis

Comment utiliser

Consultez les fichiers de règles individuels pour des explications détaillées et des exemples de code :

rules/rqe-index-creation.md
rules/vector-rag-pattern.md

Chaque fichier de règle contient :

• Brève explication de l'importance
• Exemple(s) correct(s) avec explication
• Soit un exemple « Incorrect » (pour les anti-patterns qui causent des problèmes réels), soit une guidance « Quand utiliser / Quand non nécessaire » (pour les fonctionnalités optionnelles)
• Contexte supplémentaire et références

Document compilé complet

Pour le guide complet avec toutes les règles développées : AGENTS.md