DuckDB CLI 专家

通过 DuckDB CLI 帮助进行数据分析、SQL 查询和文件转换。

快速开始

直接用 SQL 读取数据文件

# CSV
duckdb -c "SELECT * FROM 'data.csv' LIMIT 10"

# Parquet
duckdb -c "SELECT * FROM 'data.parquet'"

# Multiple files with glob
duckdb -c "SELECT * FROM read_parquet('logs/*.parquet')"

# JSON
duckdb -c "SELECT * FROM read_json_auto('data.json')"

打开持久化数据库

# Create/open database
duckdb my_database.duckdb

# Read-only mode
duckdb -readonly existing.duckdb

命令行参数

输出格式（作为标志）

执行参数

数据转换

CSV 转 Parquet

duckdb -c "COPY (SELECT * FROM 'input.csv') TO 'output.parquet' (FORMAT PARQUET)"

Parquet 转 CSV

duckdb -c "COPY (SELECT * FROM 'input.parquet') TO 'output.csv' (HEADER, DELIMITER ',')"

JSON 转 Parquet

duckdb -c "COPY (SELECT * FROM read_json_auto('input.json')) TO 'output.parquet' (FORMAT PARQUET)"

带筛选条件的转换

duckdb -c "COPY (SELECT * FROM 'data.csv' WHERE amount > 1000) TO 'filtered.parquet' (FORMAT PARQUET)"

点命令

模式检查

输出控制

查询

编辑

输出格式（18种可用）

数据导出

• csv- 逗号分隔，适用于电子表格
• tabs- 制表符分隔
• json- JSON 数组
• jsonlines- 换行符分隔的JSON（流式）

可读格式

• duckbox（默认）- 使用Unicode制表符绘制的美观ASCII格式
• table- 简单的ASCII表格
• markdown- 用于文档编写
• html- HTML表格
• latex- 用于学术论文

专用格式

• insert TABLE- SQL INSERT语句
• column- 宽度可调的列
• line- 每行一个值
• list- 竖线分隔
• trash- 丢弃输出

键盘快捷键（macOS/Linux）

导航

历史记录

编辑

自动补全

自动补全

上下文感知自动补全通过以下方式激活Tab键:

• 关键词- SQL命令
• 表名- 数据库对象
• 列名- 字段与函数
• 文件名- 路径补全

数据库操作

从文件创建表

CREATE TABLE sales AS SELECT * FROM 'sales_2024.csv';

插入数据

INSERT INTO sales SELECT * FROM 'sales_2025.csv';

导出表

COPY sales TO 'backup.parquet' (FORMAT PARQUET);

分析示例

快速统计

SELECT
    COUNT(*) as count,
    AVG(amount) as average,
    SUM(amount) as total
FROM 'transactions.csv';

分组

SELECT
    category,
    COUNT(*) as count,
    SUM(amount) as total
FROM 'data.csv'
GROUP BY category
ORDER BY total DESC;

文件连接

SELECT a.*, b.name
FROM 'orders.csv' a
JOIN 'customers.parquet' b ON a.customer_id = b.id;

描述数据

DESCRIBE SELECT * FROM 'data.csv';

管道与标准输入

# Read from stdin
cat data.csv | duckdb -c "SELECT * FROM read_csv('/dev/stdin')"

# Pipe to another command
duckdb -csv -c "SELECT * FROM 'data.parquet'" | head -20

# Write to stdout
duckdb -c "COPY (SELECT * FROM 'data.csv') TO '/dev/stdout' (FORMAT CSV)"

配置

保存常用设置至~/.duckdbrc:

.timer on
.mode duckbox
.maxrows 50
.highlight on

语法高亮颜色

.keyword green
.constant yellow
.comment brightblack
.error red

外部编辑器

在您的编辑器中打开复杂查询：

.edit

编辑器选自：DUCKDB_EDITOR→编辑器→可视化→vi

安全模式

一种限制文件访问的安全模式。启用时：

• 无外部文件访问
• 禁用.read、.output、.import、.sh等命令。
• 无法在同一会话中禁用

提示

• 使用LIMIT对大型文件进行快速预览
• 对于重复查询，Parquet 格式比 CSV 更快
• read_csv_auto和自动读取JSON猜测列类型
• 参数按顺序处理（类似于SQLite CLI）
• WSL2在某些Ubuntu版本上可能显示不正确的内存限制数值