如何在 SQLite 中以垂直格式显示查询结果

当我们在 SQLite 中处理包含多列或长文本数据的查询结果时，传统的水平表格显示方式往往会显得拥挤不堪，难以阅读。垂直格式显示提供了一种更加清晰的数据查看方式，特别适合分析复杂查询结果或调试数据问题。本文将详细介绍在 SQLite 中实现垂直格式显示的各种方法，帮助你轻松提升数据查看体验。

为什么需要垂直格式显示

想象一下你正在查看一个包含 10 列的用户数据表，其中某些列存储着长文本或 JSON 数据。传统的水平显示方式会让你的终端窗口充斥着换行文本，不得不左右滚动才能看到完整数据。垂直格式显示改变了这种状况，它：

将每行数据转换为键值对形式展示
每个字段单独一行显示
特别适合宽表和长文本字段
使数据关系更加清晰可见
方便复制特定字段值

这种显示方式在 MySQL 中类似 \G 命令的效果，而在 SQLite 中我们也有对应的实现方法。

使用 SQLite 命令行工具的 .mode 命令

SQLite 的原生命令行工具提供了灵活的显示模式控制，通过 .mode 命令可以轻松切换到垂直格式：

.mode line
SELECT * FROM employees WHERE id = 1001;

执行结果会以如下格式显示：

       id = 1001
     name = 张伟
department = 技术部
    salary = 8500
 hire_date = 2020-05-15

.mode line 是 SQLite 命令行工具中最常用的垂直显示方式，其他可用模式还包括：

.mode column：默认的水平表格模式
.mode list：以分隔符分隔的列表模式
.mode json：JSON 格式输出

自定义垂直显示格式

如果你对默认的 line 模式格式不满意，可以通过 .mode 结合其他命令进一步自定义：

.headers on
.mode line
.separator " | "
.nullvalue NULL
SELECT * FROM orders WHERE amount > 1000;

这些配置命令的作用：

.headers on 显示列名
.separator 定义字段间的分隔符
.nullvalue 指定 NULL 值的显示文本

通过 PRAGMA 设置默认显示模式

如果你希望每次打开 SQLite 命令行都自动使用垂直格式，可以设置以下 PRAGMA：

PRAGMA table_info(employees);
.mode line
PRAGMA user_version = 1; -- 记住当前设置

注意这种方法需要在每次会话中设置，因为 PRAGMA 设置通常是临时的。对于持久化配置，可以考虑将这些命令写入 .sqliterc 配置文件。

在应用程序中实现垂直格式

如果你在 Python、Java 等应用程序中使用 SQLite，可以通过结果集处理实现垂直格式显示。以下是 Python 示例：

import sqlite3

def print_vertical(cursor, query):
    cursor.execute(query)
    columns = [desc[0] for desc in cursor.description]
    for row in cursor:
        for col, value in zip(columns, row):
            print(f"{col:15} = {str(value):}")
        print("-" * 30)

conn = sqlite3.connect("company.db")
print_vertical(conn.cursor(), "SELECT * FROM departments")

处理复杂数据类型的垂直显示

当表中包含 BLOB、JSON 等复杂数据类型时，垂直显示尤其有用：

.mode line
SELECT id, name, json_extract(meta, '$.projects') AS projects
FROM employees
WHERE json_valid(meta);

这样的显示方式可以清晰展现 JSON 结构，而不像水平显示那样所有内容挤在一起。

结合其他命令增强可读性

垂直格式可以与其他 SQLite 命令结合，创造更强大的数据查看体验：

-- 先查看表结构，再垂直显示数据
.schema employees
.mode line
SELECT * FROM employees LIMIT 1;

或者使用计时功能分析查询性能：

.timer on
.mode line
EXPLAIN QUERY PLAN SELECT * FROM large_table WHERE category = 'A';

垂直格式的局限性

虽然垂直格式显示有很多优点，但也存在一些限制：

不适合记录数很多的查询结果（会占用大量垂直空间）
某些图形化工具可能不支持这种显示模式
导出数据时不如 CSV 等格式方便
对宽表（字段特别多的表）仍然需要滚动查看

总结

SQLite 中的垂直格式显示是数据分析师和开发者的强大工具，它通过 .mode line 命令将传统的水平表格转换为更易读的键值对形式。无论是调试复杂查询、查看宽表结构，还是分析包含长文本的字段，垂直显示都能显著提升你的工作效率。

记住，你可以在 SQLite 命令行中随时切换 .mode column 和 .mode line 来适应不同场景的需求。对于应用程序中的实现，通过简单的代码就能处理结果集实现类似效果。掌握垂直格式显示技巧，你的 SQLite 数据探索体验将变得更加顺畅和高效。