如何将 SQLite 查询结果格式化为列标题的查询结果

本文将介绍如何在 SQLite 中将查询结果格式化为带列标题的形式，包括使用 SQL 语句和其他工具的方法。

发布于

在数据分析、报表生成和日常数据库管理中，我们经常需要将查询结果以更加直观的"列标题+数值"的形式呈现，而不是标准的表格格式。这种展示方式特别适合数据展示、报告生成和快速查看单条记录的详细信息。SQLite 提供了多种灵活的方法来实现这种格式化输出，本文将详细介绍这些实用技巧。

使用字符串连接基础格式化

最简单的格式化方法是通过字符串连接将列名和值组合在一起：

SELECT
  'ID: ' || id || ', Name: ' || name || ', Age: ' || age AS formatted_result
FROM employees
WHERE id = 1;

这种查询会返回类似 ID: 1, Name: John, Age: 28 的结果。虽然简单，但对于快速查看数据非常实用。

利用 printf 实现对齐格式化

printf 函数可以创建更整齐的格式化输出：

SELECT printf("%-10s: %s\n%-10s: %d\n%-10s: %.2f",
              'Name', name,
              'Age', age,
              'Salary', salary) AS employee_info
FROM employees
WHERE id = 1;

输出示例：

Name      : John
Age       : 28
Salary    : 4500.00

printf 的格式说明符 %-10s 表示左对齐且固定宽度为 10 个字符，确保各字段对齐。

动态生成所有列的格式化结果

对于需要显示表中所有列的情况，可以使用 SQLite 的系统表 pragma_table_info 动态构建查询：

SELECT
  (SELECT group_concat(printf("%-12s: %s", name,
    CASE WHEN typeof(name) = 'integer' THEN printf("%d", "||name||")
         WHEN typeof(name) = 'real' THEN printf("%.2f", "||name||")
         ELSE coalesce("||name||", 'NULL') END), char(10))
   FROM pragma_table_info('employees')
   WHERE cid > 0) AS formatted_columns
FROM employees
WHERE id = 1;

这个查询会自动适应表结构变化，为每列生成格式化的 列名: 值 输出。

创建自定义格式化视图

对于频繁使用的格式化需求，可以创建专门的视图：

CREATE VIEW formatted_employee AS
SELECT id,
       printf("Name: %s\nDepartment: %s\nHire Date: %s",
              name, department, hire_date) AS profile
FROM employees;

使用时只需查询视图即可获得格式化结果：

SELECT profile FROM formatted_employee WHERE id = 1;

处理 NULL 值和特殊字符

完善的格式化应该正确处理 NULL 值和特殊字符：

SELECT printf("%-12s: %s", 'Name', coalesce(name, 'N/A')) || char(10) ||
       printf("%-12s: %s", 'Email', coalesce(email, 'Not set')) AS contact_info
FROM employees;

coalesce 函数确保 NULL 值被适当替换，char(10) 添加换行符。

生成 HTML 或 Markdown 格式

可以进一步生成结构化格式：

-- Markdown格式
SELECT '**' || name || '**' || char(10) ||
       '- Department: ' || department || char(10) ||
       '- Extension: ' || coalesce(extension, 'None') AS md_profile
FROM employees;

-- HTML格式
SELECT '<div class="profile"><h3>' || name || '</h3><ul>' ||
       '<li>Title: ' || title || '</li>' ||
       '<li>Phone: ' || coalesce(phone, 'N/A') || '</li></ul></div>' AS html_profile
FROM employees;

总结

SQLite 提供了多种灵活的方法将查询结果格式化为"列标题+数值"的形式。简单的字符串连接适合快速查看，printf 可以实现专业对齐，动态查询适应表结构变化，而视图则能封装复杂格式化逻辑。根据你的具体需求选择合适的方法——日常调试可以用简单格式，正式报告则需要更完善的解决方案。无论哪种方式，都要注意处理 NULL 值和确保输出清晰易读，这样才能充分发挥格式化输出的价值。