This is an automated email from the ASF dual-hosted git repository.
github-actions[bot] pushed a commit to branch gh-pages
in repository https://gitbox.apache.org/repos/asf/iceberg-go.git
The following commit(s) were added to refs/heads/gh-pages by this push:
new 7ee1ab787 deploy: 0dd6e1f9f480c1792b01dbe80a83ca7fb8c6d73c
7ee1ab787 is described below
commit 7ee1ab787a6e360b93720f356ea48745b5976164
Author: zeroshade <[email protected]>
AuthorDate: Thu Oct 22 15:28:43 2026 +0000
deploy: 0dd6e1f9f480c1792b01dbe80a83ca7fb8c6d73c
---
cli.html | 8 ++++++++
print.html | 8 ++++++++
searchindex.js | 2 +-
searchindex.json | 2 +-
4 files changed, 18 insertions(+), 2 deletions(-)
diff --git a/cli.html b/cli.html
index f5267a6c3..78ca4489c 100644
--- a/cli.html
+++ b/cli.html
@@ -354,6 +354,14 @@ iceberg refs --type tag my_db.events
iceberg partition-stats --snapshot-id 7234981023498 my_db.events
iceberg partition-stats --all my_db.events # all snapshots
</code></pre>
+<h3 id="files--data-files"><a class="header"
href="#files--data-files"><code>files</code> — data files</a></h3>
+<pre><code class="language-shell">iceberg files my_db.events
# current snapshot
+iceberg files --history my_db.events # all snapshots
+iceberg files --scan-planning-mode remote my_db.events # from a server-side
scan plan
+</code></pre>
+<p>By default <code>files</code> reads the manifest list and manifests itself
and prints them as a tree: snapshot, manifest, then each manifest entry.</p>
+<p>With <code>--scan-planning-mode remote</code> or <code>auto</code>, or when
a REST catalog sets <code>scan-planning-mode=server</code> for the table,
<code>files</code> plans a scan of the current snapshot instead and lists the
data files it returns, each with its delete files. A scan plan carries no
manifests, so the tree has no manifest level, and it only shows live files.
<code>--history</code> needs every snapshot's manifests and fails in this mode,
as does <code>--scan-planning-m [...]
+<p><code>compact</code> plans its input with a table scan, so it follows the
catalog's <code>scan-planning-mode</code> as well. Every other command reads
table metadata directly.</p>
<h3 id="schema---show-defaults"><a class="header"
href="#schema---show-defaults"><code>schema --show-defaults</code></a></h3>
<pre><code class="language-shell">iceberg schema --show-defaults my_db.events
</code></pre>
diff --git a/print.html b/print.html
index 6cf651338..f5c7e8667 100644
--- a/print.html
+++ b/print.html
@@ -1018,6 +1018,14 @@ iceberg refs --type tag my_db.events
iceberg partition-stats --snapshot-id 7234981023498 my_db.events
iceberg partition-stats --all my_db.events # all snapshots
</code></pre>
+<h3 id="files--data-files"><a class="header"
href="#files--data-files"><code>files</code> — data files</a></h3>
+<pre><code class="language-shell">iceberg files my_db.events
# current snapshot
+iceberg files --history my_db.events # all snapshots
+iceberg files --scan-planning-mode remote my_db.events # from a server-side
scan plan
+</code></pre>
+<p>By default <code>files</code> reads the manifest list and manifests itself
and prints them as a tree: snapshot, manifest, then each manifest entry.</p>
+<p>With <code>--scan-planning-mode remote</code> or <code>auto</code>, or when
a REST catalog sets <code>scan-planning-mode=server</code> for the table,
<code>files</code> plans a scan of the current snapshot instead and lists the
data files it returns, each with its delete files. A scan plan carries no
manifests, so the tree has no manifest level, and it only shows live files.
<code>--history</code> needs every snapshot's manifests and fails in this mode,
as does <code>--scan-planning-m [...]
+<p><code>compact</code> plans its input with a table scan, so it follows the
catalog's <code>scan-planning-mode</code> as well. Every other command reads
table metadata directly.</p>
<h3 id="schema---show-defaults"><a class="header"
href="#schema---show-defaults"><code>schema --show-defaults</code></a></h3>
<pre><code class="language-shell">iceberg schema --show-defaults my_db.events
</code></pre>
diff --git a/searchindex.js b/searchindex.js
index 9e4998377..306290bd0 100644
--- a/searchindex.js
+++ b/searchindex.js
@@ -1 +1 @@
-Object.assign(window.search,
{"doc_urls":["introduction.html#iceberg-go","introduction.html#where-to-start","introduction.html#what-works-today","introduction.html#beyond-go","introduction.html#help-and-contribution","install.html#install","install.html#requirements","install.html#installation","getting-started.html#getting-started","getting-started.html#1-install","getting-started.html#2-open-a-local-catalog","getting-started.html#3-create-a-namespace-and-a-table","getting-started.html#
[...]
\ No newline at end of file
+Object.assign(window.search,
{"doc_urls":["introduction.html#iceberg-go","introduction.html#where-to-start","introduction.html#what-works-today","introduction.html#beyond-go","introduction.html#help-and-contribution","install.html#install","install.html#requirements","install.html#installation","getting-started.html#getting-started","getting-started.html#1-install","getting-started.html#2-open-a-local-catalog","getting-started.html#3-create-a-namespace-and-a-table","getting-started.html#
[...]
\ No newline at end of file
diff --git a/searchindex.json b/searchindex.json
index c3bd514c5..30580266d 100644
--- a/searchindex.json
+++ b/searchindex.json
@@ -1 +1 @@
-{"doc_urls":["introduction.html#iceberg-go","introduction.html#where-to-start","introduction.html#what-works-today","introduction.html#beyond-go","introduction.html#help-and-contribution","install.html#install","install.html#requirements","install.html#installation","getting-started.html#getting-started","getting-started.html#1-install","getting-started.html#2-open-a-local-catalog","getting-started.html#3-create-a-namespace-and-a-table","getting-started.html#4-write-some-arrow-data","get
[...]
\ No newline at end of file
+{"doc_urls":["introduction.html#iceberg-go","introduction.html#where-to-start","introduction.html#what-works-today","introduction.html#beyond-go","introduction.html#help-and-contribution","install.html#install","install.html#requirements","install.html#installation","getting-started.html#getting-started","getting-started.html#1-install","getting-started.html#2-open-a-local-catalog","getting-started.html#3-create-a-namespace-and-a-table","getting-started.html#4-write-some-arrow-data","get
[...]
\ No newline at end of file
