Django에서 실행되는 Raw SQL 쿼리 확인 방법

2024-07-27

따라서 실행 중인 SQL 쿼리를 확인하는 방법은 두 가지가 있습니다.

Django Debug Toolbar 사용하기

Django Debug Toolbar는 Django 웹 응용 프로그램을 디버그하는 데 도움이 되는 유용한 도구입니다.

Debug Toolbar를 사용하여 실행된 SQL 쿼리 목록을 볼 수 있습니다.

이를 수행하려면 다음 단계를 따르세요.

Django 프로젝트에 debug_toolbar 설치:
```
pip install debug-toolbar
```
settings.py 파일에 INSTALLED_APPS 목록에 debug_toolbar 추가
DEBUG 설정을 True로 설정
웹 브라우저에서 Django 관리 인터페이스 또는 다른 Django 뷰에 액세스합니다.
디버그 툴바를 클릭하고 'SQL' 탭을 선택합니다.

이제 실행된 모든 SQL 쿼리 목록과 각 쿼리의 실행 시간을 볼 수 있습니다. 쿼리를 클릭하면 쿼리의 세부 정보를 볼 수 있습니다.

django.db.connection 사용하기

django.db.connection 객체를 사용하여 직접 SQL 쿼리를 실행하고 결과를 가져올 수 있습니다.

다음 코드는 모든 books 테이블 레코드를 선택하는 SQL 쿼리를 실행하고 결과를 출력하는 방법을 보여줍니다.

from django.db import connection

with connection.cursor() as cursor:
    cursor.execute('SELECT * FROM books')
    rows = cursor.fetchall()

for row in rows:
    print(row)

이 코드는 다음과 유사한 출력을 생성합니다.

(1, 'Django for Beginners', 'David Beazley', 'Apress', 2015),
(2, 'Practical Django Projects', 'Christopher Brooks', 'Apress', 2014),
...

예제 코드

Django Debug Toolbar 사용하기

이 예제는 Django Debug Toolbar를 사용하여 실행된 SQL 쿼리 목록을 보여주는 방법을 보여줍니다.

# settings.py 파일에서

INSTALLED_APPS = [
    # ...
    'debug_toolbar',
]

DEBUG = True

# views.py 파일에서

from django.shortcuts import render

def my_view(request):
    # ...

    # 실행된 SQL 쿼리 확인
    if request.DEBUG:
        from debug_toolbar import Toolbar
        toolbar = Toolbar(request)
        sql_queries = toolbar.sql_queries
        for query in sql_queries:
            print(query['sql'])
            print('-' * 80)

    return render(request, 'my_template.html', {'data': data})

django.db.connection 사용하기

이 예제는 django.db.connection 객체를 사용하여 모든 books 테이블 레코드를 선택하는 SQL 쿼리를 실행하고 결과를 출력하는 방법을 보여줍니다.

from django.db import connection

def my_view(request):
    # ...

    # 모든 books 테이블 레코드 선택
    with connection.cursor() as cursor:
        cursor.execute('SELECT * FROM books')
        rows = cursor.fetchall()

    # 결과 출력
    for row in rows:
        print(row)

    return render(request, 'my_template.html', {'data': data})

(1, 'Django for Beginners', 'David Beazley', 'Apress', 2015),
(2, 'Practical Django Projects', 'Christopher Brooks', 'Apress', 2014),
...

Django에서 실행되는 SQL 쿼리 확인을 위한 대체 방법

로깅 사용하기

Django는 로깅 프레임워크를 제공하여 응용 프로그램의 다양한 측면을 로깅할 수 있습니다. SQL 쿼리를 로깅하도록 구성하여 실행된 모든 쿼리를 추적할 수 있습니다.

다음은 settings.py 파일에 로깅 설정을 추가하는 방법의 예입니다.

LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'handlers': {
        'console': {
            'class': 'logging.StreamHandler',
            'level': 'DEBUG',
        },
    },
    'loggers': {
        'django.db.backends.signals': {
            'level': 'DEBUG',
            'handlers': ['console'],
        },
    },
}

이 설정은 모든 SQL 쿼리를 콘솔에 로깅합니다.

sqlparse 라이브러리 사용하기

sqlparse 라이브러리는 SQL 쿼리를 구문 분석하고 형식화하는 데 사용할 수 있는 Python 라이브러리입니다. 이 라이브러리를 사용하여 실행된 SQL 쿼리를 더 읽기 쉽게 만들 수 있습니다.

다음은 sqlparse 라이브러리를 사용하여 SQL 쿼리를 형식화하는 방법의 예입니다.

from django.db import connection
from sqlparse import format as sqlformat

with connection.cursor() as cursor:
    cursor.execute('SELECT * FROM books')
    query = cursor.mogrify('SELECT * FROM books')

    formatted_query = sqlformat(query)
    print(formatted_query)

SELECT *
FROM books;

타사 도구 사용하기

Django에서 실행되는 SQL 쿼리를 확인하는 데 도움이 되는 여러 타사 도구가 있습니다.

다음은 인기 있는 몇 가지 도구입니다.

Django Debug Toolbar: 이미 언급했지만 Django Debug Toolbar는 SQL 쿼리를 포함하여 응용 프로그램에 대한 다양한 디버그 정보를 제공하는 강력한 도구입니다.
SQLiteBrowser: SQLite 데이터베이스를 브라우징하고 편집하는 데 사용할 수 있는 무료 오픈 소스 도구입니다. Django는 SQLite를 백엔드 데이터베이스로 사용하도록 구성할 수 있으므로 SQLiteBrowser를 사용하여 Django 응용 프로그램에서 실행되는 SQL 쿼리를 확인할 수 있습니다.
Sequel Pro: Mac 용의 유료 데이터베이스 관리 도구입니다. Sequel Pro는 다양한 데이터베이스를 지원하며 Django 응용 프로그램에서 실행되는 SQL 쿼리를 확인하는 데 사용할 수 있습니다.

주의 사항

위에 언급된 대체 방법을 사용하기 전에 각 방법의 장단점을 고려하는 것이 중요합니다.

예를 들어, 로깅을 사용하면 많은 양의 데이터를 생성할 수 있으므로 디버깅 목적으로만 사용하는 것이 좋습니다. sqlparse 라이브러리는 SQL 쿼리를 더 읽기 쉽게 만드는 데 유용하지만 복잡한 쿼리를 이해하는 데 도움이 되지 않을 수 있습니다.

python sql django