Skip to main content

Django redis backend

Project description

Goal

Provide Redis backends for Django that faciliates using multiple Redis servers in the same time like if they were in master/master or sharded configuration.

Installation

Install requirements:

pip install redis hash_ring

Install Kido Redis:

pip install django-kidoredis

or current development version:

pip install hg+https:://bitbucket.org/kidosoft/django-kidoredis

Configuration

CACHES = {
    'redis_ring': {
        'BACKEND': 'kidoredis.backends.RedisRing',  # sharding backend
        'DB': 0,
        'LOCATION': [
            'localhost:6379',
            'localhost:6380',
        ]
    },
    'redis_copy': {
        'BACKEND': 'kidoredis.backends.RedisCopy',  # copying backend
        'DB': 0,
        'LOCATION': [
            'localhost:6379',
            'localhost:6380',
        ]
    }
}

Redis is configured as cache backend although it should be treat as specialized database. There are two backends:

Usage

After configuration access to Redis is done like to any other Django cache:

from django.core.cache import caches
caches['redis_ring'].set('key1', 1)  # set key1 only on on server
caches['redis_copy'].set('key2', 2)  # set key2 on all servers
result_list = caches['redis_copy'].zrange('key3', 1, 10)  # redis only command

Caveats

RedisCopy can save data to many nodes. Each of this nodes can return different result on save. For that reason commands that save data to nodes returns list of results from each node. E.g. with two nodes set for redis_copy:

>>> print caches['redis_copy'].set('key1', 2)
[True, True]

Supported Django versions

Tested with:

  • Django 1.2.7 on python2.7

  • Django 1.3.7 on python2.7

  • Django 1.4.16 on python2.7

  • Django 1.5.11 on python2.7, python3.4

  • Django 1.6.8 on python2.7, python3.4

  • Django 1.7.1 on python2.7, python3.4

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-kidoredis-1.0.1.tar.gz (56.3 kB view details)

Uploaded Source

File details

Details for the file django-kidoredis-1.0.1.tar.gz.

File metadata

File hashes

Hashes for django-kidoredis-1.0.1.tar.gz
Algorithm Hash digest
SHA256 706d8ad0d142f14a8d343eec27be54e0d18c7814118ca74ebbe0f847ebdbb3cc
MD5 34a56a6d3584e20a97621defd3506a94
BLAKE2b-256 5d5bb7b308bc3894fd5c17f3feb4eb5c401aa996cb12594ddd3fe4f1424694ef

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page