本指南部分包含紧凑的操作指南，专注于实现单一目标。有关 API 参考和示例，请参阅文档的其余部分。

请注意，有许多使用 DuckDB 的工具未包含在官方指南中。要查找这些工具的列表，请查看 Awesome DuckDB 存储库。

提示 对于一个简短的入门教程，请查看“分析荷兰铁路交通”教程。

数据导入和导出

• 数据导入概述
• 使用 file: 协议进行文件访问

CSV 文件

• 如何将 CSV 文件加载到表中
• 如何将表导出为 CSV 文件

Parquet 文件

• 如何将 Parquet 文件加载到表中
• 如何将表导出为 Parquet 文件
• 如何直接在 Parquet 文件上运行查询

HTTP(S)、S3 和 GCP

• 如何直接从 HTTP(S) 加载 Parquet 文件
• 如何直接从 S3 加载 Parquet 文件
• 如何将 Parquet 文件导出到 S3
• 如何从 S3 Express One 加载 Parquet 文件
• 如何直接从 GCS 加载 Parquet 文件
• 如何直接从 Cloudflare R2 加载 Parquet 文件
• 如何直接从 S3 加载 Iceberg 表

JSON 文件

• 如何将 JSON 文件加载到表中
• 如何将表导出为 JSON 文件

带空间扩展的 Excel 文件

• 如何将 Excel 文件加载到表中
• 如何将表导出为 Excel 文件

查询其他数据库系统

• 如何直接查询 MySQL 数据库
• 如何直接查询 PostgreSQL 数据库
• 如何直接查询 SQLite 数据库

直接读取文件

• 如何直接读取二进制文件
• 如何直接读取文本文件

性能

• 我的工作负载很慢（故障排除指南）
• 如何设计模式以获得最佳性能
• DuckDB 的理想硬件环境是什么
• Parquet 文件和（压缩）CSV 文件对性能有何影响
• 如何调优工作负载
• 基准测试

元查询

• 如何列出所有表
• 如何查看查询结果的模式
• 如何使用 summarize 快速了解数据集
• 如何查看查询的执行计划
• 如何分析查询

ODBC

• 如何设置 ODBC 应用程序（及更多！）

Python 客户端

• 如何安装 Python 客户端
• 如何执行 SQL 查询
• 如何在 Jupyter Notebooks 中轻松查询 DuckDB
• 如何在 marimo Notebooks 中轻松查询 DuckDB
• 如何在 DuckDB 中使用多 Python 线程
• 如何在 DuckDB 中使用 fsspec 文件系统

Pandas

• 如何在 Pandas DataFrame 上执行 SQL
• 如何从 Pandas DataFrame 创建表
• 如何将数据导出到 Pandas DataFrame

Apache Arrow

• 如何在 Apache Arrow 上执行 SQL
• 如何从 Apache Arrow 创建 DuckDB 表
• 如何将数据导出到 Apache Arrow

关系型 API

• 如何使用关系型 API 查询 Pandas DataFrame

Python 库集成

• 如何使用 Ibis 查询 DuckDB（支持或不支持 SQL）
• 如何通过 Apache Arrow 将 DuckDB 与 Polars DataFrame 结合使用

SQL 功能

• 友好的 SQL
• As-of 连接
• 全文搜索
• query 和 query_table 函数

SQL 编辑器和 IDE

• 如何设置 DBeaver SQL IDE

数据查看器

• 如何使用 Tableau 可视化 DuckDB 数据库
• 如何使用 DuckDB 和 YouPlot 绘制命令行图表