Database configuration in Django - Mini Project: Build & Apply

Database configuration

📖 Scenario: You are creating a new Django project for a blog website. You need to set up the database connection so Django can store and retrieve blog posts.

🎯 Goal: Configure the Django project to use a PostgreSQL database with the correct settings in settings.py.

📋 What You'll Learn

Create a dictionary named DATABASES in settings.py with the default database configuration.

Add the PostgreSQL engine setting as 'django.db.backends.postgresql'.

Set the database name to 'blogdb'.

Set the user to 'bloguser'.

Set the password to 'securepass'.

Set the host to 'localhost'.

Set the port to '5432'.

💡 Why This Matters

🌍 Real World

Most Django projects need a database to store data like users, posts, and comments. Configuring the database connection is the first step to making your app work.

💼 Career

Knowing how to configure databases in Django is essential for backend developers working on web applications that require data persistence.

1

Create the initial DATABASES dictionary

In settings.py, create a dictionary called DATABASES with a key 'default' that is an empty dictionary.

Django

# Your code here

Hint

Use a dictionary named DATABASES with a key 'default' set to an empty dictionary.

2

Add the PostgreSQL engine setting

Inside the 'default' dictionary in DATABASES, add the key 'ENGINE' with the value 'django.db.backends.postgresql'.

Django

DATABASES = {
    'default': {
        # Add the ENGINE setting here
    }
}

Hint

Set 'ENGINE' inside 'default' to 'django.db.backends.postgresql'.

3

Add database connection details

Add the following keys inside the 'default' dictionary in DATABASES: 'NAME' with value 'blogdb', 'USER' with value 'bloguser', 'PASSWORD' with value 'securepass', 'HOST' with value 'localhost', and 'PORT' with value '5432'.

Django

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        # Add NAME, USER, PASSWORD, HOST, and PORT here
    }
}

Hint

Add all the required connection details as keys inside the 'default' dictionary.

4

Complete the database configuration

Ensure the DATABASES dictionary in settings.py is fully configured with all keys and values as specified, ready for Django to connect to the PostgreSQL database.

Django

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'blogdb',
        'USER': 'bloguser',
        'PASSWORD': 'securepass',
        'HOST': 'localhost',
        'PORT': '5432'
    }
}
# Configuration complete

Hint

Double-check all keys and values are present and correctly spelled.

Practice

1. What is the purpose of the ENGINE setting in Django's database configuration?

easy

A. To define the path to the database file

B. To set the username for the database connection

C. To specify the type of database Django should use

D. To configure the database password

Solution

1. Step 1: Understand the role of ENGINE

   The ENGINE setting tells Django which database backend to use, like SQLite, PostgreSQL, or MySQL.

2. Step 2: Differentiate from other settings

   Settings like NAME, USER, and PASSWORD handle connection details, not the database type.

3. Final Answer:

   To specify the type of database Django should use -> Option C

4. Quick Check:

   ENGINE = database type [OK]

Hint: ENGINE always means database type, not credentials [OK]

Common Mistakes:

• Confusing ENGINE with NAME or USER
• Thinking ENGINE sets username or password
• Assuming ENGINE is a file path

2. Which of the following is the correct way to configure a SQLite database in Django's settings.py?

easy

A. """DATABASES = { 'default': { 'ENGINE': 'django.db.backends.mysql', 'NAME': 'mydb' } }"""

B. """DATABASES = { 'default': { 'ENGINE': 'django.db.backends.postgresql', 'NAME': 'mydb' } }"""

C. """DATABASES = { 'default': { 'ENGINE': 'sqlite3', 'NAME': 'db.sqlite3' } }"""

D. """DATABASES = { 'default': { 'ENGINE': 'django.db.backends.sqlite3', 'NAME': BASE_DIR / 'db.sqlite3' } }"""

Solution

1. Step 1: Identify correct ENGINE for SQLite

   Django uses django.db.backends.sqlite3 as the ENGINE for SQLite databases.

2. Step 2: Check the NAME setting for SQLite

   The NAME should be a path to the SQLite file, commonly BASE_DIR / 'db.sqlite3' using pathlib.

3. Final Answer:

   DATABASES = { 'default': { 'ENGINE': 'django.db.backends.sqlite3', 'NAME': BASE_DIR / 'db.sqlite3' } } -> Option D

4. Quick Check:

   SQLite ENGINE = django.db.backends.sqlite3 [OK]

Hint: SQLite uses django.db.backends.sqlite3 and file path NAME [OK]

Common Mistakes:

• Using 'sqlite3' instead of 'django.db.backends.sqlite3'
• Confusing ENGINE with PostgreSQL or MySQL backends
• Setting NAME as just a string without path

3. Given this Django database configuration snippet, what database will Django connect to?

DATABASES = {
  'default': {
    'ENGINE': 'django.db.backends.postgresql',
    'NAME': 'myproject',
    'USER': 'admin',
    'PASSWORD': 'secret',
    'HOST': 'localhost',
    'PORT': '5432',
  }
}

medium

A. PostgreSQL database named 'myproject' on localhost

B. MySQL database named 'myproject' on localhost

C. SQLite database named 'myproject'

D. No database connection due to missing ENGINE

Solution

1. Step 1: Check the ENGINE setting

   The ENGINE is set to django.db.backends.postgresql, which means Django will use PostgreSQL.

2. Step 2: Identify database details

   The NAME is 'myproject', HOST is 'localhost', and PORT is '5432' which are typical PostgreSQL defaults.

3. Final Answer:

   PostgreSQL database named 'myproject' on localhost -> Option A

4. Quick Check:

   ENGINE = postgresql means PostgreSQL DB [OK]

Hint: ENGINE shows database type; PostgreSQL means option C [OK]

Common Mistakes:

• Assuming SQLite because of 'myproject' name
• Confusing PostgreSQL with MySQL
• Ignoring HOST and PORT settings

4. Identify the error in this Django database configuration:

DATABASES = {
  'default': {
    'ENGINE': 'django.db.backends.mysql',
    'NAME': 'mydb',
    'USER': 'root',
    'PASSWORD': 'pass123',
    'HOST': '',
    'PORT': '',
  }
}

medium

A. NAME must be a file path for MySQL

B. Empty HOST and PORT cause connection failure

C. PASSWORD cannot be empty string

D. ENGINE should be 'django.db.backends.postgresql'

Solution

1. Step 1: Check HOST and PORT values

   HOST and PORT are empty strings, which can cause connection issues because MySQL expects valid host and port or defaults.

2. Step 2: Understand default behavior

   Leaving HOST and PORT empty may work if MySQL uses defaults, but empty strings are not recommended and can cause errors.

3. Final Answer:

   Empty HOST and PORT cause connection failure -> Option B

4. Quick Check:

   HOST and PORT must be valid or omitted [OK]

Hint: Empty strings for HOST/PORT can break MySQL connection [OK]

Common Mistakes:

• Thinking empty strings mean localhost defaults
• Confusing ENGINE with PostgreSQL
• Assuming PASSWORD must be non-empty always

5. You want to configure Django to use PostgreSQL in production but SQLite in development. Which approach correctly handles this in settings.py?

hard

A. Use environment variables to switch ENGINE and NAME based on environment

B. Set ENGINE to PostgreSQL always and change NAME for dev and prod

C. Use SQLite ENGINE and change USER for production

D. Configure both databases in DATABASES and Django picks automatically

Solution

1. Step 1: Understand environment-based configuration

   Using environment variables lets you switch database settings without changing code, ideal for dev vs prod.

2. Step 2: Why other options fail

   Always setting PostgreSQL ENGINE won't work in dev without PostgreSQL installed; changing USER alone doesn't switch DB type; Django does not auto-pick between multiple databases without explicit routing.

3. Final Answer:

   Use environment variables to switch ENGINE and NAME based on environment -> Option A

4. Quick Check:

   Env vars enable flexible DB config [OK]

Hint: Use env vars to switch DB settings per environment [OK]

Common Mistakes:

• Hardcoding production DB in dev settings
• Assuming Django auto-selects DB from multiple configs
• Changing USER does not switch database type