{
  "id": "redis/redisearch-index-out-of-memory",
  "signature": "ERR FT.CREATE failed: Out of memory allocating index 'myidx'",
  "signature_zh": "FT.CREATE 失败：为索引 'myidx' 分配内存时内存不足",
  "regex": "ERR FT\\.CREATE failed: Out of memory allocating index '.*'",
  "domain": "redis",
  "category": "resource_error",
  "subcategory": null,
  "root_cause": "Redis Search module failed to allocate memory for new index due to maxmemory limit or system OOM.",
  "root_cause_type": "generic",
  "root_cause_zh": "Redis Search 模块因 maxmemory 限制或系统内存不足，无法为新索引分配内存。",
  "versions": [
    {
      "version": "7.2.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "7.4.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "8.0.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "",
      "why_fails": "Setting maxmemory-policy to noeviction prevents eviction but also blocks new writes including index creation; it doesn't free memory.",
      "fail_rate": 0.7,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "Deleting the index key with DEL may not free memory immediately if the index is still referenced by internal structures; use FT.DROPINDEX instead.",
      "fail_rate": 0.6,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Increase maxmemory: CONFIG SET maxmemory 2gb. Then retry FT.CREATE. Monitor with INFO memory.",
      "success_rate": 0.8,
      "how": "Increase maxmemory: CONFIG SET maxmemory 2gb. Then retry FT.CREATE. Monitor with INFO memory.",
      "condition": "",
      "sources": []
    },
    {
      "action": "Drop unused indexes to free memory: FT.DROPINDEX oldidx DD (DD deletes documents). Then retry.",
      "success_rate": 0.75,
      "how": "Drop unused indexes to free memory: FT.DROPINDEX oldidx DD (DD deletes documents). Then retry.",
      "condition": "",
      "sources": []
    },
    {
      "action": "Reduce index memory overhead by using fewer fields or smaller text fields in FT.CREATE (e.g., WITHSUFFIXTRIE off).",
      "success_rate": 0.7,
      "how": "Reduce index memory overhead by using fewer fields or smaller text fields in FT.CREATE (e.g., WITHSUFFIXTRIE off).",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "增加 maxmemory：CONFIG SET maxmemory 2gb。然后重试 FT.CREATE。使用 INFO memory 监控。",
    "删除未使用的索引以释放内存：FT.DROPINDEX oldidx DD（DD 删除文档）。然后重试。",
    "通过在 FT.CREATE 中使用更少的字段或更小的文本字段来减少索引内存开销（例如，关闭 WITHSUFFIXTRIE）。"
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://redis.io/docs/stack/search/",
  "official_doc_section": null,
  "error_code": "ERR",
  "verification_tier": "ai_generated",
  "confidence": 0.82,
  "fix_success_rate": 0.78,
  "resolvable": "partial",
  "first_seen": "2024-05-20",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}