Conexión y Creación de la Base de Datos en Python con SQLite| Capítulo 4

En SQLite, la base de datos es un archivo ordinario en el sistema de archivos. La “creación” de la base de datos es, por tanto, una operación implícita que ocurre al intentar conectarse a una ruta que no existe, a menos que se especifiquen banderas de modo restrictivas.

4.1. Estrategias de Persistencia y Rutas

Desde una perspectiva de ingeniería, el manejo de rutas debe ser agnóstico al sistema operativo. Se recomienda el uso de pathlib sobre el módulo os para garantizar la resolución correcta de rutas absolutas y la creación de directorios padres antes de la instanciación.

• Archivo Físico: Recomendado para persistencia a largo plazo.
• Memoria RAM (:memory:): Ideal para procesos efímeros de alta velocidad, cachés volátiles o pruebas de integración donde la persistencia post-ejecución es irrelevante.

import sqlite3
from pathlib import Path
from sqlite3 import Error

def get_connection(db_location: str = "production.db") -> sqlite3.Connection:
    """
    Gestiona la creación de la base de datos y devuelve un objeto de conexión.
    Asegura la compatibilidad de rutas en entornos Linux y Windows.
    """
    try:
        # Resolución de ruta absoluta para evitar ambigüedades de contexto
        db_path = Path(db_location).resolve()

        # Asegurar la existencia del directorio contenedor
        db_path.parent.mkdir(parents=True, exist_ok=True)

        # Conexión con soporte para URI (Uniform Resource Identifier)
        # Permite configurar el modo de apertura de forma declarativa (Read/Write/Create)
        conn = sqlite3.connect(f"file:{db_path}?mode=rwc", uri=True)
        return conn
    except Error as e:
        # En arquitecturas de producción, el error se propaga tras el registro 
        # para que la lógica de aplicación decida la estrategia de recuperación.
        raise RuntimeError(f"Fallo crítico en la capa de persistencia: {e}")

import sqlite3
from pathlib import Path
from sqlite3 import Error

def get_connection(db_location: str = "production.db") -> sqlite3.Connection:
    """
    Gestiona la creación de la base de datos y devuelve un objeto de conexión.
    Asegura la compatibilidad de rutas en entornos Linux y Windows.
    """
    try:
        # Resolución de ruta absoluta para evitar ambigüedades de contexto
        db_path = Path(db_location).resolve()

        # Asegurar la existencia del directorio contenedor
        db_path.parent.mkdir(parents=True, exist_ok=True)

        # Conexión con soporte para URI (Uniform Resource Identifier)
        # Permite configurar el modo de apertura de forma declarativa (Read/Write/Create)
        conn = sqlite3.connect(f"file:{db_path}?mode=rwc", uri=True)
        return conn
    except Error as e:
        # En arquitecturas de producción, el error se propaga tras el registro 
        # para que la lógica de aplicación decida la estrategia de recuperación.
        raise RuntimeError(f"Fallo crítico en la capa de persistencia: {e}")

4.2. Gestión del Ciclo de Vida: El Equívoco del Context Manager

Es fundamental distinguir cómo sqlite3 implementa el protocolo de administración de contexto. A diferencia de otros manejadores de recursos en Python (como open()), el bloque with connection: no cierra la conexión al finalizar.

Su función es estrictamente transaccional:

1. Inicia una transacción al entrar al bloque.
2. Ejecuta un COMMIT si el bloque finaliza sin excepciones.
3. Ejecuta un ROLLBACK si se lanza cualquier excepción durante el proceso.

Patrón recomendado para evitar fugas de memoria:
Para liberar los descriptores de archivo y evitar bloqueos persistentes (especialmente en entornos Linux), la conexión debe cerrarse explícitamente en un bloque finally.

conn = get_connection()
try:
    with conn:
        # La transacción se maneja automáticamente aquí
        conn.execute("INSERT INTO log (event) VALUES (?)", ("init_session",))
finally:
    # Garantiza la liberación del recurso
    conn.close()

conn = get_connection()
try:
    with conn:
        # La transacción se maneja automáticamente aquí
        conn.execute("INSERT INTO log (event) VALUES (?)", ("init_session",))
finally:
    # Garantiza la liberación del recurso
    conn.close()

4.3. Control de Acceso mediante URIs

El uso de URIs en connect() permite un control granular sin recurrir a comandos PRAGMA adicionales para el estado inicial de la conexión: