DuckDB 速查表

Q: DuckDB 和 SQLite 有什么不同？

DuckDB 专为分析型（OLAP）工作负载优化 —— 列式存储、向量化执行、并行查询。SQLite 专为事务型（OLTP）工作负载优化。DuckDB 擅长大规模数据集上的聚合查询，SQLite 擅长单行操作。做数据分析用 DuckDB，做应用存储用 SQLite。

Q: DuckDB 能不导入直接查询文件吗？

可以！用 read_csv_auto('file.csv')、read_parquet('file.parquet') 或 read_json_auto('file.json') 直接查询文件。用通配符 read_csv_auto('data/*.csv') 处理多个文件。如需重复查询，可用 CREATE TABLE t AS SELECT * FROM read_csv_auto('f.csv') 创建表。

Q: 最常用的 DuckDB 扩展有哪些？

安装方式：INSTALL 扩展名; LOAD 扩展名。常用扩展：httpfs（S3/HTTP 文件访问）、spatial（GIS 地理空间）、json（高级 JSON）、postgres_scanner（查询 PostgreSQL）、sqlite_scanner（查询 SQLite）、delta（Delta Lake）、iceberg（Apache Iceberg）。

DuckDB 是高性能嵌入式分析型数据库，专注 OLAP 工作负载。无需服务器配置，可直接在 CSV、Parquet、JSON 文件上执行 SQL，拥有丰富的扩展生态。

更新: 2026-07-20·46 条命令

快速开始

bash
duckdb mydb.duckdb                                  # 打开/创建数据库
duckdb -c "SELECT version()"                        # 单条查询
SELECT * FROM read_csv_auto('data.csv')             # 直接查询 CSV
CREATE TABLE t AS SELECT * FROM read_parquet('f.parquet')  # 导入 Parquet
SUMMARIZE SELECT * FROM t                           # 数据概览

安装配置(5)

命令	难度	示例
`brew install duckdb` 通过 Homebrew 安装 DuckDB	基础	`brew install duckdb`
`pip install duckdb` 通过 pip 安装 DuckDB Python 包	基础	`pip install duckdb`
`curl -fsSL https://install.duckdb.org \| sh` 通过脚本一键安装 DuckDB CLI	基础	`curl -fsSL https://install.duckdb.org \| sh`
`duckdb --version` 查看 DuckDB 版本	基础	`duckdb --version`
`duckdb --help` 显示 DuckDB 帮助	基础	`duckdb --help`

基本操作(7)

命令	难度	示例
`duckdb` 启动 DuckDB CLI（内存数据库）	基础	`duckdb`
`duckdb mydb.db` 打开/创建持久化数据库文件	基础	`duckdb mydb.duckdb`
`duckdb -c "SELECT 1"` 执行单条 SQL 并退出	基础	`duckdb -c "SELECT current_database(), current_version();"`
`.tables` 列出当前数据库所有表	基础	`.tables`
`.schema TABLE` 查看表的建表语句	基础	`.schema employees`
`.databases` 列出所有已附加的数据库	基础	`.databases`
`.quit` 退出 DuckDB CLI	基础	`.quit`

查询分析(8)

命令	难度	示例
`SELECT * FROM read_csv_auto('file.csv')` 自动推断模式读取 CSV 文件	基础	`SELECT * FROM read_csv_auto('data.csv')`
`SELECT * FROM read_csv_auto('*.csv')` 读取多个 CSV 文件（通配符）	中级	`SELECT * FROM read_csv_auto('data/*.csv')`
`SELECT * FROM read_parquet('file.parquet')` 直接查询 Parquet 文件	基础	`SELECT * FROM read_parquet('sales.parquet')`
`SELECT * FROM read_parquet('*.parquet')` 查询多个 Parquet 文件	中级	`SELECT count() FROM read_parquet('partitions/.parquet')`
`SUMMARIZE TABLE` 生成表的统计摘要（min, max, null, distinct 等）	基础	`SUMMARIZE SELECT * FROM employees`
`EXPLAIN ANALYZE SQL` 分析查询执行计划和性能	中级	`EXPLAIN ANALYZE SELECT count(*) FROM orders WHERE amount > 100`
`SELECT * FROM read_json_auto('file.json')` 自动推断模式读取 JSON 文件	基础	`SELECT * FROM read_json_auto('events.json')`
`SELECT * FROM delta_scan('path/to/delta/table')` 直接查询 Delta Lake 表	高级	`SELECT * FROM delta_scan('s3://bucket/delta-table/')`

表操作(8)

命令	难度	示例
`CREATE TABLE t AS SELECT * FROM read_csv_auto('f.csv')` 从 CSV 创建表	基础	`CREATE TABLE employees AS SELECT * FROM read_csv_auto('employees.csv')`
`CREATE TABLE t AS SELECT * FROM read_parquet('f.parquet')` 从 Parquet 创建表	基础	`CREATE TABLE sales AS SELECT * FROM read_parquet('sales.parquet')`
`INSERT INTO t SELECT * FROM read_csv_auto('f.csv')` 将 CSV 数据追加到已有表	中级	`INSERT INTO employees SELECT * FROM read_csv_auto('new_employees.csv')`
`.import FILE TABLE` 从文件导入数据到表	基础	`.import data.csv my_table`
`COPY t TO 'output.csv' (HEADER, DELIMITER ',')` 将表导出为 CSV 文件	中级	`COPY employees TO 'employees_export.csv' (HEADER, DELIMITER ',')`
`COPY t TO 'output.parquet'` 将表导出为 Parquet 文件	中级	`COPY orders TO 'orders.parquet' (FORMAT PARQUET)`
`DROP TABLE t` 删除表	基础	`DROP TABLE temp_data`
`DESCRIBE TABLE` 查看表的列信息	基础	`DESCRIBE employees`

格式导出(8)

命令	难度	示例
`duckdb -csv -c SQL` CSV 格式输出查询结果	基础	`duckdb -csv -c "SELECT * FROM employees"`
`duckdb --json -c SQL` JSON 格式输出查询结果	基础	`duckdb --json -c "SELECT * FROM employees"`
`duckdb -list -c SQL` 列表格式输出（无框线，适合管道处理）	基础	`duckdb -list -c "SELECT name FROM employees"`
`duckdb -readonly mydb.db` 以只读模式打开数据库	中级	`duckdb -readonly production.db -c "SELECT count(*) FROM users"`
`.mode markdown` 设置输出格式为 Markdown 表格	中级	`.mode markdown`
`.mode box` 设置输出格式为盒式表格	中级	`.mode box`
`.maxrows N` 设置最大显示行数	基础	`.maxrows 50`
`.separator SEP` 设置 CSV 分隔符	中级	`.separator '\|'`

高级功能(10)

命令	难度	示例
`INSTALL EXTENSION` 安装 DuckDB 扩展	中级	`INSTALL httpfs; LOAD httpfs;`
`LOAD EXTENSION` 加载已安装的扩展	中级	`LOAD spatial;`
`SELECT * FROM read_csv_auto('s3://bucket/file.csv')` 从 S3 直接查询 CSV	高级	`SELECT * FROM read_csv_auto('s3://my-bucket/data.csv')`
`ATTACH 'other.db' AS other` 附加另一个数据库文件	中级	`ATTACH 'archive.duckdb' AS archive`
`PRAGMA table_info('t')` 查看表的详细列信息	中级	`PRAGMA table_info('employees')`
`PRAGMA database_list` 列出所有附加的数据库	中级	`PRAGMA database_list`
`SELECT version()` 查看 DuckDB 版本信息	基础	`SELECT version()`
`SELECT * FROM duckdb_extensions()` 列出已安装和可用扩展	中级	`SELECT * FROM duckdb_extensions()`
`SELECT * FROM duckdb_tables()` 列出数据库中所有表的元数据	中级	`SELECT * FROM duckdb_tables()`
`SELECT * FROM duckdb_columns()` 列出数据库中所有列的元数据	中级	`SELECT * FROM duckdb_columns()`

常见问题

DuckDB 和 SQLite 有什么不同？

DuckDB 能不导入直接查询文件吗？

最常用的 DuckDB 扩展有哪些？

本速查表数据整理自各工具官方文档。最后更新: 2026-07-20。