<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>CHECKPOINT on OLAP 工作室 — 独立 DuckDB 中文技术社区与实验博客</title><link>https://duckdblab.org/zh/tags/checkpoint/</link><description>Recent content in CHECKPOINT on OLAP 工作室 — 独立 DuckDB 中文技术社区与实验博客</description><generator>Hugo -- gohugo.io</generator><language>zh-CN</language><lastBuildDate>Fri, 20 Nov 2026 00:00:00 +0000</lastBuildDate><atom:link href="https://duckdblab.org/zh/tags/checkpoint/index.xml" rel="self" type="application/rss+xml"/><item><title>DuckDB 空间回收实测：VACUUM 不缩文件、CHECKPOINT 不截断，真正压缩靠 COPY FROM DATABASE</title><link>https://duckdblab.org/zh/post/duckdb-vacuum-reclaim-space/</link><pubDate>Fri, 20 Nov 2026 00:00:00 +0000</pubDate><guid>https://duckdblab.org/zh/post/duckdb-vacuum-reclaim-space/</guid><description>&lt;img src="https://duckdblab.org/images/posts/duckdb-vacuum-reclaim-space/cover.png" alt="Featured image of post DuckDB 空间回收实测：VACUUM 不缩文件、CHECKPOINT 不截断，真正压缩靠 COPY FROM DATABASE" /&gt;&lt;h2 id="一个常见的错误直觉"&gt;一个常见的错误直觉
&lt;/h2&gt;&lt;p&gt;用过 PostgreSQL 或 SQLite 的人，习惯了一个心智模型：&lt;strong&gt;删了很多数据后跑一次 &lt;code&gt;VACUUM&lt;/code&gt;，文件就会变小&lt;/strong&gt;。于是很多人把 DuckDB 的 &lt;code&gt;VACUUM&lt;/code&gt; 当成&amp;quot;缩小 &lt;code&gt;.duckdb&lt;/code&gt; 文件&amp;quot;的开关。&lt;/p&gt;
&lt;p&gt;但 DuckDB 的 &lt;code&gt;VACUUM&lt;/code&gt; 完全不是这么回事。官方文档开头就写着：&lt;/p&gt;

 &lt;blockquote&gt;
 &lt;p&gt;The &lt;code&gt;VACUUM&lt;/code&gt; statement only has basic support in DuckDB and is mostly provided for PostgreSQL-compatibility. … The &lt;code&gt;VACUUM&lt;/code&gt; statement does &lt;strong&gt;not&lt;/strong&gt; reclaim space.&lt;/p&gt;

 &lt;/blockquote&gt;
&lt;p&gt;也就是说，&lt;strong&gt;DuckDB 的 &lt;code&gt;VACUUM&lt;/code&gt; 既不回收磁盘空间，也不缩小文件&lt;/strong&gt;，它存在的最大意义是给 PostgreSQL 用户一个&amp;quot;语法兼容&amp;quot;的占位，以及（用 &lt;code&gt;VACUUM ANALYZE table(col)&lt;/code&gt;）重建列统计信息。&lt;/p&gt;
&lt;p&gt;那删了一堆数据后，到底怎么把文件体积压回去？本文用 100 万行、4 个阶段的实测，把 &lt;strong&gt;VACUUM / CHECKPOINT / COPY FROM DATABASE&lt;/strong&gt; 三者的真实分工彻底讲清楚。&lt;/p&gt;

 &lt;blockquote&gt;
 &lt;p&gt;&lt;strong&gt;本文定位&lt;/strong&gt;：只讲&amp;quot;空间回收&amp;quot;这一件事，基于 DuckDB 1.5（Variegata）实测，所有数字都可用文末命令复现。&lt;/p&gt;

 &lt;/blockquote&gt;
&lt;h2 id="一三个工具三种角色先给结论"&gt;一、三个工具，三种角色（先给结论）
&lt;/h2&gt;&lt;table&gt;
 &lt;thead&gt;
 &lt;tr&gt;
 &lt;th&gt;工具&lt;/th&gt;
 &lt;th&gt;真实作用&lt;/th&gt;
 &lt;th&gt;会不会让 &lt;code&gt;.duckdb&lt;/code&gt; 文件变小&lt;/th&gt;
 &lt;/tr&gt;
 &lt;/thead&gt;
 &lt;tbody&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;VACUUM;&lt;/code&gt; / &lt;code&gt;VACUUM ANALYZE;&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;全库级是 &lt;strong&gt;no-op&lt;/strong&gt;（空操作）&lt;/td&gt;
 &lt;td&gt;❌ 否&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;VACUUM my_table(my_col);&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;重建该表该列的统计信息&lt;/td&gt;
 &lt;td&gt;❌ 否（只动统计，不动空间）&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;CHECKPOINT;&lt;/code&gt; / &lt;code&gt;FORCE CHECKPOINT;&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;把 WAL 同步进数据文件，并&lt;strong&gt;合并&lt;/strong&gt;删除量达标的行组&lt;/td&gt;
 &lt;td&gt;⚠️ 会复用空闲空间，但&lt;strong&gt;不截断&lt;/strong&gt;文件&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;COPY FROM DATABASE a TO b;&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;把内容拷进一个&lt;strong&gt;全新&lt;/strong&gt;数据库，相当于压缩重写&lt;/td&gt;
 &lt;td&gt;✅ 是，文件真正变小&lt;/td&gt;
 &lt;/tr&gt;
 &lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;一句话：&lt;strong&gt;想让磁盘上的文件变小，只有 &lt;code&gt;COPY FROM DATABASE&lt;/code&gt; 这一条可靠路径；&lt;code&gt;CHECKPOINT&lt;/code&gt; 负责&amp;quot;别再继续膨胀&amp;quot;；&lt;code&gt;VACUUM&lt;/code&gt; 跟空间回收基本无关。&lt;/strong&gt;&lt;/p&gt;
&lt;h2 id="二最小可复现实验100-万行删一半量-4-个体积"&gt;二、最小可复现实验：100 万行删一半，量 4 个体积
&lt;/h2&gt;&lt;p&gt;下面全部可在 DuckDB CLI 直接执行。文件体积用 bash 的 &lt;code&gt;stat -c '%s'&lt;/code&gt; 量（字节数）。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;第 0 步：建 100 万行，checkpoint&lt;/strong&gt;&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-sql" data-lang="sql"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;CREATE&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;TABLE&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;t&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;AS&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;SELECT&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;range&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;AS&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s1"&gt;&amp;#39;payload_&amp;#39;&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;||&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;repeat&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;&amp;#39;x&amp;#39;&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;40&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;AS&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;payload&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;FROM&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;range&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;1000000&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;CHECKPOINT&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;$ stat -c &lt;span class="s1"&gt;&amp;#39;%s&amp;#39;&lt;/span&gt; exp.duckdb
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="m"&gt;536576&lt;/span&gt; &lt;span class="c1"&gt;# S0：100 万行，建表 + checkpoint 后的体积&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;strong&gt;第 1 步：删掉一半（&lt;code&gt;id % 2 = 0&lt;/code&gt;），先不 checkpoint&lt;/strong&gt;&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-sql" data-lang="sql"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;DELETE&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;FROM&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;t&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;WHERE&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;%&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;$ stat -c &lt;span class="s1"&gt;&amp;#39;%s&amp;#39;&lt;/span&gt; exp.duckdb
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="m"&gt;798720&lt;/span&gt; &lt;span class="c1"&gt;# S1：删除后文件反而变大了（多了删除标记 + WAL）&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;注意：删了 50% 的数据，文件体积不降反升（536KB → 798KB）。因为 DuckDB 是 append-only 的，删除只是打&amp;quot;删除标记&amp;quot;并写进 WAL，并不会就地擦除。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;第 2 步：跑 &lt;code&gt;VACUUM&lt;/code&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-sql" data-lang="sql"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;VACUUM&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;$ stat -c &lt;span class="s1"&gt;&amp;#39;%s&amp;#39;&lt;/span&gt; exp.duckdb
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="m"&gt;798720&lt;/span&gt; &lt;span class="c1"&gt;# S2：和 S1 完全一样，VACUUM 对体积零影响&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;strong&gt;第 3 步：跑 &lt;code&gt;CHECKPOINT&lt;/code&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-sql" data-lang="sql"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;CHECKPOINT&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;$ stat -c &lt;span class="s1"&gt;&amp;#39;%s&amp;#39;&lt;/span&gt; exp.duckdb
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="m"&gt;798720&lt;/span&gt; &lt;span class="c1"&gt;# S3：checkpoint 后文件仍不截断，体积不变&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;这是最容易&amp;quot;踩坑&amp;quot;的一步：很多人跑完 &lt;code&gt;CHECKPOINT&lt;/code&gt; 一看文件没变小，就以为&amp;quot;回收失效了&amp;quot;。实际上 &lt;strong&gt;&lt;code&gt;CHECKPOINT&lt;/code&gt; 回收的是&amp;quot;可复用空间&amp;quot;，不是&amp;quot;把文件尾部截短&amp;quot;&lt;/strong&gt;。&lt;/p&gt;
&lt;h2 id="三为什么-checkpoint-不截断文件"&gt;三、为什么 CHECKPOINT 不截断文件
&lt;/h2&gt;&lt;p&gt;DuckDB 是&lt;strong&gt;单文件格式&lt;/strong&gt;。官方&amp;quot;Reclaiming Space&amp;quot;文档第一句就是：&lt;/p&gt;

 &lt;blockquote&gt;
 &lt;p&gt;DuckDB uses a single-file format, which has some inherent limitations w.r.t. reclaiming disk space.&lt;/p&gt;

 &lt;/blockquote&gt;
&lt;p&gt;它的空间回收机制是：&lt;code&gt;CHECKPOINT&lt;/code&gt; 时，把&amp;quot;删除量达到阈值&amp;quot;的相邻行组&lt;strong&gt;合并&lt;/strong&gt;，让那段空间标记为&amp;quot;可再次写入&amp;quot;。但&lt;strong&gt;文件的字节长度不会因此缩短&lt;/strong&gt;——它保持在历史最高水位（high-water mark），只是那段空闲空间后续写数据时会被复用，避免文件继续往上长。&lt;/p&gt;
&lt;p&gt;所以上面的 S3 不变是正常的。&lt;strong&gt;&amp;ldquo;回收&amp;rdquo;≈ &amp;ldquo;以后不再膨胀得那么快&amp;rdquo;，而不是&amp;quot;磁盘上立刻变小&amp;quot;。&lt;/strong&gt;&lt;/p&gt;

 &lt;blockquote&gt;
 &lt;p&gt;官方还给了一个细节：合并需要&amp;quot;相邻行组里约 25% 的行被删除&amp;quot;才触发。删太少（比如只删 5%）时，checkpoint 不会合并那些行组，空间也就不会释放。我们这里删了 50%，远超阈值，所以合并会生效（体现在&amp;quot;可复用&amp;quot;上，而非截断）。&lt;/p&gt;

 &lt;/blockquote&gt;
&lt;h2 id="四vacuum-的真实职责重建统计不是收空间"&gt;四、VACUUM 的真实职责：重建统计，不是收空间
&lt;/h2&gt;&lt;p&gt;把 &lt;code&gt;VACUUM&lt;/code&gt; 各形态拆开看（1.5 实测）：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-sql" data-lang="sql"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;VACUUM&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="c1"&gt;-- 全库：no-op，什么都不做
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;VACUUM&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;ANALYZE&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="c1"&gt;-- 全库：同样是 no-op
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;VACUUM&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;t&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="c1"&gt;-- 对表 t 的列 id 重建统计信息（静默成功）
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;VACUUM&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;FULL&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="c1"&gt;-- 报错：Not implemented Error: Full vacuum option
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;VACUUM t(id)&lt;/code&gt; 这条才是它&lt;strong&gt;真正能干的事&lt;/strong&gt;：当某列因为大量 UPDATE/DELETE 导致统计信息（比如 distinct 基数）过期时，重建它，让优化器选对执行计划。这和磁盘空间&lt;strong&gt;毫无关系&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;所以&amp;quot;用 VACUUM 缩文件&amp;quot;这个操作，从语义上就选错了工具。&lt;/p&gt;
&lt;h2 id="五真正让文件变小copy-from-database"&gt;五、真正让文件变小：&lt;code&gt;COPY FROM DATABASE&lt;/code&gt;
&lt;/h2&gt;&lt;p&gt;官方文档明确把&amp;quot;压缩数据库&amp;quot;指向了 &lt;code&gt;COPY FROM DATABASE&lt;/code&gt;：&lt;/p&gt;

 &lt;blockquote&gt;
 &lt;p&gt;To compact the database, you can create a fresh copy of the database using the &lt;code&gt;COPY FROM DATABASE&lt;/code&gt; statement.&lt;/p&gt;

 &lt;/blockquote&gt;
&lt;p&gt;实测（接上第二节的 &lt;code&gt;exp.duckdb&lt;/code&gt;，此时 90 万行、体积 1,060,864 字节）：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-sql" data-lang="sql"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="n"&gt;ATTACH&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s1"&gt;&amp;#39;exp.duckdb&amp;#39;&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;AS&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;db1&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="n"&gt;ATTACH&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s1"&gt;&amp;#39;exp_compact.duckdb&amp;#39;&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;AS&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;db2&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="n"&gt;USE&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;db2&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;COPY&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;FROM&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;DATABASE&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;db1&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;TO&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;db2&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;CHECKPOINT&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;$ stat -c &lt;span class="s1"&gt;&amp;#39;%s&amp;#39;&lt;/span&gt; exp.duckdb&lt;span class="p"&gt;;&lt;/span&gt; stat -c &lt;span class="s1"&gt;&amp;#39;%s&amp;#39;&lt;/span&gt; exp_compact.duckdb
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="m"&gt;1060864&lt;/span&gt; &lt;span class="c1"&gt;# 源库：膨胀后&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="m"&gt;536576&lt;/span&gt; &lt;span class="c1"&gt;# 新库：压缩后，行数不变（90 万行）&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;strong&gt;体积从 1,060,864 降到 536,576，下降约 49%&lt;/strong&gt;，数据一行没丢。这就是 DuckDB 下&amp;quot;真正缩文件&amp;quot;的标准做法：写进一个干净的新库，再切过去用。&lt;/p&gt;

 &lt;blockquote&gt;
 &lt;p&gt;生产里常见配套：&lt;code&gt;COPY FROM DATABASE&lt;/code&gt; 到新文件 → 校验行数/校验和 → 原子替换旧文件（重命名）。整个过程只读源库，风险可控。&lt;/p&gt;

 &lt;/blockquote&gt;
&lt;h2 id="六进阶两件事14--15"&gt;六、进阶两件事（1.4+ / 1.5）
&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;1. 内存库也能 checkpoint + 压缩（1.4 起）&lt;/strong&gt;&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-sql" data-lang="sql"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="n"&gt;ATTACH&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s1"&gt;&amp;#39;:memory:&amp;#39;&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;AS&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;mcmp&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;COMPRESS&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="n"&gt;USE&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;mcmp&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;CREATE&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;TABLE&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;x&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;AS&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;SELECT&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;range&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;AS&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;repeat&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;&amp;#39;z&amp;#39;&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;AS&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nb"&gt;blob&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;FROM&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;range&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;50000&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;CHECKPOINT&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;1.4 之前内存表不 checkpoint、不压缩；1.4 起内存表同样支持压缩与&amp;quot;删除行 vacuuming&amp;quot;，对&amp;quot;常驻内存但反复增删&amp;quot;的场景（比如 AI Agent 的内存工作集）很实用。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;2. ART 索引表 + &lt;code&gt;vacuum_rebuild_indexes&lt;/code&gt;（实验性）&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;带 &lt;code&gt;PRIMARY KEY&lt;/code&gt;/&lt;code&gt;UNIQUE&lt;/code&gt; 约束的表底层是 ART 索引。默认 &lt;code&gt;VACUUM&lt;/code&gt; 会&lt;strong&gt;跳过&lt;/strong&gt;带 ART 索引的表；&lt;code&gt;vacuum_rebuild_indexes&lt;/code&gt; 这个实验性设置能让 vacuum 在重建索引的前提下压缩这些表（设 0 表示关闭，即默认）。&lt;/p&gt;
&lt;p&gt;⚠️ 实测坑：这个设置&lt;strong&gt;不能在数据库运行中修改&lt;/strong&gt;——&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-sql" data-lang="sql"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;SET&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;vacuum_rebuild_indexes&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;200000&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;-- Invalid Input Error: Cannot change vacuum_rebuild_indexes setting while database is running
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;它只能在启动 / &lt;code&gt;ATTACH&lt;/code&gt; 阶段配置。&lt;/p&gt;
&lt;h2 id="七自动-checkpointwal_autocheckpoint"&gt;七、自动 checkpoint：&lt;code&gt;wal_autocheckpoint&lt;/code&gt;
&lt;/h2&gt;&lt;p&gt;你不需要手动到处写 &lt;code&gt;CHECKPOINT&lt;/code&gt;。DuckDB 会按 WAL 大小自动 checkpoint：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-sql" data-lang="sql"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;SELECT&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;name&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;value&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;FROM&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;duckdb_settings&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;WHERE&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;name&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s1"&gt;&amp;#39;wal_autocheckpoint&amp;#39;&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;-- wal_autocheckpoint | 16.0 MiB
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;默认阈值 16 MiB：WAL 写到 16MB 就自动触发一次 checkpoint。写入密集的场景可以调低（更勤快地把 WAL 落盘、控制文件水位）；只读或低频写入场景调高也没关系。理解了这个默认值，你才能解释&amp;quot;为什么我的 &lt;code&gt;.duckdb&lt;/code&gt; 文件在持续变大&amp;quot;——通常就是 WAL 增长触发了 checkpoint、而文件不截断所致。&lt;/p&gt;
&lt;h2 id="八什么时候用什么决策表"&gt;八、什么时候用什么（决策表）
&lt;/h2&gt;&lt;table&gt;
 &lt;thead&gt;
 &lt;tr&gt;
 &lt;th&gt;你的诉求&lt;/th&gt;
 &lt;th&gt;正确动作&lt;/th&gt;
 &lt;/tr&gt;
 &lt;/thead&gt;
 &lt;tbody&gt;
 &lt;tr&gt;
 &lt;td&gt;删了很多行，想&lt;strong&gt;别再膨胀 / 让空闲空间可复用&lt;/strong&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;CHECKPOINT&lt;/code&gt;（或依赖自动 &lt;code&gt;wal_autocheckpoint&lt;/code&gt;）&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;想让磁盘上的 &lt;code&gt;.duckdb&lt;/code&gt; &lt;strong&gt;真正变小&lt;/strong&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;COPY FROM DATABASE&lt;/code&gt; 拷进新库再替换&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;列统计过期、查询计划变差&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;VACUUM my_table(my_col)&lt;/code&gt; 重建统计&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;误以为是 &lt;code&gt;VACUUM FULL&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;1.5 下 &lt;strong&gt;不支持&lt;/strong&gt;，会报 &lt;code&gt;Not implemented&lt;/code&gt;&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;带主键/唯一约束的表想压缩&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;vacuum_rebuild_indexes&lt;/code&gt;（实验性，需启动期配置）&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;内存常驻库反复增删&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;ATTACH ':memory:' (...) (COMPRESS)&lt;/code&gt; + &lt;code&gt;CHECKPOINT&lt;/code&gt;（1.4+）&lt;/td&gt;
 &lt;/tr&gt;
 &lt;/tbody&gt;
&lt;/table&gt;
&lt;h2 id="继续深入"&gt;继续深入
&lt;/h2&gt;&lt;ul&gt;
&lt;li&gt;&lt;a class="link" href="https://duckdblab.org/zh/post/duckdb-complete-guide/" &gt;DuckDB 完整使用指南&lt;/a&gt; — 从安装到进阶的整体路线图&lt;/li&gt;
&lt;li&gt;&lt;a class="link" href="https://duckdblab.org/zh/post/duckdb-performance-tuning-ultimate-guide/" &gt;DuckDB 性能调优终极指南&lt;/a&gt; — 空间回收只是性能的一环，配合调优一起看&lt;/li&gt;
&lt;li&gt;&lt;a class="link" href="https://duckdblab.org/zh/post/duckdb-predicate-pushdown-filter-indexes/" &gt;DuckDB 谓词下推与索引&lt;/a&gt; — &lt;code&gt;VACUUM ANALYZE&lt;/code&gt; 重建的统计如何驱动优化器&lt;/li&gt;
&lt;li&gt;&lt;a class="link" href="https://duckdblab.org/zh/post/duckdb-production-deployment-guide/" &gt;DuckDB 生产环境部署指南&lt;/a&gt; — 生产里怎么做&amp;quot;压缩重写 + 原子替换&amp;quot;的安全运维&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id="可复现验证"&gt;可复现验证
&lt;/h2&gt;&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;版本&lt;/strong&gt;：DuckDB 1.5.2 (Variegata)，Linux x86_64，CLI 直接执行，所有体积数字用 &lt;code&gt;stat -c '%s'&lt;/code&gt; 实测。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;复现命令&lt;/strong&gt;：&lt;code&gt;duckdb exp.duckdb &amp;lt; setup.sql&lt;/code&gt; 按第二、五节顺序跑；压缩对比用第五节 &lt;code&gt;COPY FROM DATABASE&lt;/code&gt;。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;官方依据&lt;/strong&gt;：&lt;a class="link" href="https://duckdb.org/docs/1.5/sql/statements/vacuum.html" target="_blank" rel="noopener"
 &gt;VACUUM Statement (1.5)&lt;/a&gt;、&lt;a class="link" href="https://duckdb.org/docs/1.5/sql/statements/checkpoint.html" target="_blank" rel="noopener"
 &gt;CHECKPOINT Statement (1.5)&lt;/a&gt;、&lt;a class="link" href="https://duckdb.org/docs/1.5/operations_manual/footprint_of_duckdb/reclaiming_space.html" target="_blank" rel="noopener"
 &gt;Reclaiming Space (1.5)&lt;/a&gt;、&lt;a class="link" href="https://duckdb.org/docs/1.5/configuration/overview.html" target="_blank" rel="noopener"
 &gt;Configuration (1.5)&lt;/a&gt;。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;本文信息&lt;/strong&gt;：最后验证 2026-11-17。如发现问题，欢迎通过 &lt;a class="link" href="https://github.com/pengzz9527/duckdb-blog/issues" target="_blank" rel="noopener"
 &gt;GitHub Issue&lt;/a&gt; 反馈。&lt;/li&gt;
&lt;/ul&gt;</description></item></channel></rss>