Skip to main content

Redis Sharding API

Project description

Redis Shard

A redis sharding api. Sharding is done based on the CRC32 checksum of a key or key tag (“key{key_tag}”), according to this article http://antirez.com/post/redis-presharding.html .

The source code is locate at github .

Useage

Creating a hash ring with multiple servers,By default the hash ring uses a crc32 hashing algorithm on the server’s name config.You can define the name anything as you like,but it must be unique.

I don’t want to bind the hashring with ipaddress,because if I do some master/slave switches, I can only change the ipaddress related config. The name is kept,so the hashring’s order is kept.

>>> from redis_shard.shard import RedisShardAPI
>>> servers = [
    ...    {'name':'server1','host':'127.0.0.1','port':10000,'db':0},
    ...    {'name':'server2','host':'127.0.0.1','port':11000,'db':0},
    ...    {'name':'server3','host':'127.0.0.1','port':12000,'db':0},
    ...    {'name':'127.0.0.1:13000','host':'127.0.0.1','port':13000,'db':0},
    ...    ]
>>>
>>> client = RedisShardAPI(servers)
>>> client.set('test',1)
>>> print client.get('test')
>>> client.zadd('testset','first',1)
>>> client.zadd('testset','second',2)
>>> print client.zrange('testset',0,-1)

Hash tags

see article http://antirez.com/post/redis-presharding.html for detail.

>>> client.set('foo',2)
>>> client.set('a{foo}',5)
>>> client.set('b{foo}',5)
>>> client.set('{foo}d',5)
>>> client.set('d{foo}e',5)
>>> print client.get_server_name('foo') == client.get_server_name('a{foo}') == client.get_server_name('{foo}d') \
... == client.get_server_name('d{foo}e')

I also added an tag_keys method,which is more quickly than default keys method,because it only look one machine.

>>> client.tag_keys('*{foo}*') == client.keys('*{foo}*')

Change History

0.1.5 (2012-07-16)

Add many new methods, support socket_timeout and password

0.1.4 (2011-07-20)

modify hash key algor,support suffix match,thks to dkong support more redis methods,include keys.

0.1.3 (2011-06-20)

support 2.4.X version of redis-py

0.1.2 (2011-06-01)

add MANIFEST.in file

0.1.1 (2011-05-29)

create hashring use server’s name config.

0.1 (2011-05-28)

first version

Project details


Release history Release notifications

History Node

0.3.5

History Node

0.3.4

History Node

0.3.3

History Node

0.3.2

History Node

0.3.0

History Node

0.2.5

History Node

0.2.4

History Node

0.2.0

History Node

0.1.11

History Node

0.1.10

History Node

0.1.9

History Node

0.1.8

History Node

0.1.7

This version
History Node

0.1.5

History Node

0.1.4

History Node

0.1.3

History Node

0.1.2

History Node

0.1.1

History Node

0.1

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
redis_shard-0.1.5-py2.6.egg (10.5 kB) Copy SHA256 hash SHA256 Egg 2.6 Jul 16, 2012
redis-shard-0.1.5.tar.gz (5.2 kB) Copy SHA256 hash SHA256 Source None Jul 16, 2012

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page