搜索快捷键 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
- MERGE INTO
- PIVOT
- 性能分析
- SELECT
- SET / RESET
- SET VARIABLE
- SHOW 与 SHOW DATABASES
- 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
- Lance
- MySQL
- PostgreSQL
- 空间
- SQLite
- TPC-DS
- TPC-H
- UI
- Unity Catalog
- Vortex
- 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
- 日志
- 保护 DuckDB 安全
- 非确定性行为
- 限制
- DuckDB Docker 容器
- 开发
- 内部结构
- 站点地图
- 在线演示
文档 / 核心扩展
Delta 扩展
delta 扩展增加了对 Delta Lake 开源存储格式的支持。它是使用 Delta Kernel 构建的。该扩展为本地和远程的 Delta 表提供了读取支持以及有限的写入(盲插入)支持。
有关实现细节,请参阅发布博客文章。
要连接到 Unity Catalog,DuckDB 还提供了
unity_catalog扩展。
安装和加载
delta 扩展在首次使用时会从官方扩展仓库自动加载。如果您想手动安装并加载它,请运行
INSTALL delta;
LOAD delta;
用法
要扫描本地 Delta 表,请运行
SELECT *
FROM delta_scan('file:///some/path/on/local/machine');
从 S3 存储桶读取
要扫描 S3 存储桶中的 Delta 表,请运行
SELECT *
FROM delta_scan('s3://some/delta/table');
对于 S3 存储桶的身份验证,DuckDB 支持使用 Secrets(密钥)
CREATE SECRET (
TYPE s3,
PROVIDER credential_chain
);
SELECT *
FROM delta_scan('s3://some/delta/table/with/auth');
要扫描 S3 上的公共存储桶,您可能需要通过创建包含公共 S3 存储桶所在区域的密钥来传入正确的区域
CREATE SECRET (
TYPE s3,
REGION 'my-region'
);
SELECT *
FROM delta_scan('s3://some/public/table/in/my-region');
从 Azure Blob 存储读取
要扫描 Azure Blob 存储桶中的 Delta 表,请运行
SELECT *
FROM delta_scan('az://my-container/my-table');
对于 Azure Blob 存储的身份验证,DuckDB 支持使用 Secrets(密钥)
CREATE SECRET (
TYPE azure,
PROVIDER credential_chain
);
SELECT *
FROM delta_scan('az://my-container/my-table-with-auth');
功能
此扩展支持许多功能/优化,因为它重用了 DuckDB 大部分常规 Parquet 扫描逻辑
- 多线程扫描和 Parquet 元数据读取
- 数据跳过/过滤条件下推
- 跳过文件中的行组(基于 Parquet 元数据)
- 跳过完整文件(基于 Delta 分区信息)
- 投影下推
- 盲插入 (Blind inserts)
- 扫描带有删除向量 (Deletion Vectors) 的表
- 所有原始类型
- 结构体 (Structs)
- VARIANT 类型支持
- 支持通过密钥访问云存储 (AWS, Azure, GCP)
支持的 DuckDB 版本和平台
delta 扩展需要 DuckDB 0.10.3 或更高版本。
delta 扩展目前仅支持以下平台
- Linux AMD64 (x86_64 和 ARM64):
linux_amd64和linux_arm64 - macOS Intel 和 Apple Silicon:
osx_amd64和osx_arm64 - Windows AMD64:
windows_amd64
对其他 DuckDB 平台的支持正在开发中。