Django Scylla - the Cassandra & ScyllaDB backend for Django

Django-scylla makes possible to connect your Django app to Cassandra or ScyllaDB and use native Django ORM as with any other relational database backend.

Discord: https://discord.gg/pxunMGmDNc

Sponsors

Help support ongoing development and maintenance by sponsoring Django Scylla.

Installation

Recommended installation:

pip install django-scylla

Basic Usage

1. Add django_scylla to INSTALLED_APPS in your settings.py file:

    INSTALLED_APPS = ('django_scylla',) + INSTALLED_APPS
   

2. Change DATABASES setting:

    DATABASES = {
        'default': {
            'ENGINE': 'django_scylla',
            'NAME': 'db',
            'TEST_NAME': 'test_db',
            'HOST': 'db1.example.com,db2.example.com,db3.example.com',
            'OPTIONS': {
                'consistency_level': ...,
                'load_balancing_policy': ...,
                'retry_policy': ...,
                'request_timeout': 10,
   
            }
        }
    }
   

3. Define some model:

    # myapp/models.py
   
    from django.db import models
   
   
    class Person(models.Model):
        first_name = models.CharField(max_length=30)
        last_name = models.CharField(max_length=30)
   

4. Connect to ScyllaDB and create a keyspace.

5. Run ./manage.py makemigrations && ./manage.py migrate

6. Done!

License

Copyright (c) 2021-2022, Rafał Furmański.

All rights reserved. Licensed under MIT License.