Beekeeper Studio 查询魔法：让SQL查询结果展示更优雅-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00714/article/details/148374607

Beekeeper Studio 查询魔法：让SQL查询结果展示更优雅

beekeeper-studio beekeeper-studio/beekeeper-studio: Beekeeper Studio 是一款开源的跨平台数据库客户端工具，支持多种数据库（如MySQL, PostgreSQL, SQLite等），提供简洁直观的图形界面进行数据库查询、数据编辑和可视化操作。项目地址: https://gitcode.com/gh_mirrors/be/beekeeper-studio

什么是查询魔法(Query Magics)

在数据库管理工具Beekeeper Studio中，查询魔法(Query Magics)是一项强大的功能，它允许开发者通过简单的列名修饰，就能实现复杂的数据展示效果。这项功能特别适合那些希望在SQL查询结果中直接获得格式化输出的用户，无需编写额外的应用程序代码。

查询魔法的核心优势

查询魔法的主要价值在于：

简化开发流程：直接在SQL查询中定义展示格式，省去后端或前端处理步骤
提升可读性：将原始数据转换为更直观的展示形式
增强交互性：为结果添加点击行为，如跳转链接、发送邮件等

查询魔法使用详解

基本语法

查询魔法的使用非常简单，只需在SQL查询的列别名后添加特定格式的后缀：

SELECT 原始列名 AS 列别名__format__魔法类型[__参数1[__参数2]]

实际应用示例

1. 链接格式化

-- 将URL显示为可点击链接
SELECT url AS url__format__link FROM websites;

2. 电子邮件格式化

-- 将电子邮件显示为可点击的邮件链接
SELECT email AS email__format__email FROM users;

3. 图片展示

-- 将URL显示为图片(默认大小)
SELECT image_url AS image__format__image FROM products;

-- 自定义图片宽度
SELECT image_url AS image__format__image__150 FROM products;

-- 自定义图片宽高
SELECT image_url AS image__format__image__150__100 FROM products;

4. 货币格式化

-- 美元格式化(默认)
SELECT price AS price__format__money FROM orders;

-- 英镑格式化
SELECT price AS price__format__money__gbp FROM orders;

5. 进度条展示

-- 0-100范围(默认)
SELECT completion AS completion__format__progress FROM tasks;

-- 0-10范围
SELECT completion AS completion__format__progress__10 FROM tasks;

6. 星级评分

-- 0-5星(默认)
SELECT rating AS rating__format__stars FROM reviews;

-- 0-10星
SELECT rating AS rating__format__stars__10 FROM reviews;

7. 复选框展示

-- 1显示为✓，0显示为✗
SELECT is_active AS active__format__check FROM accounts;

高级功能：自定义枚举映射

查询魔法提供了强大的枚举映射功能，可以将数据库中的ID值转换为更有意义的文本描述。

配置步骤

在Beekeeper Studio的用户数据目录中创建enums.json文件
按照指定格式定义枚举类型和映射关系
在查询中使用__format__enum__枚举名语法

枚举配置示例

[
  {
    "name": "user_role",
    "variants": [
      {"id": "1", "value": "管理员"},
      {"id": "2", "value": "编辑"},
      {"id": "3", "value": "查看者"}
    ]
  }
]

查询使用示例

SELECT 
  user_id AS id,
  role_id AS role__format__enum__user_role 
FROM user_roles;

表关联跳转功能

查询魔法还支持在结果中创建可点击的表关联跳转，类似于外键关系导航：

-- 跳转到用户表的主键
SELECT user_id AS user__goto__users FROM orders;

-- 跳转到指定schema的用户表
SELECT user_id AS user__goto__public__users FROM orders;

-- 带条件跳转(显示某用户的所有订单)
SELECT user_id AS orders__goto__orders__user_id FROM users;