Redis ベストプラクティス

Redis のための包括的なパフォーマンス最適化ガイド。Redis Query Engine、ベクトル検索、セマンティックキャッシング を含みます。自動最適化とコード生成を導くため、影響度順に優先付けされた 11 カテゴリ全体にわたる 29 個のルールを含みます。

適用時期

以下の場合にこれらのガイドラインを参照してください:

• Redis データモデルとキー構造を設計する場合
• キャッシング、セッション、またはリアルタイム機能を実装する場合
• Redis Query Engine (FT.CREATE、FT.SEARCH、FT.AGGREGATE) を使用する場合
• RedisVL でベクトル検索または RAG アプリケーションを構築する場合
• LangCache でセマンティックキャッシングを実装する場合
• Redis パフォーマンスとメモリ使用量を最適化する場合

ルールカテゴリ (優先度順)

優先度	カテゴリ	影響度	プレフィックス
1	データ構造とキー	HIGH	data-
2	メモリと期限切れ	HIGH	ram-
3	接続とパフォーマンス	HIGH	conn-
4	JSON ドキュメント	MEDIUM	json-
5	Redis Query Engine	HIGH	rqe-
6	ベクトル検索と RedisVL	HIGH	vector-
7	セマンティックキャッシング	MEDIUM	semantic-cache-
8	ストリームと Pub/Sub	MEDIUM	stream-
9	クラスタリングとレプリケーション	MEDIUM	cluster-
10	セキュリティ	HIGH	security-
11	可観測性	MEDIUM	observe-

クイックリファレンス

1. データ構造とキー (HIGH)

• data-choose-structure - 正しいデータ構造を選択する
• data-key-naming - 一貫したキー命名規則を使用する

2. メモリと期限切れ (HIGH)

• ram-limits - メモリ制限とエビクションポリシーを設定する
• ram-ttl - キャッシュキーに TTL を設定する

3. 接続とパフォーマンス (HIGH)

• conn-blocking - 本番環境で遅いコマンドを避ける
• conn-pipelining - バルク操作にパイプラインを使用する
• conn-pooling - 接続プーリングまたはマルチプレックスを使用する
• conn-timeouts - 接続タイムアウトを設定する

4. JSON ドキュメント (MEDIUM)

• json-partial-updates - 部分更新に JSON パスを使用する
• json-vs-hash - JSON とハッシュを適切に選択する

5. Redis Query Engine (HIGH)

• rqe-dialect - クエリ構文に DIALECT 2 を使用する
• rqe-field-types - 正しいフィールドタイプを選択する
• rqe-index-creation - クエリするフィールドのみをインデックスする
• rqe-index-management - ゼロダウンタイム更新用にインデックスを管理する
• rqe-query-optimization - 効率的なクエリを記述する

6. ベクトル検索と RedisVL (HIGH)

• vector-algorithm-choice - 要件に基づいて HNSW と FLAT を選択する
• vector-hybrid-search - より良い結果のためハイブリッド検索を使用する
• vector-index-creation - ベクトルインデックスを適切に設定する
• vector-rag-pattern - RAG パターンを正しく実装する

7. セマンティックキャッシング (MEDIUM)

• semantic-cache-best-practices - セマンティックキャッシュを適切に設定する
• semantic-cache-langcache-usage - LLM レスポンスキャッシング用に LangCache を使用する

8. ストリームと Pub/Sub (MEDIUM)

• stream-choosing-pattern - ストリームと Pub/Sub を適切に選択する

9. クラスタリングとレプリケーション (MEDIUM)

• cluster-hash-tags - マルチキー操作にハッシュタグを使用する
• cluster-read-replicas - 読み取り集約的なワークロード用に読み取りレプリカを使用する

10. セキュリティ (HIGH)

• security-acls - きめ細かいアクセス制御に ACL を使用する
• security-auth - 本番環境で常に認証を使用する
• security-network - ネットワークアクセスを保護する

11. 可観測性 (MEDIUM)

• observe-commands - デバッグ用に可観測性コマンドを使用する
• observe-metrics - 主要な Redis メトリクスを監視する

使用方法

個別のルールファイルを読んで、詳細な説明とコード例を参照してください:

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

各ルールファイルには以下が含まれます:

• それが重要である理由の簡潔な説明
• 説明付きの正しい例
• アンチパターンが実害を引き起こす場合は「不正な例」、またはオプション機能の場合は「使用する場合 / 不要な場合」のガイダンス
• 追加の文脈とリファレンス

完全なコンパイル文書

すべてのルールが展開された完全なガイド: AGENTS.md