Conexión y uso de MySQL con Python

MySQL es una de las bases de datos relacionales de código abierto más populares, y Python es uno de los lenguajes de programación más populares en la actualidad. Usar Python junto con MySQL nos permite desarrollar fácilmente aplicaciones basadas en bases de datos.

Este artículo explicará en detalle cómo conectar y operar una base de datos MySQL con Python. El contenido incluye lo siguiente:

  1. Cómo instalar el controlador MySQL para Python
  2. Establecer y cerrar conexiones de base de datos
  3. Ejecutar varias consultas SQL
  4. Gestión de transacciones y manejo de errores
  5. Buenas prácticas para operaciones de base de datos

Preparación

Instalar el software necesario

Antes de comenzar, asegúrate de tener instalado el siguiente software:

  • Python(se recomienda 3.6 o superior)
  • MySQL Server(la versión comunitaria es suficiente)
  • MySQL Connector/Python(controlador MySQL para Python)

Instalar MySQL Connector/Python

Puedes instalar el controlador Python oficial de MySQL usando pip:

pip install mysql-connector-python

O instalar PyMySQL (otro controlador MySQL popular para Python):

pip install pymysql

Conectar a la base de datos MySQL

Establecer una conexión básica

A continuación se muestra el uso demysql-connector-pythonel código básico para establecer una conexión de base de datos:

Ejemplo

import mysql.connector

# Crear la conexión de base de datos
db = mysql.connector.connect(
    host="localhost",
    user="yourusername",
    password="yourpassword",
    database="yourdatabase"
)

print(¡Conexión a la base de datos exitosa!)

Descripción de los parámetros de conexión

  • host: Dirección del servidor MySQL (local: "localhost")
  • user: Nombre de usuario de la base de datos
  • password: Contraseña del usuario
  • database: Nombre de la base de datos a la que conectarse (opcional)

Conexión usando PyMySQL

Si eliges usar PyMySQL, la forma de conexión es ligeramente diferente:

Ejemplo

import pymysql

# Crear la conexión de base de datos
db = pymysql.connect(
    host="localhost",
    user="yourusername",
    password="yourpassword",
    database="yourdatabase"
)

print(¡Conexión a la base de datos exitosa!)

Ejecutar consultas SQL

Crear un objeto cursor

Antes de ejecutar sentencias SQL, necesitamos crear un objeto cursor:

Ejemplo

cursor = db.cursor()

Ejecutar consultas SELECT

Ejemplo

cursor.execute("SELECT * FROM your_table")

# Obtener todos los resultados
results = cursor.fetchall()

for row in results:
    print(row)

Ejecutar operaciones INSERT, UPDATE, DELETE

Ejemplo

# Insertar datos
sql = "INSERT INTO users (name, age) VALUES (%s, %s)"
values = (Zhang San, 25)
cursor.execute(sql, values)

# Confirmar la transacción
db.commit()

print(cursor.rowcount, registros insertados con éxito)

Usar consultas parametrizadas

Para prevenir la inyección SQL, siempre se deben usar consultas parametrizadas:

Ejemplo

sql = "SELECT * FROM users WHERE name = %s"
name = (Zhang San,)
cursor.execute(sql, name)

Gestión de transacciones

Conceptos básicos de las transacciones

Una transacción MySQL es un conjunto de consultas SQL atómicas; o se ejecutan todas con éxito, o no se ejecuta ninguna.

Usar transacciones

Ejemplo

try:
    # Iniciar transacción
    cursor.execute("START TRANSACTION")
   
    # Ejecutar varias sentencias SQL
    cursor.execute("UPDATE accounts SET balance = balance - 100 WHERE id = 1")
    cursor.execute("UPDATE accounts SET balance = balance + 100 WHERE id = 2")
   
    # Confirmar transacción
    db.commit()
    print(Transacción ejecutada con éxito)
except Exception as e:
    # Ocurrió un error, revertir la transacción
    db.rollback()
    print(Falló la ejecución de la transacción:, e)

Manejo de errores

Capturar errores de base de datos

Ejemplo

try:
    cursor.execute("SELECT * FROM non_existent_table")
except mysql.connector.Error as err:
    print(Error de base de datos:, err)

Códigos de error comunes

  • 1045: Acceso denegado (nombre de usuario o contraseña incorrectos)
  • 1049: Base de datos desconocida
  • 1146: La tabla no existe
  • 1062: Valor de clave duplicado

Cerrar la conexión

Cerrar la conexión correctamente

Después de completar las operaciones de base de datos, se deben cerrar el cursor y la conexión:

Ejemplo

cursor.close()
db.close()
print(La conexión a la base de datos se ha cerrado)

Usar la declaración with

La sentencia with de Pythonwithpuede gestionar recursos automáticamente:

Ejemplo

with mysql.connector.connect(
    host="localhost",
    user="yourusername",
    password="yourpassword",
    database="yourdatabase"
) as db:
    with db.cursor() as cursor:
        cursor.execute("SELECT * FROM users")
        results = cursor.fetchall()
        for row in results:
            print(row)
# Después de salir del bloque with, la conexión se cierra automáticamente

Buenas prácticas

Pool de conexiones

Para aplicaciones que se conectan con frecuencia a la base de datos, se recomienda usar un pool de conexiones:

Ejemplo

from mysql.connector import pooling

# Crear pool de conexiones
db_pool = pooling.MySQLConnectionPool(
    pool_name="mypool",
    pool_size=5,
    host="localhost",
    user="yourusername",
    password="yourpassword",
    database="yourdatabase"
)

# Obtener una conexión del pool de conexiones
db = db_pool.get_connection()

Framework ORM

Para aplicaciones complejas, se puede considerar el uso de un framework ORM (mapeo objeto-relacional), como SQLAlchemy o Django ORM.


Otras extensiones