Skip to main content
Help us improve Python packaging – donate today!

A backend for ZODB that stores pickles in a relational database.

Project Description

RelStorage is a storage implementation for ZODB that stores pickles in a relational database. PostgreSQL 9.0 and above (performance is best with 9.5 and above), MySQL 5.0.32+ / 5.1.34+, and Oracle 10g and 11g are currently supported. RelStorage replaced the PGStorage project.

Features

  • It is a drop-in replacement for FileStorage and ZEO.
  • There is a simple way to convert FileStorage to RelStorage and back again. You can also convert a RelStorage instance to a different relational database.
  • Designed for high volume sites: multiple ZODB instances can share the same database. This is similar to ZEO, but RelStorage does not require ZEO.
  • According to some tests, RelStorage handles high concurrency better than the standard combination of ZEO and FileStorage.
  • Whereas FileStorage takes longer to start as the database grows due to an in-memory index of all objects, RelStorage starts quickly regardless of database size.
  • Supports undo, packing, and filesystem-based ZODB blobs.
  • Both history-preserving and history-free storage are available.
  • Capable of failover to replicated SQL databases.
  • zodbconvert utility to copy databases.
  • Free, open source (ZPL 2.1)

Documentation

Documentation including installation instructions is hosted on readthedocs.

The complete changelog is also there.

https://readthedocs.org/projects/relstorage/badge/?version=latest

Development

RelStorage is hosted at GitHub:

https://github.com/zodb/relstorage

Continuous integration

A test suite is run for every push and pull request submitted. Travis CI is used to test on Linux, and AppVeyor runs the builds on Windows.

https://travis-ci.org/zodb/relstorage.svg?branch=master https://ci.appveyor.com/api/projects/status/pccddlgujdoqvl83?svg=true

Builds on Travis CI automatically submit updates to coveralls.io to monitor test coverage.

https://coveralls.io/repos/zodb/relstorage/badge.svg?branch=master&service=github

Likewise, builds on Travis CI will automatically submit updates to landscape.io to monitor code health (adherence to PEP8, absence of common code smells, etc).

Code Health

Release history Release notifications

This version
History Node

2.1.0

History Node

2.1a2

History Node

2.1a1

History Node

2.0.0

History Node

2.0.0rc1

History Node

2.0.0b9

History Node

2.0.0b8

History Node

2.0.0b7

History Node

2.0.0b6

History Node

2.0.0b5

History Node

2.0.0b4

History Node

2.0.0b3

History Node

2.0.0b2

History Node

2.0.0b1

History Node

1.6.3

History Node

1.6.2

History Node

1.6.1

History Node

1.6.0

History Node

1.6.0b3

History Node

1.6.0b2

History Node

1.6.0b1

History Node

1.5.1

History Node

1.5.0

History Node

1.5.0b2

History Node

1.5.0b1

History Node

1.5.0a1

History Node

1.4.2

History Node

1.4.1

History Node

1.4.0

History Node

1.4.0c4

History Node

1.4.0c3

History Node

1.4.0c2

History Node

1.4.0c1

History Node

1.4.0b3

History Node

1.4.0b2

History Node

1.4.0b1

History Node

1.3.0b1

History Node

1.2.0

History Node

1.2.0b2

History Node

1.1.3

History Node

1.1.2

History Node

1.1.1

History Node

1.1

History Node

1.1c1

History Node

1.1b2

History Node

1.1b1

History Node

1.0.1

History Node

1.0

History Node

1.0c1

History Node

1.0-beta1

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
RelStorage-2.1.0-cp27-cp27m-macosx_10_6_intel.whl (286.2 kB) Copy SHA256 hash SHA256 Wheel cp27 Feb 7, 2018
RelStorage-2.1.0-cp27-cp27m-manylinux1_x86_64.whl (298.4 kB) Copy SHA256 hash SHA256 Wheel cp27 Feb 7, 2018
RelStorage-2.1.0-cp27-cp27mu-manylinux1_x86_64.whl (298.4 kB) Copy SHA256 hash SHA256 Wheel cp27 Feb 7, 2018
RelStorage-2.1.0-cp27-cp27m-win32.whl (280.5 kB) Copy SHA256 hash SHA256 Wheel cp27 Feb 7, 2018
RelStorage-2.1.0-cp27-cp27m-win_amd64.whl (281.3 kB) Copy SHA256 hash SHA256 Wheel cp27 Feb 7, 2018
RelStorage-2.1.0-cp34-cp34m-macosx_10_6_intel.whl (286.3 kB) Copy SHA256 hash SHA256 Wheel cp34 Feb 7, 2018
RelStorage-2.1.0-cp34-cp34m-manylinux1_x86_64.whl (295.6 kB) Copy SHA256 hash SHA256 Wheel cp34 Feb 7, 2018
RelStorage-2.1.0-cp34-cp34m-win32.whl (280.5 kB) Copy SHA256 hash SHA256 Wheel cp34 Feb 7, 2018
RelStorage-2.1.0-cp34-cp34m-win_amd64.whl (281.3 kB) Copy SHA256 hash SHA256 Wheel cp34 Feb 7, 2018
RelStorage-2.1.0-cp35-cp35m-macosx_10_6_intel.whl (286.3 kB) Copy SHA256 hash SHA256 Wheel cp35 Feb 7, 2018
RelStorage-2.1.0-cp35-cp35m-manylinux1_x86_64.whl (295.6 kB) Copy SHA256 hash SHA256 Wheel cp35 Feb 7, 2018
RelStorage-2.1.0-cp35-cp35m-win32.whl (282.0 kB) Copy SHA256 hash SHA256 Wheel cp35 Feb 7, 2018
RelStorage-2.1.0-cp35-cp35m-win_amd64.whl (283.4 kB) Copy SHA256 hash SHA256 Wheel cp35 Feb 7, 2018
RelStorage-2.1.0-cp36-cp36m-macosx_10_6_intel.whl (286.3 kB) Copy SHA256 hash SHA256 Wheel cp36 Feb 7, 2018
RelStorage-2.1.0-cp36-cp36m-manylinux1_x86_64.whl (295.6 kB) Copy SHA256 hash SHA256 Wheel cp36 Feb 7, 2018
RelStorage-2.1.0-cp36-cp36m-win32.whl (282.0 kB) Copy SHA256 hash SHA256 Wheel cp36 Feb 7, 2018
RelStorage-2.1.0-cp36-cp36m-win_amd64.whl (283.4 kB) Copy SHA256 hash SHA256 Wheel cp36 Feb 7, 2018
RelStorage-2.1.0-cp37-cp37m-macosx_10_9_x86_64.whl (280.4 kB) Copy SHA256 hash SHA256 Wheel cp37 Feb 7, 2018
RelStorage-2.1.0-pp2510-pypy_41-macosx_10_13_x86_64.whl (277.4 kB) Copy SHA256 hash SHA256 Wheel pp2510 Feb 7, 2018
RelStorage-2.1.0.tar.gz (568.0 kB) Copy SHA256 hash SHA256 Source None Feb 7, 2018

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