This guide will show you how to move your existing application in Django to use Cloud Spanner as the database.

Whether you have: a) an existing application and need to use Cloud Spanner as the fresh database (no migration of database from old database) b) an existing application and need to move previous data from your database to Cloud Spanner c) a fresh app being built from the ground, up

essentially you’ll need to always have configured these 4 steps

• Enable Cloud Spanner API and Credentials
• Install spanner.django
• Migrating from other databases
• Edit settings.py to configure your database

1. Enable Cloud Spanner API and Credentials in Google Cloud Console

Please visit Cloud Spanner setup and then extract your Google Cloud Application Credentials.

2. Install spanner.django

Please follow the steps in install

3. Migrating from other databases

4. Edit your Django settings.py to configure your database

The DATABASES section in your settings.py file will need to be edited to

DATABASES = {
    'default': {
        'ENGINE': 'spanner.django',
        'PROJECT': 'sandbox',
        'INSTANCE': 'dev2',
        'NAME': 'db1',
    },
}