1maa/sakila

1maa/sakila:latest 镜像文档

1. 镜像概述与主要用途

1maa/sakila:latest 是基于 1maa/mysql:8.0 构建的 Docker 镜像，预加载了 MySQL 官方提供的 Sakila 示例数据库。该镜像的主要用途是提供开箱即用的 Sakila 数据库环境，无需手动导入数据，可直接用于数据库学习、应用测试或开发环境搭建。

2. 核心功能与特性

• 基于 MySQL 8.0：继承 1maa/mysql:8.0 的基础环境，兼容 MySQL 8.0 语法及特性。
• 预加载 Sakila 数据库：包含完整的 Sakila 表结构（如演员、电影、客户、租赁记录等）和示例数据，无需手动执行 SQL 导入。
• 即开即用：启动容器后自动初始化数据库，无需额外配置即可访问预填充的 Sakila 数据。
• 支持标准 MySQL 配置：可通过环境变量或配置文件自定义 MySQL 运行参数（如端口、用户权限等）。

3. 使用场景与适用范围

• 数据库学习：用于理解关系型数据库设计（如表关系、外键约束）、SQL 查询编写（如联表查询、聚合函数）等。
• 应用测试：快速搭建含真实业务场景数据的 MySQL 环境，测试应用与数据库的交互逻辑（如 CRUD 操作、事务处理）。
• 开发环境：为开发人员提供一致的示例数据库环境，避免因数据缺失导致的开发障碍。

4. 使用方法与配置说明

4.1 快速启动（docker run）

通过以下命令启动容器，自动创建并运行预加载 Sakila 数据库的 MySQL 服务：

bash
docker run -d \
  -e MYSQL_ROOT_PASSWORD=root \  # 必选：设置 MySQL root 用户密码
  -p 127.0.0.1:3306:3306 \       # 可选：映射本地端口（格式：本地端口:容器端口）
  --name sakila \                # 可选：自定义容器名称
  1maa/sakila:latest

参数说明：

• -d：后台运行容器。
• -e MYSQL_ROOT_PASSWORD=root：设置 MySQL root 用户的密码（必填，否则容器启动失败）。
• -p 127.0.0.1:3306:3306：将容器内 MySQL 默认端口（3306）映射到本地端口（示例中为 127.0.0.1:3306，避免端口冲突）。
• --name sakila：自定义容器名称为 sakila，方便后续管理（如停止、重启）。

4.2 连接数据库

容器启动后，可通过 MySQL 客户端连接到 Sakila 数据库：

bash
# 使用本地 MySQL 客户端连接（需提前安装 mysql-client）
mysql -h 127.0.0.1 -P 3306 -u root -p

输入启动时设置的 MYSQL_ROOT_PASSWORD（示例中为 root），登录后执行以下命令切换到 Sakila 数据库：

sql
USE sakila;  # 切换至预加载的 Sakila 数据库

验证数据是否加载成功：

sql
SELECT COUNT(*) FROM film;  # 应返回 1000（Sakila 示例数据中的电影总数）

4.3 Docker Compose 配置示例

通过 docker-compose.yml 配置文件管理容器（适用于多服务环境）：

yaml
version: '3'
services:
  sakila-db:
    image: 1maa/sakila:latest
    container_name: sakila
    environment:
      MYSQL_ROOT_PASSWORD: root  # 必选：root 用户密码
      # 可选：自定义其他 MySQL 环境变量（继承自 1maa/mysql:8.0）
      # MYSQL_USER: test_user      # 创建额外用户
      # MYSQL_PASSWORD: test_pwd   # 额外用户密码
    ports:
      - "127.0.0.1:3306:3306"  # 端口映射
    restart: unless-stopped  # 容器退出时自动重启（除非手动停止）

启动命令：

bash
docker-compose up -d  # 后台启动服务

4.4 环境变量说明

该镜像继承 1maa/mysql:8.0 的所有环境变量，核心配置如下：

5. 数据库架构

Sakila 数据库采用典型的关系型设计，核心表结构包括：

• actor：存储演员信息（如演员 ID、姓名）。
• film：存储电影信息（如电影 ID、标题、描述、时长）。
• category：存储电影分类（如动作、喜剧）。
• customer：存储客户信息（如姓名、***、地址）。
• rental：存储租赁记录（如租赁 ID、客户 ID、电影库存 ID、租赁/归还时间）。

完整架构图及表关系可参考 MySQL 官方文档。

6. 注意事项

• 数据持久化：默认情况下，容器内数据存储在临时文件系统，容器删除后数据丢失。如需持久化，可通过 -v 参数挂载本地目录至容器内 /var/lib/mysql（如 -v ./mysql-data:/var/lib/mysql）。
• 端口冲突：若本地 3306 端口已被占用，需修改端口映射（如 -p 127.0.0.1:3307:3306）。
• 安全性：生产环境中需避免使用简单密码（如示例中的 root），并限制端口映射范围（如仅绑定 127.0.0.1 而非公网 IP）。