rsundqvist/sakila-preload

Sakila 预加载数据库 Docker 镜像

镜像概述和主要用途

Sakila 镜像为 Docker 容器预加载了 Sakila DVD 租赁数据库，支持 MySQL、PostgreSQL 和 SQL Server 三种数据库 dialect。本镜像旨在解决新容器启动时数据库数据加载耗时（通常需 5 分钟以上）的问题，可快速提供包含完整测试数据的数据库环境。

源码请参见 https://github.com/rsundqvist/id-translation/tree/master/tests/dvdrental/docker%E3%80%82

核心功能和特性

• 预加载数据：容器启动时无需等待数据导入，直接使用完整的 Sakila 数据库，大幅缩短环境准备时间。
• 多数据库支持：提供 MySQL、PostgreSQL 和 SQL Server 三种数据库的预加载镜像，满足不同 dialect 需求。
• 统一凭据配置：各数据库镜像使用统一的访问密码和标准化的连接方式，简化开发测试流程。
• 验证工具：提供 db-tests 镜像，用于快速验证数据库是否就绪及数据完整性。

使用场景和适用范围

• 开发与测试环境：快速搭建包含真实数据结构和样本数据的数据库环境，加速应用开发和测试。
• 数据库功能验证：验证不同数据库 dialect 对 SQL 语法、函数的支持情况，或测试跨数据库兼容性。
• 学习与演示：作为数据库学习、SQL 练习或功能演示的示例数据库，无需手动导入数据。

详细使用方法和配置说明

验证数据库就绪状态

如需验证数据库容器是否成功启动并就绪，可运行以下命令（需确保数据库容器端口按表格配置，否则验证会失败）：

bash
docker run --network=host --rm rsundqvist/sakila-preload:db-tests

该命令通过运行 https://github.com/rsundqvist/id-translation/tree/master/tests/dvdrental/docker/tests/test_dialects.py 脚本，对数据库连接及数据完整性进行检查。端口配置基于 GitHub 仓库中的 https://github.com/rsundqvist/id-translation/tree/master/tests/dvdrental/docker/docker-compose.yml%EF%BC%8C%E5%A6%82%E9%9C%80%E8%87%AA%E5%AE%9A%E4%B9%89%E7%AB%AF%E5%8F%A3%EF%BC%8C%E9%9C%80%E5%90%8C%E6%AD%A5%E8%B0%83%E6%95%B4 db-tests 镜像的验证配置。

凭据与连接字符串

基线连接字符串

{dialect}+{driver}://{user}:Sofia123!@localhost:{port}/sakila

数据库配置详情

说明：所有镜像的访问密码统一为 Sofia123!。完整凭据信息可参考 GitHub 仓库中的 https://github.com/rsundqvist/id-translation/tree/master/tests/dvdrental/docker/credentials.yml%E3%80%82

Docker 部署示例

MySQL

bash
docker run -p 5001:3306 --rm rsundqvist/sakila-preload:mysql

PostgreSQL

bash
docker run -p 5002:5432 --rm rsundqvist/sakila-preload:postgres

SQL Server

bash
docker run -p 5003:1433 --rm rsundqvist/sakila-preload:mssql

数据来源说明

• MySQL 数据库的数据来源于 MySQL 官方示例（对应 Sakila 样本数据库）。
• PostgreSQL 和 SQL Server 数据库的数据来源于 https://github.com/jOOQ/sakila%E3%80%82
• db-tests 镜像使用 MySQL 版本作为基线进行数据一致性校验。