🐍 pymysql이란?

pymysql은 Python에서 MariaDB / MySQL 데이터베이스에 접속하기 위한 라이브러리다.

Python 코드와 SQL 데이터베이스 사이를 연결해주는 DB 드라이버다.

---

🧠 DB 드라이버의 역할

프로그램과 데이터베이스는 서로 다른 언어를 사용한다.

• Python → Python 문법
• MariaDB/MySQL → SQL

이 둘은 직접 대화할 수 없다. 그래서 중간에 통역사가 필요하다.

[ Python 코드 ]
      │
      │  (DB 드라이버)
      ▼
[ pymysql ]
      │
      ▼
[ MariaDB / MySQL ]
  

pymysql은 SQL을 DB가 이해할 수 있는 형태로 전달하고,
DB의 응답을 다시 Python이 이해할 수 있게 변환한다.

---

❓ 왜 프로그램에서 DB를 조작해야 할까?

Workbench나 DataGrip에서도 SQL은 실행할 수 있다.

하지만 실제 서비스에서는 사람이 직접 SQL을 치지 않는다.

• 회원가입 버튼 클릭 → INSERT 실행
• 로그인 요청 → SELECT 실행
• 게시글 작성 → INSERT 실행

이 모든 SQL을 Python 코드가 대신 실행해야 한다.
그 연결 고리가 바로 pymysql이다.

---

🚀 먼저 실행해보기

1️⃣ 설치

pip install pymysql

설치 확인

pip show pymysql

---

2️⃣ DB 연결 테스트

Python 파일을 하나 만들고 아래 코드를 실행한다.
연결 정보는 본인 환경에 맞게 수정.

import pymysql

conn = pymysql.connect(
    host="서버주소",
    user="사용자명",
    password="비밀번호",
    db="데이터베이스명",
    charset="utf8mb4"
)

print("연결 성공!")
conn.close()

"연결 성공!"이 출력되면 DB와 통신이 열린 상태다.

---

🔐 연결 정보 분리 (중요)

비밀번호를 코드에 직접 쓰는 건 사고 유발이다.

반드시 환경변수를 사용한다.

import os
import pymysql

conn = pymysql.connect(
    host=os.getenv("DB_HOST"),
    user=os.getenv("DB_USER"),
    password=os.getenv("DB_PASSWORD"),
    db=os.getenv("DB_NAME"),
    charset="utf8mb4"
)

• .env 파일 사용
• .gitignore에 추가

---

🧷 Cursor란?

DB에 연결했다고 바로 SQL을 실행할 수 있는 건 아니다. cursor가 필요하다.

📌 cursor의 개념

cursor는 쿼리 결과를 가리키는 포인터다.

쿼리 결과
------------------
[1] jay, 25   ← cursor
[2] 철수, 30
[3] 영희, 28
  

cursor는 한 줄씩 이동하면서 데이터를 읽는다.
fetchone()을 호출하면 현재 행을 반환하고 다음 행으로 이동한다.

---

📥 fetch 메서드 비교

메서드	반환값	사용 시점
fetchone()	한 행	결과가 1건일 때
fetchall()	모든 행	결과가 여러 건일 때
fetchmany(n)	n개 행	대량 데이터 분할 처리

---

🔄 pymysql 전체 흐름

1. connect   → DB 연결
2. cursor    → 커서 생성
3. execute   → SQL 실행
4. fetch     → 결과 가져오기
5. close     → 커서 종료
6. close     → 연결 종료
  

📦 전체 예제

import pymysql

# 1. DB 연결
conn = pymysql.connect(
    host='서버주소',
    user='사용자명',
    password='비밀번호',
    db='데이터베이스명',
    charset='utf8mb4'
)

# 2. 커서 생성
cursor = conn.cursor()

# 3. SQL 실행
cursor.execute("SELECT * FROM users")

# 4. 결과 가져오기
rows = cursor.fetchall()
for row in rows:
    print(row)

# 5. 종료 (커서 → 연결 순서)
cursor.close()
conn.close()

---

🔥 핵심 요약

• pymysql은 Python ↔ MySQL 통역사
• DB 드라이버 없이는 DB 접근 불가
• cursor는 결과를 가리키는 포인터
• 비밀번호는 반드시 환경변수로 분리