How To Access Django Database

Click to share! ⬇️

Django, a high-level Python web framework, is renowned for its “batteries-included” approach, offering tools for nearly every aspect of web development. One of its core components is its Object-Relational Mapping (ORM) system, allowing developers to interact seamlessly with their database. For those new to Django or seeking deeper insights into its database capabilities, this tutorial is tailored for you. We’ll delve into the steps, tools, and techniques required to access and manage your Django database efficiently.

  1. What Is Django’s ORM and Its Role
  2. How to Set Up Your Database in Django Settings
  3. Why Using Django ORM Provides Security and Efficiency
  4. How to Perform Basic CRUD Operations
  5. Real World Applications of Django Database Queries
  6. Examples of Complex QuerySet Operations
  7. Troubleshooting Common Database Issues in Django
  8. Can You Use Raw SQL with Django’s ORM
  9. Are There Best Practices for Database Schema Changes

What Is Django’s ORM and Its Role

Django’s ORM (Object-Relational Mapping) is a powerful feature that allows developers to interact with their databases like they would with SQL. In essence, it’s a bridge between your data models (Python classes) and your database. But instead of writing raw SQL queries, you work with high-level Python objects, making database tasks more intuitive and less error-prone.

Why is this useful? When working with databases, using raw SQL can become cumbersome and sometimes, risky, especially with different database backends. ORM provides an abstraction, ensuring you don’t have to delve deep into SQL syntax peculiarities for each database system.

Here’s a quick comparison to elucidate:

ActionRaw SQLDjango ORM
CreateINSERT INTO table_name (column1, column2, column3, ...)model_name.objects.create(attribute1=value1, attribute2=value2, ...)
ReadSELECT column1, column2, ... FROM table_name WHERE conditionmodel_name.objects.filter(attribute=value)
UpdateUPDATE table_name SET column1=value, column2=value2, ... WHERE conditioninstance.attribute=value;
DeleteDELETE FROM table_name WHERE conditioninstance.delete()

Furthermore, using the ORM promotes code reusability and ensures consistency across your project. Developers don’t need to have in-depth SQL knowledge, yet they can still perform complex database operations, thanks to Django’s ORM. This not only expedites development but also fortifies security by preventing potential SQL injection attacks.

How to Set Up Your Database in Django Settings

Django provides flexibility in database setup, supporting engines like PostgreSQL, MySQL, SQLite, and Oracle. To configure your database, you’ll need to make adjustments in the file of your Django project.

In the file, you’ll find the DATABASES setting, a dictionary configuration, where you’ll define your database connection parameters. Depending on your choice of database, Django has specific engine configurations:

  • django.db.backends.sqlite3 for SQLite
  • django.db.backends.postgresql for PostgreSQL
  • django.db.backends.mysql for MySQL
  • for Oracle

For SQLite, the default setting is:

    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': BASE_DIR / "db.sqlite3",

For PostgreSQL, you’ll use:

    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'your_database_name',
        'USER': 'your_database_user',
        'PASSWORD': 'your_password',
        'HOST': 'localhost',  # Set to the address of your database
        'PORT': '5432',  # Default port for PostgreSQL

Adjust parameters similarly for MySQL, Oracle, or other database backends.

With your database specified, you may need to install additional Python packages. For instance, for PostgreSQL, it’s psycopg2:

pip install psycopg2

After configuration, run migrations to create the necessary tables and relations:

python migrate

Lastly, ensure Django can successfully connect to your database by running your project and accessing the admin site or any view that fetches data. For security, always keep your database credentials confidential, perhaps by using environment variables or Django’s secrets module.

Why Using Django ORM Provides Security and Efficiency

Django’s ORM (Object-Relational Mapping) has become one of the cornerstones of the framework, not just for the abstraction it provides between the developer and the underlying database, but also for the intrinsic benefits it brings in terms of security and efficiency.


  1. SQL Injection Prevention: One of the most common web application vulnerabilities is SQL injection. With raw SQL queries, there’s always a risk of accidentally (or maliciously) injecting harmful SQL into the query. Django’s ORM automatically escapes any data it sends to the database, ensuring queries are secure by default.
  2. Consistent Security Practices: Django follows the principle of “secure by default”. By using the ORM, developers inherently benefit from consistent, well-tested security measures established by the Django community. This consistency reduces the risk of security oversights that can occur when using raw SQL.


  1. Abstraction and DRY (Don’t Repeat Yourself): Instead of writing repetitive and verbose SQL queries, developers can work with high-level Python objects and methods. This abstraction not only speeds up the development process but also ensures code is more maintainable and readable.
  2. Database Agnosticism: One of the powerful features of Django’s ORM is its ability to work with various database backends. If you decide to switch from one database system to another, the ORM ensures that the transition is smooth, with minimal code changes required.
  3. Optimized Queries: Django’s ORM is intelligent. It can optimize queries behind the scenes, reducing the database load. The QuerySet API, for instance, is lazy and only hits the database when absolutely necessary, ensuring efficiency in data retrieval.
  4. Built-in Tools and Extensions: Django’s ORM comes packed with tools like migrations for database schema management, and built-in functions for complex tasks like aggregations. There are also numerous third-party extensions available that augment the ORM’s capabilities.

Django’s ORM not only simplifies database interactions for developers but also embeds best practices in security and efficiency. Using it shields applications from common vulnerabilities and ensures that the database layer of the application is both robust and performant.

How to Perform Basic CRUD Operations

CRUD stands for Create, Read, Update, and Delete. These foundational operations dictate how you interact with your database. Using Django’s ORM makes these operations intuitive and Pythonic.

Create: To introduce a new record to your database, you can utilize the create method. Assuming you have a model named Book:

new_book = Book.objects.create(title="Django for Beginners", author="John Doe")

Or, you might prefer to first instantiate the model and subsequently invoke the save method:

new_book = Book(title="Django for Beginners", author="John Doe")

Read: Various methods are on offer to retrieve data using Django’s ORM. For instance, to fetch all records:

all_books = Book.objects.all()

To single out a record by its primary key:

book = Book.objects.get(id=1)

Or, to filter records according to specific conditions:

django_books = Book.objects.filter(title__icontains="Django")

Update: Should you wish to amend an existing record, first retrieve the record in question, alter its attributes, and finalize by invoking the save method:

book = Book.objects.get(id=1)
book.title = "Django for Experts"

Delete: To expunge a record from your database, identify the record and utilize the delete method:

book_to_delete = Book.objects.get(id=1)

Harnessing the power of Django’s ORM, you can deftly navigate CRUD operations. As you progress with Django, you’ll unearth an expansive set of methods and filters, empowering you to conduct intricate queries and data operations. A word of caution: always tread carefully when updating or eradicating records, given the impactful consequences these actions can precipitate on your data.

Real World Applications of Django Database Queries

Django’s ORM isn’t just a tool for basic CRUD operations. In real-world applications, its capabilities stretch far beyond, offering solutions to complex scenarios and requirements. Here’s a look at some practical applications where Django database queries play a pivotal role:

  1. E-commerce Platforms:
    • Product Filtering: Users can filter products based on attributes like price, brand, or category using filter() and exclude().
    • Order Management: Admins can fetch, update, or delete orders using the ORM, ensuring seamless order processing and inventory management.
  2. Blogging Platforms:
    • Tag-based Search: Blogs or articles can be categorized and retrieved based on tags using ManyToMany relationships.
    • Content Aggregation: Display the most recent or most popular posts using annotate() and aggregate() functions.
  3. Social Media Platforms:
    • Friendship Connections: Determine mutual friends, friend suggestions, or fetch friends-of-friends using complex ORM queries on relational tables.
    • Timeline Generation: Aggregate user posts, shared content, and friend activities using union(), intersection(), and difference() on QuerySets.
  4. Learning Management Systems:
    • Progress Tracking: Track user progress through courses, lessons, or quizzes by fetching related records.
    • Recommendation Systems: Recommend courses or subjects based on user preferences, history, or popularity, utilizing advanced filtering and aggregation.
  5. Analytics Platforms:
    • Data Visualization: Fetch and process large volumes of data to generate charts, graphs, or other visual representations.
    • Event Tracking: Log and retrieve user activities, conversions, or interactions to analyze user behavior.
  6. Job Portals:
    • Resume Matching: Match job requirements with candidate skills using text-based search and filtering.
    • Job Alerts: Notify users of new job postings matching their preferences by periodically querying the database for new additions.
  7. Real Estate Portals:
    • Property Listings: Display properties based on user-defined criteria like location, price, or property type.
    • Tenant-Landlord Matching: Connect landlords with suitable tenants by matching property and tenant preferences.

These are just a smattering of the numerous applications where Django’s ORM and database queries are integral. The true beauty of Django lies in its adaptability, enabling developers to craft custom queries tailored to the unique challenges and intricacies of their specific project.

Examples of Complex QuerySet Operations

Django’s ORM offers an array of tools to manage intricate database operations, extending far beyond basic CRUD functionalities. These tools empower developers to craft specialized and efficient database queries. Here’s a closer look:

Chaining Filters allows for refined query results by appending multiple filters consecutively.

# Get all published books after 2000 and authored by "John Doe"
books = Book.objects.filter(published_date__gt='2000-01-01').filter(author="John Doe")

With Using Q Objects for Complex Lookups, Q objects enable the construction of more intricate conditions.

from django.db.models import Q

# Get books authored by "John Doe" OR published after 2000
books = Book.objects.filter(Q(author="John Doe") | Q(published_date__gt='2000-01-01'))

Aggregations are vital to deduce aggregate values over a designated dataset.

from django.db.models import Avg

# Get average price of all books
average_price = Book.objects.all().aggregate(Avg('price'))

Annotations permit the attachment of computed values to objects within a QuerySet.

from django.db.models import Count

# Get the number of books each author has penned
authors = Author.objects.annotate(num_books=Count('book'))

To optimize database accesses in scenarios involving ForeignKey or ManyToMany relations, Select Related & Prefetch Related can be applied.

# Minimize the volume of database queries during access of related attributes
books_with_authors = Book.objects.select_related('author').all()  # for ForeignKey
authors_with_books = Author.objects.prefetch_related('books').all()  # for ManyToManyField

Exclusions facilitate the removal of specific entries from a QuerySet.

# Omit all books penned by "John Doe"
books = Book.objects.exclude(author="John Doe")

For the formulation of dynamic queries, Using F() proves indispensable. F objects permit referencing of fields in a dynamic manner.

from django.db.models import F

# Augment the pricing of all books by 10 units
Book.objects.update(price=F('price') + 10)

Utilize Case & When for Conditional Expressions to construct conditional database inquiries.

from django.db.models import Case, When, Value, CharField

# Categorize books as "cheap" or "expensive" based on their pricing
books = Book.objects.annotate(
        When(price__lt=10, then=Value('cheap')),
        When(price__gte=10, then=Value('expensive')),

Troubleshooting Common Database Issues in Django

Django’s ORM is powerful, but like any framework, it’s not immune to occasional hiccups. When facing database issues in Django, knowing common problems and their solutions can save a lot of time. Here’s a guide to tackling some prevalent database challenges:

OperationalError: No Such Table: This typically happens after defining a new model but forgetting to migrate it.

  • Solution: Run the following commands to create migrations and then apply them.
python makemigrations 
python migrate

ProgrammingError: Relation Does Not Exist: This can occur if the database hasn’t been set up correctly or migrations haven’t been applied.

  • Solution: Ensure that all migrations have been created and applied as shown above.

IntegrityError: NOT NULL Constraint Failed: This signifies that you’re trying to save a model instance without providing a required field.

  • Solution: Ensure all required fields (fields without null=True) have values before saving.

FieldError: Cannot Resolve Keyword: This happens when you try to filter or query a model based on a field that doesn’t exist.

  • Solution: Double-check the field names in your model and update the query accordingly.

MultipleObjectsReturned: This is thrown when using get() and the query returns multiple objects.

  • Solution: Ensure that the query used with get() will always return a unique result. If multiple results are possible, consider using filter() instead.

OperationalError: Database is Locked: This error is common with SQLite, especially when multiple write operations happen simultaneously.

  • Solution: Consider switching to a more robust database like PostgreSQL for production environments. For local development, ensure you aren’t running multiple Django instances concurrently.

DatabaseError: Savepoint Error: This can happen when working with transactions and something goes wrong, causing the transaction block to fail.

  • Solution: Ensure that all database operations within a transaction are valid. If the problem persists, consider breaking the transaction into smaller parts.

ImproperlyConfigured: settings.DATABASES is improperly configured: This error signifies a problem with your DATABASES setting in

  • Solution: Review the DATABASES configuration in Ensure that the ENGINE, NAME, USER, PASSWORD, and other necessary settings are correct.

AttributeError: ‘XYZ’ object has no attribute ‘all’: This typically happens when you try to treat a regular model field as a related field manager.

  • Solution: Ensure that you’re using methods like all() or filter() only on fields that have relationships (like ForeignKey, OneToOneField, or ManyToManyField).

Can You Use Raw SQL with Django’s ORM

Yes, while Django’s ORM is designed to shield developers from having to write raw SQL, there are instances where you might need or prefer to use SQL directly. Django provides mechanisms to execute custom SQL queries safely.

Executing Custom SQL Directly:

Django allows you to execute raw SQL queries using the raw() method on a model’s manager:

for book in Book.objects.raw('SELECT * FROM myapp_book WHERE title = %s', ['The Great Gatsby']):

This method returns a QuerySet that can be iterated over just like any other QuerySet. Each item in the QuerySet will be an instance of the model the query was executed on.

SQL Expressions:

You can also embed raw SQL in ORM queries using the RawSQL expression:

from django.db.models.expressions import RawSQL

queryset = Book.objects.annotate(val=RawSQL("SELECT column FROM some_other_table WHERE =", []))

Executing Arbitrary SQL:

For SQL commands that don’t involve returning rows (e.g., INSERT, UPDATE, or DELETE), you can use the django.db.connections utility:

from django.db import connection

def custom_sql_query():
    with connection.cursor() as cursor:
        cursor.execute("UPDATE myapp_book SET title = %s WHERE id = %s", ['New Title', 1])

Safety Considerations:

When using raw SQL, be cautious about SQL injection risks. Always use parameterized queries or Django’s SQL utilities to ensure data is properly escaped. Avoid string interpolation or concatenation with user-provided data to build SQL queries.

Why Use Raw SQL?:

There are scenarios where raw SQL might be advantageous:

  • Performance: While Django’s ORM is optimized, there might be specific, complex queries where hand-tuned SQL could be faster.
  • Complex Operations: Some database operations, especially those involving advanced features specific to a database backend, might be more straightforward or only possible with raw SQL.
  • Legacy Codebases: When integrating Django with existing databases or legacy applications, raw SQL can provide a way to interact with custom, non-standard schemas.

However, it’s essential to weigh the benefits against the loss of database portability and the potential safety risks. In many cases, the ORM can handle the required tasks, ensuring that your code remains database-agnostic and secure.

Are There Best Practices for Database Schema Changes

Absolutely! When dealing with database schema changes, it’s essential to follow best practices to ensure data integrity, minimize downtime, and maintain a smooth development process. Here are some recommended best practices:

Backup First:

Always take a backup of your database before making any schema changes. This provides a safety net, allowing you to revert if something goes wrong.

Use Version Control:

Store your database migration scripts in the same version control system (like Git) as your application code. This ensures that database changes are tracked along with the corresponding code changes.

Test Changes Locally:

Before applying changes to a production database, always test them locally or in a staging environment first. This helps identify and address potential issues without affecting live data.

Use Database Migration Tools:

Leverage tools like Django’s built-in migrations, Alembic (for SQLAlchemy), or Flyway. These tools help manage schema changes, apply them in the correct order, and keep track of which migrations have been applied.

Incremental Changes:

Instead of making large, sweeping changes to the database schema, break changes down into smaller, incremental steps. This makes it easier to troubleshoot issues and reduces the potential impact of a problematic change.

Avoid Directly Modifying Production Schemas:

Whenever possible, avoid making direct schema changes to production databases. Instead, use migration scripts that can be reviewed, tested, and versioned.

Minimize Downtime:

For applications that require high availability, plan schema changes in ways that minimize or eliminate downtime. Techniques such as “zero-downtime migrations” or “blue-green deployments” can be useful.

Data Integrity:

When modifying columns, ensure that existing data conforms to new constraints or data types. For example, if you’re adding a NOT NULL constraint to a column, ensure existing rows don’t have NULL values in that column.

Monitor After Changes:

Once you’ve applied a database schema change, especially in production, monitor application logs, error rates, and database performance. This can help quickly detect and address any unforeseen issues arising from the change.

Document Changes:

Maintain documentation that describes each schema change, why it was made, and any potential impacts. This provides context for other developers and ensures a historical record of database evolution.

Consider Rollback Strategies:

When planning a schema change, think about a rollback strategy in case things go awry. This could involve preparing a reverse migration or having a backup restoration procedure in place.

Click to share! ⬇️