搜索快捷键 cmd + k | ctrl + k
- 安装
- 文档
- 入门
- 连接
- 数据导入
- 客户端 API
- 概览
- ADBC
- C
- C++
- CLI
- Dart
- Go
- Java (JDBC)
- Julia
- Node.js (已弃用)
- Node.js (Neo)
- ODBC
- PHP
- Python
- R
- Rust
- Swift
- Wasm
- SQL
- 介绍
- 语句
- 概览
- ANALYZE
- ALTER TABLE
- ALTER VIEW
- ATTACH 和 DETACH
- CALL
- CHECKPOINT
- COMMENT ON
- COPY
- CREATE INDEX
- CREATE MACRO
- CREATE SCHEMA
- CREATE SECRET
- CREATE SEQUENCE
- CREATE TABLE
- CREATE VIEW
- CREATE TYPE
- DELETE
- DESCRIBE
- DROP
- EXPORT 和 IMPORT DATABASE
- INSERT
- LOAD / INSTALL
- PIVOT
- 性能分析
- SELECT
- SET / RESET
- SET VARIABLE
- SUMMARIZE
- 事务管理
- UNPIVOT
- UPDATE
- USE
- VACUUM
- 查询语法
- SELECT
- FROM 和 JOIN
- WHERE
- GROUP BY
- GROUPING SETS
- HAVING
- ORDER BY
- LIMIT 和 OFFSET
- SAMPLE
- 展开嵌套
- WITH
- WINDOW
- QUALIFY
- VALUES
- FILTER
- 集合操作
- 预处理语句
- 数据类型
- 表达式
- 函数
- 概览
- 聚合函数
- 数组函数
- 位字符串函数
- Blob 函数
- 日期格式化函数
- 日期函数
- 日期部分函数
- 枚举函数
- 间隔函数
- Lambda 函数
- 列表函数
- 映射函数
- 嵌套函数
- 数值函数
- 模式匹配
- 正则表达式
- 结构体函数
- 文本函数
- 时间函数
- 时间戳函数
- 带时区时间戳函数
- 联合函数
- 实用函数
- 窗口函数
- 约束
- 索引
- 元查询
- DuckDB 的 SQL 方言
- 示例
- 配置
- 扩展
- 核心扩展
- 概览
- 自动补全
- Avro
- AWS
- Azure
- Delta
- DuckLake
- 编码
- Excel
- 全文搜索
- httpfs (HTTP 和 S3)
- Iceberg
- ICU
- inet
- jemalloc
- MySQL
- PostgreSQL
- 空间
- SQLite
- TPC-DS
- TPC-H
- UI
- VSS
- 指南
- 概览
- 数据查看器
- 数据库集成
- 文件格式
- 概览
- CSV 导入
- CSV 导出
- 直接读取文件
- Excel 导入
- Excel 导出
- JSON 导入
- JSON 导出
- Parquet 导入
- Parquet 导出
- 查询 Parquet 文件
- 使用 file: 协议访问文件
- 网络和云存储
- 概览
- HTTP Parquet 导入
- S3 Parquet 导入
- S3 Parquet 导出
- S3 Iceberg 导入
- S3 Express One
- GCS 导入
- Cloudflare R2 导入
- 通过 HTTPS / S3 使用 DuckDB
- Fastly 对象存储导入
- 元查询
- ODBC
- 性能
- Python
- 安装
- 执行 SQL
- Jupyter Notebooks
- marimo Notebooks
- Pandas 上的 SQL
- 从 Pandas 导入
- 导出到 Pandas
- 从 Numpy 导入
- 导出到 Numpy
- Arrow 上的 SQL
- 从 Arrow 导入
- 导出到 Arrow
- Pandas 上的关系型 API
- 多个 Python 线程
- 与 Ibis 集成
- 与 Polars 集成
- 使用 fsspec 文件系统
- SQL 编辑器
- SQL 功能
- 代码片段
- 故障排除
- 术语表
- 离线浏览
- 操作手册
- 开发
- 内部结构
- 为什么选择 DuckDB
- 行为准则
- 发布日历
- 路线图
- 站点地图
- 在线演示
文档 / 客户端 API / CLI
输出格式
可以使用 .mode
点命令 来改变终端输出中表的显示格式。除了自定义显示格式外,这些模式还具有额外的好处。通过将终端输出重定向到文件,这对于在其他地方展示 DuckDB 输出非常有用。使用 insert
模式将生成一系列 SQL 语句,这些语句可用于稍后插入数据。markdown
模式对于编写文档特别有用,而 latex
模式对于撰写学术论文很有用。
输出格式列表
模式 | 描述 |
---|---|
ascii |
列/行以 0x1F 和 0x1E 分隔 |
box |
使用 Unicode 框线字符的表格 |
csv |
逗号分隔值 |
column |
按列输出 (参见 .width ) |
duckbox |
功能丰富的表格(默认) |
html |
HTML <table> 代码 |
insert TABLE |
TABLE 的 SQL 插入语句 |
json |
结果以 JSON 数组形式呈现 |
jsonlines |
结果以 NDJSON 形式呈现 |
latex |
LaTeX 表格环境代码 |
line |
每行一个值 |
list |
值以 | 分隔 |
markdown |
Markdown 表格格式 |
quote |
将结果按 SQL 方式转义 |
table |
ASCII 艺术表格 |
tabs |
制表符分隔值 |
tcl |
TCL 列表元素 |
trash |
无输出 |
更改输出格式
使用普通的 .mode
点命令来查询当前使用的显示格式。
.mode
current output mode: duckbox
使用带参数的 .mode
点命令来设置输出格式。
.mode markdown
SELECT 'quacking intensifies' AS incoming_ducks;
| incoming_ducks |
|----------------------|
| quacking intensifies |
输出的显示格式也可以通过 .separator
命令进行调整。如果使用依赖分隔符的导出模式(例如 csv
或 tabs
),当模式更改时,分隔符将被重置。例如,.mode csv
会将分隔符设置为逗号 (,
)。接着使用 .separator "|"
则会将输出转换为竖线分隔。
.mode csv
SELECT 1 AS col_1, 2 AS col_2
UNION ALL
SELECT 10 AS col1, 20 AS col_2;
col_1,col_2
1,2
10,20
.separator "|"
SELECT 1 AS col_1, 2 AS col_2
UNION ALL
SELECT 10 AS col1, 20 AS col_2;
col_1|col_2
1|2
10|20
duckbox
模式
默认情况下,DuckDB 以 duckbox
模式呈现查询结果,这是一种功能丰富的 ASCII 艺术风格输出格式。
duckbox 模式支持 large_number_rendering
选项,该选项允许以人类可读的方式渲染大数字。它有三个级别:
off
– 所有数字都使用常规格式打印。footer
(默认)– 大数字会附加人类可读的格式。仅适用于单行结果。all
- 所有大数字都替换为人类可读的格式。
请参见以下示例
.large_number_rendering off
SELECT pi() * 1_000_000_000 AS x;
┌───────────────────┐
│ x │
│ double │
├───────────────────┤
│ 3141592653.589793 │
└───────────────────┘
.large_number_rendering footer
SELECT pi() * 1_000_000_000 AS x;
┌───────────────────┐
│ x │
│ double │
├───────────────────┤
│ 3141592653.589793 │
│ (3.14 billion) │
└───────────────────┘
.large_number_rendering all
SELECT pi() * 1_000_000_000 AS x;
┌──────────────┐
│ x │
│ double │
├──────────────┤
│ 3.14 billion │
└──────────────┘