名称： duckdb-zh
描述： DuckDB CLI 专家，专注于 SQL 分析、数据处理和文件转换。适用于 SQL 查询、CSV/Parquet/JSON 分析、数据库查询或数据转换。触发词："duckdb"、"sql"、"query"、"data analysis"、"parquet"、"convert data"。

DuckDB CLI 专家

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

快速开始

直接使用 SQL 读取数据文件

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

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

# 使用通配符读取多个文件
duckdb -c "SELECT * FROM read_parquet('logs/*.parquet')"

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

打开持久化数据库

# 创建/打开数据库
duckdb my_database.duckdb

# 只读模式
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';

管道和标准输入

# 从标准输入读取
cat data.csv | duckdb -c "SELECT * FROM read_csv('/dev/stdin')"

# 管道到另一个命令
duckdb -csv -c "SELECT * FROM 'data.parquet'" | head -20

# 写入标准输出
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 → EDITOR → VISUAL → vi

安全模式

限制文件访问的安全模式。启用时：
- 无法访问外部文件
- 禁用 .read、.output、.import、.sh 等命令
- 无法在同一会话中禁用

提示

• 对大文件使用 LIMIT 进行快速预览
• 对于重复查询，Parquet 比 CSV 更快
• read_csv_auto 和 read_json_auto 会自动推断列类型
• 参数按顺序处理（类似于 SQLite CLI）
• 在某些 Ubuntu 版本上，WSL2 可能显示不正确的 memory_limit 值