an0t8/mariadb

MariaDB 10.1 with python-mysqldb 镜像文档

镜像概述

本镜像基于官方MariaDB 10.1容器构建，额外集成了python-mysqldb模块。它保留了MariaDB 10.1的全部功能特性，同时提供Python对MariaDB数据库的直接连接与操作能力，适用于需要在数据库环境中运行Python脚本进行数据处理的场景。

核心功能与特性

• 基础功能：完整继承官方MariaDB 10.1的所有功能，包括SQL查询、事务处理、用户管理、数据备份等
• Python支持：集成python-mysqldb模块，支持通过Python脚本连接并操作MariaDB数据库
• 兼容性：与官方MariaDB 10.1容器接口完全兼容，可无缝替换使用
• 轻量级：在官方镜像基础上最小化添加依赖，保持镜像体积精简

使用场景

• 需要在数据库容器内直接运行Python数据处理脚本的场景
• 开发环境中快速搭建包含Python数据库连接能力的MariaDB服务
• 小型应用中简化数据库与Python应用的部署架构
• 教学或测试环境中演示Python与MariaDB的交互操作

使用方法

基本运行命令

bash
docker run -d \
  --name mariadb-python \
  -e MYSQL_ROOT_PASSWORD=your_password \
  -p 3306:3306 \
  [镜像名称]

环境变量配置

支持官方MariaDB 10.1镜像的所有环境变量，主要包括：

• MYSQL_ROOT_PASSWORD：必填，设置root用户密码
• MYSQL_DATABASE：可选，容器启动时自动创建的数据库名称
• MYSQL_USER：可选，创建的普通用户名
• MYSQL_PASSWORD：可选，配合MYSQL_USER使用的用户密码

进入容器执行Python脚本

bash
# 进入运行中的容器
docker exec -it mariadb-python bash

# 在容器内创建并运行Python脚本
cat > test.py << EOF
import MySQLdb

# 连接数据库
db = MySQLdb.connect(
  host="localhost",
  user="root",
  passwd="your_password",
  db="testdb"
)

# 执行查询
cursor = db.cursor()
cursor.execute("SELECT VERSION()")
data = cursor.fetchone()
print("Database version : %s " % data)

# 关闭连接
db.close()
EOF

# 运行脚本
python test.py

数据持久化

为避免数据丢失，建议挂载数据卷：

bash
docker run -d \
  --name mariadb-python \
  -e MYSQL_ROOT_PASSWORD=your_password \
  -v /host/path/to/data:/var/lib/mysql \
  -p 3306:3306 \
  [镜像名称]

注意事项

• 本镜像仅在官方MariaDB 10.1基础上添加python-mysqldb依赖，其他行为与官方镜像一致
• 生产环境使用时需注意配置适当的安全策略，如限制网络访问、定期备份数据
• Python版本与python-mysqldb版本需与MariaDB 10.1兼容，建议通过容器内python --version和pip list | grep mysql确认版本信息