DocsPricingBlog
Contact Us
Log inSign up for FREE
Back to Tech Articles

DjangoとFastAPIでRedisを活用したきめ細やかなキャッシングの実装

Aug 19, 2025
# Misc

Ethan Miller

Product Engineer · Leapcell

This post is also available in English, 한국어, and Deutsch
Cover of "DjangoとFastAPIでRedisを活用したきめ細やかなキャッシングの実装"

はじめに：パフォーマンスのための必須要件

ウェブ開発のペースが速い現代において、アプリケーションのパフォーマンスは単なる機能ではなく、基本的な期待値です。ユーザーは即時の応答を求め、読み込み時間が遅いと、すぐに離脱やユーザーエクスペリエンスの低下につながる可能性があります。アプリケーションがスケールし、データ量が増加するにつれて、ボトルネックはしばしばデータベース層や広範な計算中に現れます。ここで、キャッシングは重要な最適化手法として登場します。頻繁にアクセスされるデータを高速な一時ストレージ層に保存することで、プライマリデータソースへの負荷を大幅に削減し、コンテンツ配信を高速化できます。この記事では、DjangoやFastAPIのような人気のPythonウェブフレームワーク内で、Redisという強力なインメモリデータストアを活用して、高度できめ細やかなキャッシング戦略を実装し、最終的にアプリケーションの応答性とスケーラビリティを向上させる方法を探ります。

キャッシングの根幹を理解する

実装の詳細に入る前に、キャッシングとRedisに関連するいくつかのコアコンセプトを把握することが重要です。

Redis: その核心において、Redis（Remote Dictionary Server）は、データベース、キャッシュ、メッセージブローカーとして使用されるオープンソースのインメモリデータ構造ストアです。そのキー・バリュー・ストアの性質と、さまざまなデータ構造（文字列、ハッシュ、リスト、セット、ソート済みセット）のサポートは、キャッシングにおいて信じられないほど汎用的になります。インメモリの性質により、従来のディスクベースのデータベースよりも大幅に高速な、非常に低遅延のアクセスが可能になります。

キャッシング戦略: これは、データがキャッシュに保存、取得、無効化される方法を指します。一般的な戦略には次のようなものがあります。

  • Cache-aside: アプリケーションは最初にキャッシュをチェックします。データが存在する場合（「キャッシュヒット」）、直接返されます。存在しない場合（「キャッシュミス」）、アプリケーションはプライマリソースからデータを取得し、キャッシュに保存してから返します。
  • Write-through: データはキャッシュとプライマリデータストアに同時に書き込まれます。
  • Write-back: データはキャッシュに書き込まれ、プライマリデータストアへの書き込みは遅延され、しばしば非同期で発生します。
  • Time-to-Live (TTL): 指定された期間後にキャッシュアイテムが自動的に期限切れになるメカニズムであり、データの鮮度を保証します。
  • キャッシュ無効化: キャッシュから古くなったデータや無効なデータを削除するプロセスです。特に分散システムでは、正しく実装するのが難しい場合があります。

きめ細やかなキャッシング: entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages entire pages. For example, instead of caching an entire user profile, you might cache individual attributes like the user's name, email, or a list of their posts, invalidating only the changed part.

Django and FastAPI integration and fine-grained caching implementation

Let's illustrate how to integrate Redis and implement granular caching in both Django and FastAPI.

Setting up Redis

First, ensure you have a running Redis instance. You can run it locally using Docker:

docker run --name my-redis -p 6379:6379 -d redis/redis-stack-server

You'll also need a Python Redis client. redis-py is the most popular choice:

pip install redis

Django: Leveraging the Cache Framework

Django provides a powerful caching framework that can be configured to use various backends, including Redis.

1. Configuration in settings.py:

# settings.py

CACHES = {
    "default": {
        "BACKEND": "django_redis.cache.RedisCache",
        "LOCATION": "redis://127.0.0.1:6379/1", # Using database 1 for caching
        "OPTIONS": {
            "CLIENT_CLASS": "redis_py_cluster.cluster.RedisCluster" # If using Redis Cluster
            # "CONNECTION_POOL_CLASS": "redis.BlockingConnectionPool", # Or a regular connection pool
        },
        "KEY_PREFIX": "my_app_cache", # Optional: namespace your cache keys
        "TIMEOUT": 300, # Default timeout for cached items (5 minutes)
    }
}

You'll also need to install django-redis:

pip install django-redis

2. Basic View-Level Caching (less granular):

Django provides decorators for caching entire views:

# myapp/views.py
from django.views.decorators.cache import cache_page

@cache_page(60 * 15) # Cache for 15 minutes
def my_cached_view(request):
    # This view's output will be cached
    return HttpResponse("This content is cached!")

3. Granular Caching for Model Data:

For fine-grained control, we'll interact directly with the cache API. Consider a scenario where you want to cache individual product details.

# myapp/models.py
from django.db import models

class Product(models.Model):
    name = models.CharField(max_length=255)
    description = models.TextField()
    price = models.DecimalField(max_digits=10, decimal_places=2)
    updated_at = models.DateTimeField(auto_now=True)

    def __str__(self):
        return self.name

# myapp/services.py (or utils.py)
from django.core.cache import cache
from .models import Product

def get_product_details(product_id: int):
    cache_key = f"product:{product_id}"
    product_data = cache.get(cache_key)

    if product_data is None:
        try:
            product = Product.objects.get(id=product_id)
            product_data = {
                "id": product.id,
                "name": product.name,
                "description": product.description,
                "price": str(product.price), # Decimal objects are not directly JSON-serializable
                "updated_at": product.updated_at.isoformat(),
            }
            # Cache for 60 seconds. You can override the default in settings.
            cache.set(cache_key, product_data, timeout=60)
            print(f"Cache miss for product {product_id}, fetched from DB.")
        except Product.DoesNotExist:
            return None
    else:
        print(f"Cache hit for product {product_id}.")
    return product_data

def invalidate_product_cache(product_id: int):
    cache_key = f"product:{product_id}"
    cache.delete(cache_key)
    print(f"Invalidated cache for product {product_id}.")

# myapp/views.py
from django.http import JsonResponse
from .services import get_product_details, invalidate_product_cache

def product_detail_view(request, product_id: int):
    product = get_product_details(product_id)
    if product:
        return JsonResponse(product)
    return JsonResponse({"error": "Product not found"}, status=404)

def update_product_view(request, product_id: int):
    # Logic to update product in DB
    # ...
    # After updating, invalidate its cache
    invalidate_product_cache(product_id)
    return JsonResponse({"message": "Product updated and cache invalidated."})

This example demonstrates how to:

  • Construct unique cache keys for individual products.
  • Implement a cache-aside strategy manually.
  • Set a specific timeout (TTL) for cached items.
  • Manually invalidate the cache when the underlying data changes, ensuring data consistency.

FastAPI: Direct Redis Integration and Dependency Injection

FastAPI, being a modern, asynchronous framework, often benefits from direct integration with Redis using redis-py leveraging asyncio.

1. Redis Client Setup:

# app/dependencies.py
import redis.asyncio as redis
from typing import AsyncGenerator

# Use database 0 for general caching, 1 for specific data, etc.
REDIS_URL = "redis://localhost:6379/0"

async def get_redis_client() -> AsyncGenerator[redis.Redis, None]:
    client = redis.from_url(REDIS_URL)
    try:
        yield client
    finally:
        await client.close()

2. Granular Caching with Dependency Injection:

Let's imagine an API endpoint to retrieve user data. We can cache individual user profiles.

# app/main.py
from fastapi import FastAPI, Depends, HTTPException
import redis.asyncio as redis
import json
from datetime import datetime
import asyncio

from pydantic import BaseModel, Field

from .dependencies import get_redis_client
# from .models import User  # Assume a Pydantic model for User
# from .database import get_user_from_db, update_user_in_db # Assume functions for DB interaction

app = FastAPI()

# Simulate a database User model
class User(BaseModel):
    id: int
    name: str
    email: str
    created_at: datetime
    updated_at: datetime = Field(default_factory=datetime.now)

# Simulated Database Functions (replace with actual ORM/ODM calls)
async def get_user_from_db(user_id: int) -> User | None:
    # In a real app, this would be an async DB query
    print(f"Fetching user {user_id} from DB...")
    await asyncio.sleep(0.1) # Simulate DB latency
    if user_id == 1:
        return User(id=1, name="Alice", email="alice@example.com", created_at=datetime.now())
    if user_id == 2:
        return User(id=2, name="Bob", email="bob@example.com", created_at=datetime.now())
    return None

async def update_user_in_db(user_id: int, new_data: dict) -> User | None:
    print(f"Updating user {user_id} in DB with {new_data}...")
    await asyncio.sleep(0.1)
    if user_id == 1:
        # Simulate fetching existing, updating, and returning
        existing_user_data = {"id":1, "name":"Alice", "email":"alice@example.com", "created_at":datetime.now().isoformat()}
        current_data = {**existing_user_data, **new_data, "updated_at": datetime.now().isoformat()}
        return User(**current_data)
    return None


# API Endpoint for getting user details
@app.get("/users/{user_id}", response_model=User)
async def read_user(user_id: int, redis_client: redis.Redis = Depends(get_redis_client)):
    cache_key = f"user:{user_id}"
    cached_data = await redis_client.get(cache_key)

    if cached_data:
        print(f"Cache hit for user {user_id}.")
        return User.model_validate_json(cached_data) # Pydantic v2
        # return User.parse_raw(cached_data) # Pydantic v1
    
    print(f"Cache miss for user {user_id}, fetching from DB.")
    user = await get_user_from_db(user_id)
    if not user:
        raise HTTPException(status_code=404, detail="User not found")

    # Cache the user data with a TTL (e.g., 5 minutes)
    await redis_client.set(cache_key, user.model_dump_json(), ex=300) # Pydantic v2
    # await redis_client.set(cache_key, user.json(), ex=300) # Pydantic v1
    return user

# API Endpoint for updating user data and invalidating cache
@app.put("/users/{user_id}", response_model=User)
async def update_user(user_id: int, new_data: dict, redis_client: redis.Redis = Depends(get_redis_client)):
    # Update user in the database
    updated_user = await update_user_in_db(user_id, new_data)
    if not updated_user:
        raise HTTPException(status_code=404, detail="User not found")

    # Invalidate the cache for this specific user
    cache_key = f"user:{user_id}"
    await redis_client.delete(cache_key)
    print(f"Invalidated cache for user {user_id}.")

    # Optionally, re-cache the updated user data
    await redis_client.set(cache_key, updated_user.model_dump_json(), ex=300)
    
    return updated_user

In the FastAPI example:

  • We use redis.asyncio for non-blocking Redis operations.
  • get_redis_client is an async dependency that provides a Redis client, ensuring proper connection management.
  • Cache keys are constructed for individual users (user:{user_id}).
  • Data is stored and retrieved as JSON strings using Pydantic's model_dump_json() (or json() for Pydantic v1).
  • ex=300 sets the TTL for 300 seconds (5 minutes).
  • Cache invalidation is explicit via redis_client.delete(cache_key) after a data update.

Advanced Caching Strategies and Considerations

  • Cache Warming: Pre-filling the cache with frequently accessed data during application startup or off-peak hours to ensure initial user requests hit the cache.
  • Cache Tags/Groups for Mass Invalidation: When many related items need to be invalidated simultaneously (e.g., all products in a category), you can use Redis Sets to group related cache keys. When the category changes, iterate through the set to delete all associated product keys.
  • Distributed Caching: When running multiple instances of your application, Redis naturally acts as a shared, centralized cache, ensuring consistency across all instances.
  • Race Conditions: Be mindful of race conditions during cache updates/invalidations, especially in high-concurrency environments. Solutions like optimistic locking or distributed locks (Redis provides SET NX PX for this) can help.
  • Serialization: Choose efficient serialization formats (JSON, MessagePack, Protobuf) for storing complex objects in Redis. Pydantic's json() or model_dump_json() methods are excellent for FastAPI.
  • Monitoring: Monitor your Redis instance (hit rates, memory usage, latency) to ensure it's performing optimally and to identify potential issues.

Conclusion: Unleashing Performance with Smart Caching

Integrating Redis for fine-grained caching in Django and FastAPI is a powerful strategy for improving application performance and scalability. By understanding the core principles of caching and leveraging the strengths of Redis, developers can significantly reduce database load, enhance response times, and deliver a superior user experience. From simple view caching to intricate data-level control and explicit invalidation, the techniques discussed provide a robust foundation for building high-performance web applications that efficiently manage and deliver content. Smart caching is not just an optimization; it's a critical component of resilient and scalable architecture.

Share this article

HackerNews

More Posts from Leapcell

Popular Posts