{
  "id": "cache",
  "title": "cache",
  "url": "https://redis.io/docs/latest/integrate/redis-data-integration/reference/data-transformation/cache/",
  "summary": "Cache the result of an expression or lookup",
  "tags": [
    "docs",
    "integrate",
    "rs",
    "rdi"
  ],
  "last_updated": "2026-05-12T09:07:59-04:00",
  "page_type": "content",
  "content_hash": "3ce504a730d332cf356c9398663d32bc4624561a8839f8452445dc571c937986",
  "sections": [
    {
      "id": "content",
      "title": "Content",
      "role": "content",
      "text": "Cache the result of an expression or lookup. Caching avoids re-evaluating\nthe expression or re-querying Redis when the same input field values\nappear repeatedly. Cache keys are derived from the values of the input\nfields referenced by the expression, not from the full record.\n\nThe `cache:` block can be added to the following transformations and\noutput expressions:\n\n- The expression in [`add_field`](https://redis.io/docs/latest/integrate/redis-data-integration/reference/data-transformation/add_field) (single-field and per-item form).\n- The expression in [`filter`](https://redis.io/docs/latest/integrate/redis-data-integration/reference/data-transformation/filter).\n- The expression in [`map`](https://redis.io/docs/latest/integrate/redis-data-integration/reference/data-transformation/map).\n- The argument expressions in [`redis.lookup`](https://redis.io/docs/latest/integrate/redis-data-integration/reference/data-transformation/lookup). The same block accepts a `lookup_cache:` variant that caches the lookup result returned by Redis.\n- The dynamic `key` and `expire` expressions of the `redis.write` output.\n\n**Flink processor only.** The classic processor silently ignores `cache:` blocks.\n\n**Properties**\n\n| Name          | Type      | Description                                                       | Required | Default |\n| ------------- | --------- | ----------------------------------------------------------------- | -------- | ------- |\n| **enabled**   | `boolean` | Set to `true` to enable caching.                                  | no       | `false` |\n| **max_size**  | `integer` | Maximum number of entries kept in the cache. Must be positive.    | no       | `1000`  |\n| **ttl_seconds** | `integer` | Time-to-live for each entry, in seconds. Must be positive.      | no       | `60`    |\n\n**Additional Properties:** not allowed\n\n**Example**\n\n[code example]\n\nSee\n[Caching expression results](https://redis.io/docs/latest/integrate/redis-data-integration/data-pipelines/transform-examples/caching-expression-results)\nfor additional examples."
    }
  ],
  "examples": [
    {
      "id": "content-ex0",
      "language": "yaml",
      "code": "source:\n  schema: dbo\n  table: customer\ntransform:\n  - uses: add_field\n    with:\n      field: country\n      language: sql\n      expression: country_code || ' - ' || UPPER(country_name)\n      cache:\n        enabled: true\n        max_size: 500\n        ttl_seconds: 300",
      "section_id": "content"
    }
  ]
}