Python – Conexión a base de datos MariaDB

Para hablar con MariaDB desde Python hay dos opciones buenas: el conector oficial, mariadb, y PyMySQL, escrito en Python puro. El código es casi el mismo; cambia cómo se instalan y cómo se marcan los parámetros.

Instalarlo

pip install mariadb

Y aquí está la primera sorpresa. En Linux, si falta la biblioteca de C de MariaDB, la instalación falla con esto:

salida/bin/sh: 1: mariadb_config: not found
error: subprocess-exited-with-error

El conector oficial es una extensión en C y necesita compilarse contra MariaDB Connector/C. En Debian y Ubuntu se resuelve con sudo apt install libmariadb-dev gcc antes del pip install. Si prefieres no compilar nada, pip install pymysql funciona sin más.

Conectar y crear una tabla

import mariadb

conexion = mariadb.connect(host="localhost", port=3306, user="app",
                           password="clave", database="pruebas")
cur = conexion.cursor()
cur.execute("SELECT VERSION()")
print("conectado a MariaDB", cur.fetchone()[0])

cur.execute("""
    CREATE TABLE usuarios (
        id     INT AUTO_INCREMENT PRIMARY KEY,
        correo VARCHAR(100) NOT NULL UNIQUE,
        nombre VARCHAR(100)
    )""")

salidaconectado a MariaDB 11.8.9-MariaDB-ubu2404

Insertar y consultar, con parámetros

cur.executemany("INSERT INTO usuarios (correo, nombre) VALUES (?, ?)",
                [("ana@ejemplo.com", "Ana Pérez"), ("luis@ejemplo.com", "Luis Gómez")])
conexion.commit()
print("insertados:", cur.rowcount)

cur.execute("SELECT id, correo, nombre FROM usuarios WHERE nombre LIKE ?", ("%Pérez%",))
for fila in cur:
    print("  ", fila)

salidainsertados: 2
   (1, 'ana@ejemplo.com', 'Ana Pérez')

Los valores van con ? en la consulta y aparte, en una tupla. Fíjate en la coma de ("%Pérez%",): sin ella no es una tupla, es solo un texto entre paréntesis. Y sin commit() los cambios no se guardan; al cerrar la conexión, se pierden.

Un duplicado

try:
    cur.execute("INSERT INTO usuarios (correo, nombre) VALUES (?, ?)", ("ana@ejemplo.com", "Otra Ana"))
    conexion.commit()
except mariadb.IntegrityError as e:
    conexion.rollback()
    print("IntegrityError:", e)

salidaIntegrityError: Duplicate entry 'ana@ejemplo.com' for key 'correo'

Por qué parámetros y no f-strings

malicioso = "x' OR '1'='1"

cur.execute("SELECT COUNT(*) FROM usuarios WHERE correo = ?", (malicioso,))
print("con parámetros, el ataque devuelve:", cur.fetchone()[0])

cur.execute(f"SELECT COUNT(*) FROM usuarios WHERE correo = '{malicioso}'")
print("pegando la cadena, devuelve:       ", cur.fetchone()[0])

salidacon parámetros, el ataque devuelve: 0
pegando la cadena, devuelve:        2

Con PyMySQL

import pymysql

with pymysql.connect(host="localhost", user="app", password="clave", database="pruebas") as c:
    with c.cursor() as cur:
        cur.execute("SELECT COUNT(*) FROM usuarios WHERE nombre LIKE %s", ("%Gómez%",))
        print(cur.fetchone()[0])

salida1

Lo mismo, con una diferencia que despista: PyMySQL marca los parámetros con %s, no con ?. Parece formato de cadenas, pero no lo es: siguen yendo aparte y el controlador los escapa.

Más información en inglés: Connect to MariaDB in Python.

Todo el código se ejecutó con Python 3.14 en un contenedor limpio antes de publicar esta página; las salidas están copiadas de esa ejecución.