Python: conexión de programas a bases de datos MariaDB

Con Python y MariaDB puedes conectar aplicaciones a una base de datos de forma eficiente y procesar información. La combinación de Python y MariaDB es especialmente útil para las aplicaciones web, el análisis de datos y la automatización de informes.

¿Cuáles son los requisitos?

Antes de poder conectar programas Python con MariaDB, debes cumplir los siguientes requisitos:

• Instalación de Python: asegúrate de tener Python instalado en tu sistema y que sea una versión compatible.
• Base de datos MariaDB: necesitas una base de datos MariaDB funcional. Puedes utilizar una instalación local de MariaDB o conectarte a una base de datos remota.
• Credenciales de acceso a la base de datos: necesitas información como el nombre del host, el puerto, el nombre de la base de datos, el nombre de usuario y la contraseña para conectarte a la base de datos MariaDB.
• Módulo Python: debes tener instalado el módulo Python/Connector para conectarte a MariaDB.

Preparación e instalación

Tienes dos formas de acceder a un servidor MariaDB. Puedes instalar un servidor MariaDB en tu propio equipo o servidor, o utilizar la plataforma MariaDB en la cloud.

Opción 1. Instalar el servidor MariaDB en tu hardware

Es bastante sencillo descargar el paquete de MariaDB e instalarlo en tu equipo. Aquí tienes una guía detallada:

Paso 1. Comprueba los requisitos del sistema

Asegúrate de que tu hardware cumple con los requisitos mínimos, como tener suficiente espacio en disco y memoria RAM.

Paso 2. Descarga MariaDB

Visita la página web oficial de MariaDB y descarga la versión correspondiente a tu sistema operativo (Windows, Linux o macOS).

Paso 3. Instala el paquete

Descarga el paquete correcto para tu sistema operativo y arquitectura (32 bits o 64 bits). Una vez finalizada la descarga, ejecuta la instalación de acuerdo a tu sistema operativo. Por ejemplo, si vas a instalar MariaDB en Ubuntu 20.04, tendrás que ejecutar el comando sudo apt install mariadb-server.

Paso 4. Configura la base de datos

Después de la instalación, configura el servidor MariaDB especificando los datos de acceso, la configuración de seguridad y otros parámetros de la base de datos.

Paso 5. Inicia MariaDB

Inicia el servicio del servidor MariaDB. En Windows se hace a través del Administrador de servicios. En Linux y macOS, funciona a través de la línea de comandos con sudo systemctl start mariadb o sudo service mariadb start.

Paso 6. Realiza la configuración inicial

Configura MariaDB después de iniciarlo, ejecutando el comando mysql_secure_installation. El comando te ayuda a realizar configuraciones de seguridad importantes, como establecer contraseñas y eliminar cuentas de prueba.

Paso 7. Prueba el acceso a la base de datos

Comprueba que puedes conectarte correctamente a la base de datos. Inicia sesión como usuario root con mysql -u root -p. Introduce tu contraseña y ejecuta algunas consultas SQL sencillas para verificar que el servidor funciona correctamente.

Opción 2. Utilizar MariaDB SkySQL

MariaDB SkySQL es una plataforma de base de datos en la cloud que te permite operar bases de datos MariaDB de manera sencilla y eficiente en la cloud. La plataforma incluye MariaDB Enterprise Server y ofrece diversas ventajas, como la escalabilidad automática, una alta disponibilidad y funciones de seguridad integradas.

Paso 1. Regístrate e inicia sesión

Visita la página web oficial de MariaDB SkySQL y regístrate para conseguir una cuenta si aún no tienes una. Inicia sesión con tus credenciales.

Paso 2. Crea un nuevo servicio

Después de iniciar sesión, serás redirigido a la página de inicio de SkySQL. Haz clic en “Crear nuevo servicio” o en un botón similar para iniciar un nuevo servicio de base de datos. Selecciona el tipo de servicio que quieras, puedes elegir entre diferentes plataformas MariaDB, como MariaDB Enterprise Server y otros servicios de base de datos.

Paso 3. Configura el servicio

Personaliza la configuración del servicio, incluyendo la selección de la versión de MariaDB, la capacidad de la base de datos y otros parámetros de recursos. También puedes utilizar las opciones de alta disponibilidad y escalabilidad automática. Especifica la configuración de autenticación y seguridad, incluyendo los nombres de usuario y las contraseñas, así como la gestión de los permisos de acceso a la base de datos.

Paso 4. Conéctate a la base de datos

Tras la puesta en marcha del servicio, recibirás información sobre el nombre del host, el puerto, el nombre de usuario y la contraseña. Utiliza esta información para conectarte a tu base de datos. Ejecuta algunas consultas sencillas para verificar que el servicio funciona.

Paso 5. Monitoriza y gestiona la base de datos

MariaDB SkySQL ofrece herramientas de monitorización y análisis que te permiten supervisar el rendimiento de tu base de datos. Utiliza estas herramientas para asegurarte de que tu base de datos funciona de forma óptima. Puedes gestionar y escalar tu base de datos en función de tus necesidades, ajustando los parámetros de recursos o activando funciones adicionales.

Conectar con el servidor MariaDB

Utiliza la librería MariaDB de Python para conectarte a una base de datos MariaDB y realizar diversas operaciones con ella, como consultar, insertar o actualizar datos. Instala la librería con el gestor de paquetes pip:

pip3 install mariadb

Ahora puedes conectarte a MariaDB desde Python.

Paso 1. Establece la conexión

Primero necesitas importar la librería y establecer una conexión con tu base de datos MariaDB. Para ello, necesitas información como el nombre del host, el puerto, el nombre de la base de datos, el nombre de usuario y la contraseña.

import mariadb
db_config = {
    'user': 'your_username',
    'password': 'your_password',
    'host': 'your_hostname',
    'database': 'your_database',
    'port': 3306  # Puerto predeterminado para MariaDB
}
# Establecer la conexión
conn = mariadb.connect(**db_config)
# Crear un cursor para ejecutar consultas
cursor = conn.cursor()

El cursor es un objeto que puedes utilizar para realizar operaciones en la base de datos relacional como MariaDB. Las operaciones incluyen consultas SQL y edición de datos. Después de establecer una conexión con la base de datos, recibes un cursor en Python. Se consulta a través de la función cursor().

Paso 2. Consulta datos

A continuación, utiliza el cursor para ejecutar consultas SQL y recuperar datos de la base de datos.

# Definir la consulta SQL
sql_query = "SELECT * FROM your_table"
# Ejecutar la consulta
cursor.execute(sql_query)
# Obtener resultados
results = cursor.fetchall()
# Mostrar datos
for row in results:
    print(row)

Paso 3. Introduce datos

Para introducir datos en una tabla, define una consulta SQL INSERT y ejecútala con el cursor.

# Definir la consulta SQL INSERT
insert_query = "INSERT INTO your_table (column1, column2) VALUES (%s, %s)"
# Valores a insertar
values = ('value1', 'value2')
# Ejecutar la consulta INSERT
cursor.execute(insert_query, values)
# Confirmar la transacción
conn.commit()

La sentencia SQL INSERT especifica en qué tabla (your_table) y en qué columnas (column1 y column2) quieres insertar los datos. Los marcadores de posición como %s representan los valores que se van a insertar. La tupla values contiene los valores correspondientes que quieres introducir en la base de datos. El cursor ejecuta la sentencia INSERT con los valores especificados. A continuación, la función conn.commit() confirma la transacción para garantizar que los cambios se guardan de forma permanente en la base de datos.

Paso 4. Cierra la conexión

Una vez completadas tus operaciones con la base de datos, debes cerrar el cursor y la conexión para liberar recursos.

# Cierra el cursor y la conexión
cursor.close()
conn.close()

Paso 5. Gestiona los errores

Es importante incluir la gestión de errores para poder detectar posibles excepciones al establecer la conexión o ejecutar las consultas.

try:
        # Establecer la conexión
        conn = mariadb.connect(**db_config)
        # Crear un cursor
        cursor = conn.cursor()
        # Ejecutar la consulta
        cursor.execute(sql_query)
        # Obtener resultados
        results = cursor.fetchall()
        for row in results:
            print(row)
    except mariadb.Error as err:
        print(f"Error: {err}")
    finally:
        # Cerrar cursor y conexión
        if cursor:
            cursor.close()
        if conn:
            conn.close()

Puedes adaptar esta estructura básica a tus necesidades específicas para implementar diversas operaciones de base de datos.

Aquí tienes el código completo:

import mariadb
# Detalles de la conexión a la base de datos
db_config = {
    'user': 'your_username',
    'password': 'your_password',
    'host': 'your_hostname',
    'database': 'your_database',
    'port': 3306  # Puerto predeterminado para MariaDB
}
try:
    # Establecer la conexión
    conn = mariadb.connect(**db_config)
    # Crear un cursor para ejecutar consultas
    cursor = conn.cursor()
    # Definir la consulta SQL
    sql_query = "SELECT * FROM your_table"
    # Ejecutar la consulta
    cursor.execute(sql_query)
    # Obtener los resultados
    results = cursor.fetchall()
    # Mostrar los datos
    for row in results:
        print(row)
    # Definir la consulta SQL INSERT
    insert_query = "INSERT INTO your_table (column1, column2) VALUES (%s, %s)"
    # Valores a insertar
    values = ('value1', 'value2')
    # Ejecutar la consulta INSERT
    cursor.execute(insert_query, values)
    # Confirmar la transacción
    conn.commit()
except mariadb.Error as err:
    print(f"Error: {err}")
finally:
    # Cerrar el cursor y la conexión
    if cursor:
        cursor.close()
    if conn:
        conn.close()