파이썬 SQLAlchemy Core insert select update delete 완벽 가이드

📝 SQLAlchemy Core 기본 개념 이해하기

SQLAlchemy는 파이썬에서 가장 널리 사용되는 데이터베이스 라이브러리 중 하나로, ORM(Object Relational Mapping) 기능뿐 아니라 SQL을 직접 다룰 수 있는 Core 표현식 언어를 제공합니다.
Core는 SQLAlchemy의 저수준 API로, SQL 구문을 파이썬 객체로 표현하여 보다 유연하고 명확하게 데이터베이스 작업을 수행할 수 있게 합니다.
이 방식은 SQL을 직접 작성하지 않고도 데이터베이스와 소통할 수 있다는 장점이 있습니다.

SQLAlchemy Core의 핵심은 Table 객체와 SQL 표현식 언어입니다.
Table 객체는 실제 데이터베이스의 테이블 구조를 코드로 정의하며, 컬럼, 타입, 제약 조건 등을 지정할 수 있습니다.
이후 insert, select, update, delete와 같은 메서드를 활용해 SQL을 작성하는 것처럼 직관적으로 데이터를 다룰 수 있습니다.

📌 SQLAlchemy Core의 주요 특징

• ⚙️SQL 구문을 파이썬 객체로 표현 가능
• 🛠️데이터베이스 독립적인 코드 작성이 가능하여 다양한 DB 엔진 지원
• 🔒SQL 인젝션을 방지하는 안전한 쿼리 빌딩 제공
• 📊ORM 없이도 데이터 조작 및 조회 가능

📌 기본 코드 예시

from sqlalchemy import create_engine, MetaData, Table, Column, Integer, String

engine = create_engine("sqlite:///example.db", echo=True)
metadata = MetaData()

users = Table(
    "users", metadata,
    Column("id", Integer, primary_key=True),
    Column("name", String),
    Column("age", Integer)
)

metadata.create_all(engine)

위 코드에서 보듯, SQLAlchemy Core는 데이터베이스 엔진을 생성하고, 테이블과 컬럼을 정의한 후 데이터베이스에 적용합니다.
이후 insert, select, update, delete를 통해 데이터를 조작할 수 있으며, 이러한 과정은 SQL을 직접 작성하는 것보다 훨씬 안전하고 직관적입니다.

📥 insert로 데이터 추가하기

데이터베이스에 새로운 데이터를 추가할 때 사용하는 구문이 바로 insert입니다.
SQLAlchemy Core의 insert는 SQL의 INSERT 구문을 객체지향적으로 표현해주며, 안전하게 데이터를 삽입할 수 있도록 도와줍니다.
파라미터 바인딩 방식이 기본 제공되므로, SQL 인젝션 공격을 예방할 수 있다는 점에서 매우 유용합니다.

📌 기본 insert 구문 사용법

from sqlalchemy import insert
from sqlalchemy import create_engine

engine = create_engine("sqlite:///example.db")
conn = engine.connect()

stmt = insert(users).values(name="Alice", age=25)
conn.execute(stmt)
conn.commit()

위 예시는 users 테이블에 새로운 행을 추가하는 방법을 보여줍니다.
insert() 메서드에 values()를 연결해 원하는 컬럼과 값을 지정하면 됩니다.
commit()을 호출해야 실제 데이터베이스에 반영됩니다.

📌 여러 데이터 한번에 추가하기

stmt = insert(users)
conn.execute(stmt, [
    {"name": "Bob", "age": 30},
    {"name": "Charlie", "age": 35}
])
conn.commit()

이 방식은 다수의 데이터를 한 번에 삽입할 때 효율적입니다.
파이썬 딕셔너리 형태로 여러 값을 전달하면 대량 삽입을 간편하게 처리할 수 있습니다.

🔎 select로 데이터 조회하기

데이터베이스에서 가장 많이 사용되는 작업 중 하나는 데이터를 불러오는 select 구문입니다.
SQLAlchemy Core의 select는 SQL의 SELECT 구문을 객체지향적으로 표현하며, 필요한 컬럼을 지정하거나 조건을 추가해 데이터를 조회할 수 있습니다.
이는 SQL을 직접 작성하지 않고도 직관적이고 안전하게 원하는 데이터를 가져올 수 있게 해줍니다.

📌 기본 select 구문 사용법

from sqlalchemy import select

stmt = select(users)
result = conn.execute(stmt)

for row in result:
    print(row)

위 예시는 users 테이블의 모든 데이터를 조회하는 방법을 보여줍니다.
select() 함수에 테이블 객체를 넘겨주면 SELECT * FROM users와 동일한 결과를 얻을 수 있습니다.

📌 특정 컬럼만 조회하기

stmt = select(users.c.name, users.c.age)
result = conn.execute(stmt)

for row in result:
    print(row.name, row.age)

원하는 컬럼만 지정해 효율적으로 데이터를 조회할 수 있습니다.
이 방식은 대규모 데이터베이스에서 불필요한 데이터 로딩을 방지하고 성능을 최적화합니다.

📌 조건(where) 조회하기

stmt = select(users).where(users.c.age > 25)
result = conn.execute(stmt)

for row in result:
    print(row)

where()를 사용하면 조건문을 지정해 원하는 데이터만 필터링할 수 있습니다.
이 구문은 SQL의 WHERE 절과 동일하게 동작하며, 복잡한 조건도 파이썬식 표현으로 쉽게 다룰 수 있습니다.

✏️ update로 데이터 수정하기

데이터베이스에서 이미 존재하는 데이터를 변경할 때는 update 구문을 사용합니다.
SQLAlchemy Core의 update는 SQL의 UPDATE 구문을 안전하게 표현해 주며, 특정 조건을 지정해 원하는 행만 업데이트할 수 있습니다.
이 과정에서 values()를 활용해 변경할 컬럼과 값을 정의합니다.

📌 기본 update 구문 사용법

from sqlalchemy import update

stmt = update(users).where(users.c.name == "Alice").values(age=28)
conn.execute(stmt)
conn.commit()

위 예시는 이름이 “Alice”인 사용자의 나이를 28로 수정하는 코드입니다.
update() 구문에 where()와 values()를 결합해 원하는 조건과 수정값을 지정합니다.

📌 여러 행 한번에 수정하기

stmt = update(users).where(users.c.age < 30).values(age=30)
conn.execute(stmt)
conn.commit()

이 코드는 나이가 30세 미만인 모든 사용자의 나이를 30으로 일괄 수정합니다.
조건에 따라 여러 레코드를 동시에 변경할 수 있으며, 대량 데이터 갱신에도 활용할 수 있습니다.

🗑️ delete로 데이터 삭제하기

데이터베이스에서 불필요한 데이터를 제거할 때는 delete 구문을 사용합니다.
SQLAlchemy Core는 SQL의 DELETE 구문을 직관적으로 다룰 수 있도록 지원하며, where 절을 사용해 삭제 대상을 정확히 지정할 수 있습니다.
이를 통해 안전하고 효율적으로 데이터를 관리할 수 있습니다.

📌 기본 delete 구문 사용법

from sqlalchemy import delete

stmt = delete(users).where(users.c.name == "Bob")
conn.execute(stmt)
conn.commit()

이 예시는 이름이 “Bob”인 행을 삭제하는 코드입니다.
where 절을 통해 특정 조건을 반드시 지정해야 안전하게 데이터를 삭제할 수 있습니다.

📌 여러 행 삭제하기

stmt = delete(users).where(users.c.age < 30)
conn.execute(stmt)
conn.commit()

위 코드는 나이가 30세 미만인 모든 사용자 데이터를 한 번에 삭제합니다.
조건을 통해 삭제 대상을 명확히 지정하면 대량 데이터 처리도 안전하게 수행할 수 있습니다.

❓ 자주 묻는 질문 (FAQ)