Skip to main content

Django Scylla

Project description

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.

Latest version workflow

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.

Project details


Download files

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

Source Distribution

django_scylla-0.0.10.tar.gz (16.8 kB view hashes)

Uploaded source

Built Distribution

django_scylla-0.0.10-py3-none-any.whl (20.6 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page