Beekeeper Studio 仓库中的 Sakila 样本数据库MySQL 版本兼容的派生与落地实践【免费下载链接】beekeeper-studioModern and easy to use SQL client for MySQL, Postgres, SQLite, SQL Server, and more. Linux, MacOS, and Windows.项目地址: https://gitcode.com/GitHub_Trending/be/beekeeper-studioSakila 是 MySQL 官方文档提供的经典样本数据库用于演示表、视图、触发器、存储过程与函数等核心特性。本文以 Beekeeper Studio 开源仓库中 dev/docker_mysql_init/sakila/README.md 的说明为主线讲解这份从 Sakila-spatial 派生的「multi-versionmv」版本如何通过 MySQL 条件注释语法同时兼容 5.6/5.7 两代特性并结合仓库内的 schema 文件、docker-compose 配置 与演示连接代码说明如何在本地 Docker 环境与 Beekeeper Studio 中把它用起来。读完本文你将掌握 Sakila 库的完整结构、/*!N ... */版本化 SQL 的写法与含义以及一条从「初始化脚本」到「GUI 连接演示」的完整落地路径。一、这份 README 说明了什么Sakila-spatial 的派生与两项关键改动仓库内的 README.md 全文非常简短核心信息只有三点该样本数据库派生自 Sakila-spatial 数据库后者来自 MySQL 官方文档示例库集合派生时做了非常简单的两处改动两处改动分别是InnoDB 的 FULLTEXT 索引按条件添加仅对 MySQL 5.6 生效GEOMETRY 列与 SPATIAL 索引按条件添加仅对 MySQL 5.7 生效。这两条改动直接决定了sakila-mv-*中mvmulti-version的含义同一份 SQL 脚本在不同版本的 MySQL 上执行时会得到不同的行为——低版本自动跳过不支持的特性高版本自动获得完整能力。这种「一份脚本、多版本兼容」的做法正是该样本库被选作 Beekeeper Studio 演示与回归测试数据源的重要原因。从源码确认两处改动的具体落点在 sakila-mv-schema.sql 中两处改动都有明确的代码注释与版本号标记空间数据对应改动 2MySQL 5.7.5CREATE TABLE address ( ... /*!50705 location GEOMETRY NOT NULL,*/ ... /*!50705 SPATIAL KEY idx_location (location),*/ ... )ENGINEInnoDB DEFAULT CHARSETutf8;FULLTEXT / InnoDB对应改动 1MySQL 5.6.10CREATE TABLE film_text ( film_id SMALLINT NOT NULL, title VARCHAR(255) NOT NULL, description TEXT, PRIMARY KEY (film_id), FULLTEXT KEY idx_title_description (title,description) )ENGINEMyISAM DEFAULT CHARSETutf8; -- After MySQL 5.6.10, InnoDB supports fulltext indexes /*!50610 ALTER TABLE film_text engineInnoDB */;需要注意的是film_text表本身在MyISAM引擎下就声明了FULLTEXT KEYMyISAM 长期支持全文索引而改动 1 的实质是在 MySQL 5.6.10 之后通过/*!50610 */条件注释把整张表ALTER 为 InnoDB 引擎从而让 InnoDB 全文索引能力被启用。这与 README 中「InnoDB 的 FULLTEXT 索引按条件添加MySQL 5.6」的描述完全对应。二、版本条件执行语法/*!N ... */的原理上述两处改动都依赖 MySQL 特有的**可执行版本注释versioned comments**语法。其格式为/*!N SQL语句 */N是 5 位或 6 位版本号例如50610表示 MySQL 5.6.1050705表示 MySQL 5.7.5当当前服务器版本 ≥ N时注释内的 SQL 会被当作真实语句执行当当前服务器版本 N时整段内容被当作普通注释忽略。这解释了仓库选择该语法的动机官方 Sakila-spatial 假定较新的 MySQL 版本直接导入旧版本会因GEOMETRY类型或SPATIAL KEY不支持而报错而套上版本注释后脚本可以在「任何 MySQL 5.x 版本」上导入——这一点在 schema 文件头部也有明确记录Modified in September 2015 by Giuseppe Maxia注释为The schema and data can now be loaded by any MySQL 5.x version。Schema 文件开头的三条SET也保证了多版本下的安全执行SET OLD_UNIQUE_CHECKSUNIQUE_CHECKS, UNIQUE_CHECKS0; SET OLD_FOREIGN_KEY_CHECKSFOREIGN_KEY_CHECKS, FOREIGN_KEY_CHECKS0; SET OLD_SQL_MODESQL_MODE, SQL_MODETRADITIONAL;先关闭唯一性检查与外键检查再用TRADITIONAL严格模式建表文件末尾再统一恢复现场sakila-mv-schema.sql保证导入过程对既有会话状态无副作用。三、完整 schema 盘点16 张表 6 个视图 触发器 存储过程与函数除版本兼容改动外schema 主体完整继承了 Sakila-spatial 的业务模型非常适合作为 SQL 学习与 GUI 客户端功能验证的载体。从 sakila-mv-schema.sql 的 650 行脚本中可以梳理出以下组成3.1 表结构InnoDButf8表关键字段 / 特色定义位置actoractor_id自增主键、last_name索引L30-L37address含条件化的location GEOMETRY与 SPATIAL 索引L43-L57category/city/country基础维度表外键级联策略ON DELETE RESTRICT ON UPDATE CASCADEL63-L93customeractive BOOLEAN、email、create_date DATETIMEL99-L115filmrating ENUM(G,PG,PG-13,R,NC-17)、special_features SET(...)、rental_rate DECIMAL(4,2)L121-L141film_actor/film_category多对多关联表复合主键L147-L168film_textFULLTEXT 全文索引 引擎条件转换改动 1 的核心L174-L183inventory/language/staff/store库存、语言、员工含picture BLOB、门店L218-L321payment/rental支付与租赁流水rental有UNIQUE KEY (rental_date, inventory_id, customer_id)L245-L282值得关注的是film表对ENUM 与 SET 类型、staff.password对VARCHAR(40) BINARY的使用以及address.location对空间类型的条件化引入——这些都是 MySQL 区别于其他数据库的典型类型特性非常适合在 Beekeeper Studio 中观察类型映射与结果展示。3.2 触发器维护film_text与film的一致性film_text不直接由业务写入而是由三个触发器自动维护L189-L212DELIMITER ;; CREATE TRIGGER ins_film AFTER INSERT ON film FOR EACH ROW BEGIN INSERT INTO film_text (film_id, title, description) VALUES (new.film_id, new.title, new.description); END;;ins_film插入film后同步插入film_textupd_film当title/description/film_id任一变化时更新film_textdel_film删除film后同步删除film_text。该设计演示了「为全文检索冗余一份文本表」的经典模式也是测试客户端触发器等对象浏览功能的现成素材。3.3 视图面向报表的封装脚本内定义了 6 个视图L327-L445customer_list顾客信息 地址城市国家连接film_list影片信息 演员名单GROUP_CONCAT拼接nicer_but_slower_film_list对演员姓名做首字母大写的「更慢但更好看」版本staff_list员工 门店视图sales_by_store/sales_by_film_category按门店、按影片分类汇总销售额的报表视图actor_info以SQL SECURITY INVOKER定义的演员影片分类汇总视图。其中film_list用GROUP_CONCAT(... SEPARATOR , )把一部影片的演员列表聚合成单行文本是理解 MySQL 聚合字符串的典型示例。3.4 存储过程与函数演示 IN/OUT 参数与业务逻辑rewards_report(min_monthly_purchases, min_dollar_amount_purchased, OUT count_rewardees)月度忠诚客户报表含参数合法性校验、临时表tmpCustomer的使用L453-L516get_customer_balance(p_customer_id, p_effective_date)计算截至某日期的客户余额租金 逾期费 − 已支付用三条SELECT ... INTO分别累计L520-L559film_in_stock(p_film_id, p_store_id, OUT p_film_count)/film_not_in_stock(...)分别调用inventory_in_stock判断某门店某影片的在库/缺货数量L565-L593inventory_held_by_customer(p_inventory_id)查询某库存当前被哪个客户持有return_date IS NULL无记录时通过EXIT HANDLER FOR NOT FOUND RETURN NULL返回空L597-L609inventory_in_stock(p_inventory_id)返回布尔值判断库存是否在架L615-L642。这些对象对于验证数据库客户端的过程/函数/触发器浏览、参数调用与结果集展示能力非常有价值。四、数据文件46,000 行的完整示例数据与 schema 配套的是 sakila-mv-data.sql共 46,434 行。数据文件的组织方式同样兼顾了多版本兼容开头同样关闭外键/唯一检查并USE sakila;结尾恢复采用SET AUTOCOMMIT0; 多行批量INSERT的方式灌入数据如 actor 表的 200 位演员数据降低导入耗时并便于事务化回滚数据内容覆盖演员、地址、影片、库存、租赁、支付等全链路业务例如经典的 1,000 部影片、200 位演员、599 位顾客等足以支撑 JOIN、聚合、子查询、空间/全文检索等各类演示 SQL。五、在 Docker 与 Beekeeper Studio 中的落地使用5.1 docker-compose 中的挂载方式仓库根目录的 docker-compose.yml 定义了多个数据库服务其中 MySQL 系服务均将./dev/docker_mysql_init目录挂载为官方镜像的初始化目录/docker-entrypoint-initdb.dmysqlmysql:5.7.22端口映射3306:3306MYSQL_ROOT_PASSWORD: example、MYSQL_DATABASE: testL197-L208mysql8mysql:8.0.21端口3308:3306并显式指定--default-authentication-pluginmysql_native_passwordL185-L196mariadbmariadb最新镜像端口3307:3306L174-L184。由于sakila-mv-*脚本位于该挂载目录下容器首次启动时会按字母序自动执行sakila-mv-schema.sql再执行sakila-mv-data.sqlMySQL 官方镜像按文件名排序执行.sql/.sh初始化脚本因此无需任何手动干预即可获得一个带完整 Sakila 数据的数据库。启动方式docker compose up -d mysql8 # 或 mysql5.7、mariadb启动后连接参数为主机localhost、端口3308mysql8/3306mysql 5.7/3307mariadb、用户名root、密码example、默认数据库test脚本执行后库内另有sakila库。注意5.7 与 8.0 两个服务的command都附加了--default-authentication-pluginmysql_native_password这是为了让老版本客户端工具含 Beekeeper Studio 的 MySQL 驱动能以传统密码认证方式直连属于仓库为兼容性做的显式配置。5.2 Beekeeper Studio 中的演示连接仓库的开发用迁移脚本 apps/studio/src/migration/dev-1.js 中注册了一组[DEV]前缀的演示连接其中包括指向上述 Docker MySQL 服务与 SQLite 的条目[DEV] Docker MySQLport: 3307、用户root、密码example、默认库employees[DEV] local SqlitedefaultDatabase: ./dev/sakila.db即本地 SQLite 形态的 Sakila 数据[DEV] Docker PSQL/[DEV] Docker SQLServer等其它数据库的演示连接。从中可以看到 Sakila 数据集在仓库中的定位同一套业务模型被复用到多种数据库形态MySQL 容器、SQLite 文件等用于开发与端到端测试时验证不同驱动下的一致性表现。你在 Beekeeper Studio 中新建 MySQL 连接时按 5.1 节的端口、账号、密码填入即可直接查询sakila库并可以用下面这类语句立刻体验视图、聚合与存储过程-- 通过视图查看影片与演员 SELECT * FROM sakila.film_list WHERE rating PG LIMIT 10; -- 分组聚合示例 SELECT c.name AS category, SUM(p.amount) AS total_sales FROM sakila.payment p JOIN sakila.rental r ON p.rental_id r.rental_id JOIN sakila.inventory i ON r.inventory_id i.inventory_id JOIN sakila.film f ON i.film_id f.film_id JOIN sakila.film_category fc ON f.film_id fc.film_id JOIN sakila.category c ON fc.category_id c.category_id GROUP BY c.name ORDER BY total_sales DESC; -- 调用存储过程需传入两个 IN 参数 CALL sakila.rewards_report(10, 20.00, cnt);六、总结dev/docker_mysql_init/sakila/目录虽然 README 只有寥寥数行但其承载的 Sakila-spatial 派生库具备完整的教学与测试价值兼容性设计通过/*!50610 */、/*!50705 */版本注释把 InnoDB 全文索引5.6与空间列/空间索引5.7做成条件特性保证任意 MySQL 5.x 可导入具体实现见 sakila-mv-schema.sql内容完备16 张表、6 个视图、3 个触发器、3 个存储过程、3 个函数覆盖 MySQL 的 ENUM/SET、BLOB、空间类型、全文索引、外键级联与GROUP_CONCAT等特性开箱即用配合 docker-compose.yml 中mysql/mysql8/mariadb服务的自动初始化挂载一条docker compose up即可在 Beekeeper Studio 中连入sakila库进行功能验证与学习。无论你是想学习 MySQL 特性、验证 SQL 客户端能力还是需要一个稳定的回归测试数据源这份「multi-version」版本的 Sakila 都是仓库中可直接复用的现成方案。【免费下载链接】beekeeper-studioModern and easy to use SQL client for MySQL, Postgres, SQLite, SQL Server, and more. Linux, MacOS, and Windows.项目地址: https://gitcode.com/GitHub_Trending/be/beekeeper-studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考