Python 강좌 / sqlite3로 데이터 저장하고 매개변수 쿼리 사용하기

Python 강좌

sqlite3는 별도 데이터베이스 서버 없이 파일에 SQL 데이터를 저장하는 Python 표준 모듈입니다. 입력값은 SQL 문자열에 직접 넣지 않고 매개변수로 전달하고, 트랜잭션의 성공·실패 시점을 명확히 관리합니다.

SQLite와 연결·트랜잭션

SQLite는 프로그램에 포함해 사용하는 데이터베이스 엔진입니다. 파일 하나로 시작하기 편하지만 여러 쓰기 요청을 처리하는 방식과 운영 조건은 서버형 DB와 다릅니다. sqlite3 연결을 여는 것만으로 모든 작업이 영구 저장되지는 않습니다.

관련 동작과 지원 조건은 sqlite3로 데이터 저장하고 매개변수 쿼리 사용하기 관련 공식 문서에서 확인할 수 있습니다.

예제는 Python 3.12 이상에서 autocommit=False를 명시하여 트랜잭션 제어 방식을 고정합니다. with connection은 성공 시 commit, 예외 시 rollback을 수행하지만 연결 자체를 닫지는 않으므로 finally에서 close합니다.

전체 예제와 실행 결과

별도의 실습 폴더에서 아래 파일을 UTF-8로 저장합니다. 가상환경을 선택한 터미널에서 python sqlite_demo.py 명령으로 실행합니다. macOS·Ubuntu에서 가상환경을 사용하지 않는 경우 명령 이름을 python3으로 바꿉니다.

sqlite_demo.py 파일의 전체 내용입니다.

import sqlite3

con = sqlite3.connect("ledger-demo.db", autocommit=False)
try:
    with con:
        con.execute("CREATE TABLE IF NOT EXISTS expenses (id TEXT PRIMARY KEY, name TEXT NOT NULL, amount INTEGER NOT NULL CHECK(amount >= 0))")
        con.execute("INSERT INTO expenses VALUES (?, ?, ?) ON CONFLICT(id) DO UPDATE SET name=excluded.name, amount=excluded.amount", ("e1", "lunch", 8000))
    rows = con.execute("SELECT name, amount FROM expenses ORDER BY id").fetchall()
    print(rows)
finally:
    con.close()

예상 결과는 다음과 같습니다.