DuckDB（DuckDB 官方团队博客） · The DuckDB team

What Is Inside an Iceberg Table?

What Is Inside an Iceberg Table?是DuckDB（DuckDB 官方团队博客）的免费实践教程（en）。前置条件：需要基本 SQL 操作（建表、插入、删除、多表查询）能力，并了解表、分区、快照的大致概念。

能用 SQL 逐层检视 Apache Iceberg 表的文件树，理解元数据、快照与清单文件的组织方式。

打开官方课程

DuckDB

难度: 见前置条件
类型: 博客与教程 · 实践教程
语言: en
规模: 1 个课节
内容费用: 免费
动手: 需要动手环境

使用限制

学习材料本身无需账号即可阅读；动手练习需要本地环境，网页明确要求使用本地 DuckDB CLI 而非浏览器版。

补充内容: 若改用对象存储，需自备 S3 类存储桶；网页未说明其费用
内容提示: 原站推广：正文是完整的技术教程，同时文末（链接列表可见）列出 DuckDB 商店、DuckDB Foundation 等官方站点与自家其他博客文章的推荐入口。

学完你能

说明 Iceberg 表由 metadata.json、Avro 清单列表、清单文件与 Parquet 数据/删除文件构成的树状结构
本地启动 Iceberg REST catalog 服务并在 DuckDB 中 ATTACH 该 catalog
用 iceberg_snapshots 等函数查看表的快照序列与操作类型
用 read_json 读取 metadata.json，查看格式版本、当前快照与快照摘要计数
理解 Iceberg 每次变更写新文件、通过移动 catalog 指针提交的机制及其并发冲突处理
在 DuckDB CLI 中按自上而下的层次追踪某个快照对应的清单与数据文件

适合你吗

适合

适合已经使用 DuckDB 或接触过 Apache Iceberg、想弄清表底层文件组织与排查性能问题的人，教程边讲边给可运行 SQL。

暂不适合

不适合完全没有 SQL 与数据湖基础、只想快速上手写查询的初学者；也不涉及 Iceberg 写入优化的系统性讲解。

需要先会

需要基本 SQL 操作（建表、插入、删除、多表查询）能力，并了解表、分区、快照的大致概念。

课程特点

内容侧重: 按内容目录判断
练习与项目: 按网页步骤在本地完整跑一遍示例，然后自行做一次 INSERT，确认快照数量与 metadata 文件编号都加一。
学习时长: 1 个课节原站未给出统一学习时长；实际用时取决于已有基础。
内容费用: 免费网页为 DuckDB 官方博客全文，节选中可直接读到正文、命令与 SQL 示例，未见付费墙或登录拦截。

内容覆盖

TL;DR 与整体结构概览
Getting Started：启动本地 Iceberg REST catalog 并 ATTACH
A Table with History：建表、两次插入与一次删除
The Tree：metadata.json → manifest list → manifests → 数据/删除文件
Layer 1: The Metadata File（后续小节见网页正文，节选未提供）

常见问题

免费吗？

免费：网页为 DuckDB 官方博客全文，节选中可直接读到正文、命令与 SQL 示例，未见付费墙或登录拦截。实践无额外费用：示例使用本地 Docker 运行的 Iceberg REST catalog fixture 与本地磁盘，网页写明无需 Cloud 账号与认证；改用对象存储时路径变为 s3://，但网页未说明费用。

需要什么基础？

需要基本 SQL 操作（建表、插入、删除、多表查询）能力，并了解表、分区、快照的大致概念。软件、账号与硬件：本地安装可运行的 DuckDB CLI（网页明确说明不要用浏览器版 DuckDB Shell）与 Docker，用于启动 Iceberg REST catalog fixture；对象存储版本需要自备 S3 类存储。

有中文吗？

本站记录的语言是en；是否有中文字幕或译本本站未核实，请以原站为准。

怎么开始？

从原始资源入口开始：https://duckdb.org/2026/10/13/inside-iceberg-table.html。本页“学前准备”列出环境与工具，“学习指南”给出开课提示词，可以在自己的电脑上按步骤开始。开课提示词尚未完整验证。补充内容需要自备：若改用对象存储，需自备 S3 类存储桶；网页未说明其费用。

来源与使用须知

原始资源: DuckDB（DuckDB 官方团队博客）
收录时间: 本站首次收录 2026-10-22
指南参考: 课程主页

版权与转载

课程材料未标明许可：仅供个人学习，转载、修改或商用前请先联系原作者。
本站只提供原始链接和学习指南，不转载、不镜像课程材料；引用时请注明原作者与出处。