파이썬(Python)에서 MySQL 데이터베이스 연결하는 방법 완벽 가이드

대부분의 애플리케이션은 데이터 저장, 조회, 수정 등의 작업을 수행하기 위해 데이터베이스와 연동되어야 합니다. 특히 사용자 정보를 저장하거나 관리해야 하는 프로젝트라면 데이터베이스 연결은 필수적입니다. 이 글에서는 파이썬 애플리케이션에 가장 널리 사용되는 오픈소스 데이터베이스인 MySQL을 연결하는 방법을 단계별로 알아보겠습니다.

1. MySQL Connector 설치하기

파이썬에서 MySQL 데이터베이스에 연결하려면 먼저 시스템에 MySQL이 설치되어 있어야 하며, 파이썬과 데이터베이스를 연결해 주는 드라이버인 MySQL Connector가 필요합니다. 아래 명령어를 실행하여 간단히 설치할 수 있습니다.

python -m pip install mysql-connector-python

설치가 완료되면 파이썬 프로젝트나 애플리케이션에서 MySQL 데이터베이스에 접속할 수 있는 환경이 준비됩니다.

2. 데이터베이스 연결(Connection) 생성하기

데이터베이스 작업을 수행하기 위해서는 가장 먼저 데이터베이스와의 연결 객체를 생성해야 합니다. 연결이 완료된 후에는 SQL 명령을 실행하여 다양한 데이터베이스 작업을 처리할 수 있습니다. 연결 시에는 MySQL 서버의 호스트 주소, 사용자 이름, 비밀번호 등의 인증 정보가 필요합니다.

예제 코드

import mysql.connector

mydatabase = mysql.connector.connect(
    host="localhost",
    user="your_user_name",
    password="your_password",
    database="database_name"
)

위 코드에서 connect() 함수를 호출하면 데이터베이스와의 연결이 설정됩니다. 특정 데이터베이스에 바로 접속하고 싶다면 database 매개변수에 데이터베이스 이름을 지정하면 됩니다. 연결이 성공적으로 이루어지면 이후 SQL 명령을 자유롭게 실행할 수 있습니다.

3. 커서(Cursor) 객체 생성하기

연결이 완료되었다면 다음 단계는 커서(Cursor) 객체를 생성하는 것입니다. 커서 객체는 SQL 쿼리를 실행하고 그 결과를 가져오는 역할을 담당하며, cursor() 함수를 통해 생성할 수 있습니다.

cursor_name = connection_name.cursor()

예제 코드

import mysql.connector

mydatabase = mysql.connector.connect(
    host="localhost",
    user="your_user_name",
    password="your_password",
    database="database_name"
)
mycsr = mydatabase.cursor()

이제 데이터베이스 연결이 확립되고 커서 객체까지 준비되었습니다. execute() 함수를 사용하여 SELECT, INSERT, UPDATE, DELETE 등 원하는 모든 SQL 쿼리를 실행할 수 있습니다. 예를 들어 mycsr.execute("SELECT * FROM 테이블명")과 같이 작성하면 테이블의 데이터를 조회할 수 있습니다.

마무리

지금까지 파이썬에서 MySQL 데이터베이스에 연결하는 기본 과정을 살펴보았습니다. 핵심 흐름은 다음과 같습니다.

① MySQL Connector 설치 → ② connect()로 연결 생성 → ③ cursor()로 커서 객체 생성 → ④ execute()로 쿼리 실행

이 기본 구조만 익혀두면 실제 프로젝트에서 데이터를 저장하고 활용하는 다양한 기능을 손쉽게 구현할 수 있습니다. 추가로 보안을 위해 비밀번호는 소스 코드에 직접 하드코딩하지 않고 환경 변수로 관리하는 것이 좋습니다.