搜索快捷键 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
- 行为准则
- 发布日历
- 路线图
- 站点地图
- 在线演示
文档 / 开发 / 构建 DuckDB
macOS
先决条件
安装 Xcode 和 Homebrew。然后,使用以下命令安装所需的软件包:
brew install git cmake ninja
构建 DuckDB
克隆并构建 DuckDB,操作如下。
git clone https://github.com/duckdb/duckdb
cd duckdb
GEN=ninja make
构建成功后,您可以在 build
目录中找到 duckdb
二进制文件
build/release/duckdb
对于不同的构建配置(如 debug
, relassert
等),请参阅构建配置页面。
故障排除
构建失败:未找到文件 'string'
问题:在 macOS 上构建失败,并出现以下错误:
FAILED: third_party/libpg_query/CMakeFiles/duckdb_pg_query.dir/src_backend_nodes_list.cpp.o
/Library/Developer/CommandLineTools/usr/bin/c++ -DDUCKDB_BUILD_LIBRARY -DEXT_VERSION_PARQUET=\"9cba6a2a03\" -I/Users/builder/external/duckdb/src/include -I/Users/builder/external/duckdb/third_party/fsst -I/Users/builder/external/duckdb/third_party/fmt/include -I/Users/builder/external/duckdb/third_party/hyperloglog -I/Users/builder/external/duckdb/third_party/fastpforlib -I/Users/builder/external/duckdb/third_party/skiplist -I/Users/builder/external/duckdb/third_party/fast_float -I/Users/builder/external/duckdb/third_party/re2 -I/Users/builder/external/duckdb/third_party/miniz -I/Users/builder/external/duckdb/third_party/utf8proc/include -I/Users/builder/external/duckdb/third_party/concurrentqueue -I/Users/builder/external/duckdb/third_party/pcg -I/Users/builder/external/duckdb/third_party/tdigest -I/Users/builder/external/duckdb/third_party/mbedtls/include -I/Users/builder/external/duckdb/third_party/jaro_winkler -I/Users/builder/external/duckdb/third_party/yyjson/include -I/Users/builder/external/duckdb/third_party/libpg_query/include -O3 -DNDEBUG -O3 -DNDEBUG -std=c++11 -arch arm64 -isysroot /Library/Developer/CommandLineTools/SDKs/MacOSX15.1.sdk -fPIC -fvisibility=hidden -fcolor-diagnostics -w -MD -MT third_party/libpg_query/CMakeFiles/duckdb_pg_query.dir/src_backend_nodes_list.cpp.o -MF third_party/libpg_query/CMakeFiles/duckdb_pg_query.dir/src_backend_nodes_list.cpp.o.d -o third_party/libpg_query/CMakeFiles/duckdb_pg_query.dir/src_backend_nodes_list.cpp.o -c /Users/builder/external/duckdb/third_party/libpg_query/src_backend_nodes_list.cpp
In file included from /Users/builder/external/duckdb/third_party/libpg_query/src_backend_nodes_list.cpp:35:
/Users/builder/external/duckdb/third_party/libpg_query/include/pg_functions.hpp:4:10: fatal error: 'string' file not found
4 | #include <string>
解决方案:用户反馈重新安装 Xcode 解决了他们的问题。请参阅 DuckDB GitHub issues 和 Stack Overflow 上的相关讨论。
警告:尝试重新安装 Xcode 套件可能会影响您系统上的其他应用程序。请谨慎操作。
sudo rm -rf /Library/Developer/CommandLineTools
xcode-select --install
Debug 构建打印 malloc 警告
问题:macOS 上的 debug
构建打印 malloc
警告,例如:
duckdb(83082,0x205b30240) malloc: nano zone abandoned due to inability to reserve vm space.
解决方案:为防止此问题,请将 MallocNanoZone
标志设置为 0
MallocNanoZone=0 make debug
要将此更改应用于您未来的终端会话,您可以将以下内容添加到您的 ~/.zshrc
文件中
export MallocNanoZone=0