Commit bfb7881f authored by Jason Madden's avatar Jason Madden Committed by GitHub

Update RelStorage information in multi-zodb-gc document

RelStorage 2.0 can and should use zc.zodbdgc for reference collecting and packing in a multi-db, so long as its history free.
parent 2490ae09
...@@ -11,15 +11,24 @@ database of all persistent references. ...@@ -11,15 +11,24 @@ database of all persistent references.
The second feature allows us to debug and repair PosKeyErrors by finding the The second feature allows us to debug and repair PosKeyErrors by finding the
persistent object(s) that point to the lost object. persistent object(s) that point to the lost object.
Note: This documentation applies to ZODB 3.9 and later. Earlier versions of the .. note::
ZODB are not supported, as they lack the fast storage iteration API's required This documentation applies to ZODB 3.9 and later. Earlier versions of the
by `zc.zodbdgc`. ZODB are not supported, as they lack the fast storage iteration API's required
by ``zc.zodbdgc``.
This documentation does not apply to
`RelStorage <http://pypi.python.org/pypi/RelStorage>`_ which has the same .. note::
features built-in, but accessible in different ways. Look at the options for Unless you're using multi-databases, this documentation does not apply to
the `zodbpack` script. The `--prepack` option creates a table containing the `RelStorage <http://pypi.python.org/pypi/RelStorage>`_ which has the same
same information as we are creating in the reference database. features built-in, but accessible in different ways. Look at the options for
the ``zodbpack`` script. The ``--prepack`` option creates a table containing the
same information as we are creating in the reference database.
If you *are* using multi-databases, be aware that RelStorage 2.0 is needed to
perform packing and garbage collection with ``zc.zodbdgc``, and those features only
work in history-free databases.
It's important to realize that there is currently no way to perform garbage collection
in a history-preserving multi-database RelStorage.
Setup Setup
----- -----
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment