https://github.com/kennethreitz/django-postgrespool

Postgres Connection Pooling for Django, powered by SQLAlchemy.
https://github.com/kennethreitz/django-postgrespool

Last synced: 16 days ago
JSON representation

Postgres Connection Pooling for Django, powered by SQLAlchemy.

• Host: GitHub
• URL: https://github.com/kennethreitz/django-postgrespool
• Owner: kennethreitz
• License: mit
• Fork: true (heroku-python/django-postgrespool)
• Created: 2021-01-01T17:09:18.000Z (almost 4 years ago)
• Default Branch: master
• Last Pushed: 2022-08-06T03:10:34.000Z (over 2 years ago)
• Last Synced: 2024-09-20T01:07:12.813Z (about 2 months ago)
• Homepage: https://pypi.python.org/pypi/django-postgrespool
• Size: 29.3 KB
• Stars: 6
• Watchers: 2
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
Django-PostgresPool

===================

This is a simple Postgres Connection Pooling backend for Django 1.4+, powered by the lovely and beautiful SQLAlchemy.

Usage

-----

Using Django-PostgresPool is simple, just set ``django_postgrespool`` as your connection engine:

::

    DATABASES = {

        'default': {

            'ENGINE': 'django_postgrespool'

If you're using the `dj-database-url `_ module:

::

    import dj_database_url

    DATABASES = {'default': dj_database_url.config(engine='django_postgrespool')}

If you're using `south `_:

::

    SOUTH_DATABASE_ADAPTERS = {

        'default': 'south.db.postgresql_psycopg2'

    }

Everything should work as expected.

Installation

------------

Installing Django-PostgresPool is simple, with pip::

    $ pip install django-postgrespool

Configuration

-------------

Optionally, you can provide additional options to pass to SQLAlchemy's pool creation::

    DATABASE_POOL_ARGS = {

        'max_overflow': 10,

        'pool_size': 5,

        'recycle': 300

    }

Here's a basic explanation of two of these options:

* **pool_size** – The *minimum* number of connections to maintain in the pool.

* **max_overflow** – The maximum *overflow* size of the pool. This is not the maximum size of the pool.

The total number of "sleeping" connections the pool will allow is ``pool_size``.

The total simultaneous connections the pool will allow is ``pool_size + max_overflow``.

As an example, databases in the `Heroku Postgres `_ starter tier have a maximum connection limit of 20. In that case your ``pool_size`` and ``max_overflow``, when combined, should not exceed 20.

Check out the official `SQLAlchemy Connection Pooling `_ docs to learn more about the optoins that can be defined in ``DATABASE_POOL_ARGS``.

Django 1.3 Support

------------------

django-postgrespool currently supports Django 1.4 and greater. See `this ticket `_ for 1.3 support.