This is an automated email from the ASF dual-hosted git repository.
github-bot pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/datafusion.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 6e39d1fc26 Publish built docs triggered by
e6049de5a748c9f8872f42a44c8bb7c913a7c5a5
6e39d1fc26 is described below
commit 6e39d1fc2604e7434a6aa9c57160753630de838a
Author: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
AuthorDate: Thu Jan 8 14:35:02 2026 +0000
Publish built docs triggered by e6049de5a748c9f8872f42a44c8bb7c913a7c5a5
---
_sources/user-guide/cli/functions.md.txt | 56 ++++++++++++++++-----------
searchindex.js | 2 +-
user-guide/cli/functions.html | 65 +++++++++++++++++++-------------
3 files changed, 74 insertions(+), 49 deletions(-)
diff --git a/_sources/user-guide/cli/functions.md.txt
b/_sources/user-guide/cli/functions.md.txt
index 11f61297ac..ea353d5c8d 100644
--- a/_sources/user-guide/cli/functions.md.txt
+++ b/_sources/user-guide/cli/functions.md.txt
@@ -172,41 +172,53 @@ The columns of the returned table are:
## `list_files_cache`
-The `list_files_cache` function shows information about the `ListFilesCache`
that is used by the [`ListingTable`] implementation in DataFusion. When
creating a [`ListingTable`], DataFusion lists the files in the table's location
and caches results in the `ListFilesCache`. Subsequent queries against the same
table can reuse this cached information instead of re-listing the files.
+The `list_files_cache` function shows information about the `ListFilesCache`
that is used by the [`ListingTable`] implementation in DataFusion. When
creating a [`ListingTable`], DataFusion lists the files in the table's location
and caches results in the `ListFilesCache`. Subsequent queries against the same
table can reuse this cached information instead of re-listing the files. Cache
entries are scoped to tables.
You can inspect the cache by querying the `list_files_cache` function. For
example,
```sql
-> select split_part(path, '/', -1) as folder, metadata_size_bytes, expires_in,
unnest(metadata_list)['file_size_bytes'] as file_size_bytes,
unnest(metadata_list)['e_tag'] as e_tag from list_files_cache();
-+----------+---------------------+-----------------------------------+-----------------+-------------------------------+
-| folder | metadata_size_bytes | expires_in |
file_size_bytes | e_tag |
-+----------+---------------------+-----------------------------------+-----------------+-------------------------------+
-| customer | 1592 | 0 days 0 hours 0 mins 18.488 secs | 1233969
| 7041136-643a7bfeeec9b-12d431 |
-| customer | 1592 | 0 days 0 hours 0 mins 18.488 secs | 1234756
| 7041137-643a7bfeef2df-12d744 |
-| customer | 1592 | 0 days 0 hours 0 mins 18.488 secs | 1232554
| 7041139-643a7bfeef86a-12ceaa |
-| customer | 1592 | 0 days 0 hours 0 mins 18.488 secs | 1238676
| 704113a-643a7bfeef914-12e694 |
-| customer | 1592 | 0 days 0 hours 0 mins 18.488 secs | 1232186
| 704113b-643a7bfeefb22-12cd3a |
-| customer | 1592 | 0 days 0 hours 0 mins 18.488 secs | 1237506
| 7041138-643a7bfeef775-12e202 |
-| customer | 1592 | 0 days 0 hours 0 mins 18.488 secs | 1228756
| 7041134-643a7bfeec2d8-12bfd4 |
-| customer | 1592 | 0 days 0 hours 0 mins 18.488 secs | 1228509
| 7041135-643a7bfeed599-12bedd |
-| lineitem | 1600 | 0 days 0 hours 0 mins 16.758 secs |
20124715 | 704114a-643a7c00bb560-133142b |
-| lineitem | 1600 | 0 days 0 hours 0 mins 16.758 secs |
20131024 | 7041149-643a7c00b90b7-1332cd0 |
-| lineitem | 1600 | 0 days 0 hours 0 mins 16.758 secs |
20179217 | 704114b-643a7c00bb93e-133e911 |
-| lineitem | 1600 | 0 days 0 hours 0 mins 16.758 secs |
20296819 | 704114f-643a7c00ccefd-135b473 |
-| lineitem | 1600 | 0 days 0 hours 0 mins 16.758 secs |
20110730 | 7041148-643a7c00b9832-132dd8a |
-| lineitem | 1600 | 0 days 0 hours 0 mins 16.758 secs |
20128346 | 704114c-643a7c00bc00a-133225a |
-| lineitem | 1600 | 0 days 0 hours 0 mins 16.758 secs |
20130133 | 7041147-643a7c00b3901-1332955 |
-| lineitem | 1600 | 0 days 0 hours 0 mins 16.758 secs |
20139830 | 7041146-643a7c00abbe8-1334f36 |
-+----------+---------------------+-----------------------------------+-----------------+-------------------------------+
+> set datafusion.runtime.list_files_cache_ttl = "30s";
+> create external table overturemaps
+stored as parquet
+location
's3://overturemaps-us-west-2/release/2025-12-17.0/theme=base/type=infrastructure';
+0 row(s) fetched.
+> select table, path, metadata_size_bytes, expires_in,
unnest(metadata_list)['file_size_bytes'] as file_size_bytes,
unnest(metadata_list)['e_tag'] as e_tag from list_files_cache() limit 10;
++--------------+-----------------------------------------------------+---------------------+-----------------------------------+-----------------+---------------------------------------+
+| table | path |
metadata_size_bytes | expires_in | file_size_bytes |
e_tag |
++--------------+-----------------------------------------------------+---------------------+-----------------------------------+-----------------+---------------------------------------+
+| overturemaps | release/2025-12-17.0/theme=base/type=infrastructure | 2750
| 0 days 0 hours 0 mins 25.264 secs | 999055952 |
"35fc8fbe8400960b54c66fbb408c48e8-60" |
+| overturemaps | release/2025-12-17.0/theme=base/type=infrastructure | 2750
| 0 days 0 hours 0 mins 25.264 secs | 975592768 |
"8a16e10b722681cdc00242564b502965-59" |
+| overturemaps | release/2025-12-17.0/theme=base/type=infrastructure | 2750
| 0 days 0 hours 0 mins 25.264 secs | 1082925747 |
"24cd13ddb5e0e438952d2499f5dabe06-65" |
+| overturemaps | release/2025-12-17.0/theme=base/type=infrastructure | 2750
| 0 days 0 hours 0 mins 25.264 secs | 1008425557 |
"37663e31c7c64d4ef355882bcd47e361-61" |
+| overturemaps | release/2025-12-17.0/theme=base/type=infrastructure | 2750
| 0 days 0 hours 0 mins 25.264 secs | 1065561905 |
"4e7c50d2d1b3c5ed7b82b4898f5ac332-64" |
+| overturemaps | release/2025-12-17.0/theme=base/type=infrastructure | 2750
| 0 days 0 hours 0 mins 25.264 secs | 1045655427 |
"8fff7e6a72d375eba668727c55d4f103-63" |
+| overturemaps | release/2025-12-17.0/theme=base/type=infrastructure | 2750
| 0 days 0 hours 0 mins 25.264 secs | 1086822683 |
"b67167d8022d778936c330a52a5f1922-65" |
+| overturemaps | release/2025-12-17.0/theme=base/type=infrastructure | 2750
| 0 days 0 hours 0 mins 25.264 secs | 1016732378 |
"6d70857a0473ed9ed3fc6e149814168b-61" |
+| overturemaps | release/2025-12-17.0/theme=base/type=infrastructure | 2750
| 0 days 0 hours 0 mins 25.264 secs | 991363784 |
"c9cafb42fcbb413f851691c895dd7c2b-60" |
+| overturemaps | release/2025-12-17.0/theme=base/type=infrastructure | 2750
| 0 days 0 hours 0 mins 25.264 secs | 1032469715 |
"7540252d0d67158297a67038a3365e0f-62" |
++--------------+-----------------------------------------------------+---------------------+-----------------------------------+-----------------+---------------------------------------+
```
The columns of the returned table are:
| column_name | data_type | Description |
| ------------------- | ------------ |
-----------------------------------------------------------------------------------------
|
+| table | Utf8 | Name of the table |
| path | Utf8 | File path relative to the object store / filesystem root |
| metadata_size_bytes | UInt64 | Size of the cached metadata in memory (not
its thrift encoded form) |
| expires_in | Duration(ms) | Last modified time of the file |
| metadata_list | List(Struct) | List of metadatas, one for each file under
the path. |
+A metadata struct in the metadata_list contains the following fields:
+
+```text
+{
+ "file_path":
"release/2025-12-17.0/theme=base/type=infrastructure/part-00000-d556e455-e0c5-4940-b367-daff3287a952-c000.zstd.parquet",
+ "file_modified": "2025-12-17T22:20:29",
+ "file_size_bytes": 999055952,
+ "e_tag": "35fc8fbe8400960b54c66fbb408c48e8-60",
+ "version": null
+}
+```
+
[`listingtable`]:
https://docs.rs/datafusion/latest/datafusion/datasource/listing/struct.ListingTable.html
[entity tag]: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/ETag
diff --git a/searchindex.js b/searchindex.js
index fc26ea5c38..9dff39054e 100644
--- a/searchindex.js
+++ b/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"alltitles":{"!=":[[61,"op-neq"]],"!~":[[61,"op-re-not-match"]],"!~*":[[61,"op-re-not-match-i"]],"!~~":[[61,"id19"]],"!~~*":[[61,"id20"]],"#":[[61,"op-bit-xor"]],"%":[[61,"op-modulo"]],"&":[[61,"op-bit-and"]],"(relation,
name) tuples in logical fields and logical columns are
unique":[[13,"relation-name-tuples-in-logical-fields-and-logical-columns-are-unique"]],"*":[[61,"op-multiply"]],"+":[[61,"op-plus"]],"-":[[61,"op-minus"]],"/":[[61,"op-divide"]],"<":[[61,"op-lt"]],"<
[...]
\ No newline at end of file
+Search.setIndex({"alltitles":{"!=":[[61,"op-neq"]],"!~":[[61,"op-re-not-match"]],"!~*":[[61,"op-re-not-match-i"]],"!~~":[[61,"id19"]],"!~~*":[[61,"id20"]],"#":[[61,"op-bit-xor"]],"%":[[61,"op-modulo"]],"&":[[61,"op-bit-and"]],"(relation,
name) tuples in logical fields and logical columns are
unique":[[13,"relation-name-tuples-in-logical-fields-and-logical-columns-are-unique"]],"*":[[61,"op-multiply"]],"+":[[61,"op-plus"]],"-":[[61,"op-minus"]],"/":[[61,"op-divide"]],"<":[[61,"op-lt"]],"<
[...]
\ No newline at end of file
diff --git a/user-guide/cli/functions.html b/user-guide/cli/functions.html
index e5d4c81788..f7b97e0e76 100644
--- a/user-guide/cli/functions.html
+++ b/user-guide/cli/functions.html
@@ -685,29 +685,28 @@ enabled.</p>
</section>
<section id="list-files-cache">
<h2><code class="docutils literal notranslate"><span
class="pre">list_files_cache</span></code><a class="headerlink"
href="#list-files-cache" title="Link to this heading">#</a></h2>
-<p>The <code class="docutils literal notranslate"><span
class="pre">list_files_cache</span></code> function shows information about the
<code class="docutils literal notranslate"><span
class="pre">ListFilesCache</span></code> that is used by the <a
class="reference external"
href="https://docs.rs/datafusion/latest/datafusion/datasource/listing/struct.ListingTable.html";><code
class="docutils literal notranslate"><span
class="pre">ListingTable</span></code></a> implementation in DataFusion [...]
+<p>The <code class="docutils literal notranslate"><span
class="pre">list_files_cache</span></code> function shows information about the
<code class="docutils literal notranslate"><span
class="pre">ListFilesCache</span></code> that is used by the <a
class="reference external"
href="https://docs.rs/datafusion/latest/datafusion/datasource/listing/struct.ListingTable.html";><code
class="docutils literal notranslate"><span
class="pre">ListingTable</span></code></a> implementation in DataFusion [...]
<p>You can inspect the cache by querying the <code class="docutils literal
notranslate"><span class="pre">list_files_cache</span></code> function. For
example,</p>
-<div class="highlight-sql notranslate"><div
class="highlight"><pre><span></span><span class="o">></span><span class="w">
</span><span class="k">select</span><span class="w"> </span><span
class="n">split_part</span><span class="p">(</span><span
class="n">path</span><span class="p">,</span><span class="w"> </span><span
class="s1">'/'</span><span class="p">,</span><span class="w">
</span><span class="o">-</span><span class="mi">1</span><span
class="p">)</span><span class="w"> </s [...]
-<span class="o">+</span><span
class="c1">----------+---------------------+-----------------------------------+-----------------+-------------------------------+</span>
-<span class="o">|</span><span class="w"> </span><span
class="n">folder</span><span class="w"> </span><span class="o">|</span><span
class="w"> </span><span class="n">metadata_size_bytes</span><span class="w">
</span><span class="o">|</span><span class="w"> </span><span
class="n">expires_in</span><span class="w"> </span><span
class="o">|</span><span class="w"> </span><span
class="n">file_size_bytes</span><span class="w"> </span><span
class="o">|</span><span class=" [...]
-<span class="o">+</span><span
class="c1">----------+---------------------+-----------------------------------+-----------------+-------------------------------+</span>
-<span class="o">|</span><span class="w"> </span><span
class="n">customer</span><span class="w"> </span><span class="o">|</span><span
class="w"> </span><span class="mi">1592</span><span class="w">
</span><span class="o">|</span><span class="w"> </span><span
class="mi">0</span><span class="w"> </span><span class="n">days</span><span
class="w"> </span><span class="mi">0</span><span class="w"> </span><span
class="n">hours</span><span class="w"> </span><span class="mi">0</span> [...]
-<span class="o">|</span><span class="w"> </span><span
class="n">customer</span><span class="w"> </span><span class="o">|</span><span
class="w"> </span><span class="mi">1592</span><span class="w">
</span><span class="o">|</span><span class="w"> </span><span
class="mi">0</span><span class="w"> </span><span class="n">days</span><span
class="w"> </span><span class="mi">0</span><span class="w"> </span><span
class="n">hours</span><span class="w"> </span><span class="mi">0</span> [...]
-<span class="o">|</span><span class="w"> </span><span
class="n">customer</span><span class="w"> </span><span class="o">|</span><span
class="w"> </span><span class="mi">1592</span><span class="w">
</span><span class="o">|</span><span class="w"> </span><span
class="mi">0</span><span class="w"> </span><span class="n">days</span><span
class="w"> </span><span class="mi">0</span><span class="w"> </span><span
class="n">hours</span><span class="w"> </span><span class="mi">0</span> [...]
-<span class="o">|</span><span class="w"> </span><span
class="n">customer</span><span class="w"> </span><span class="o">|</span><span
class="w"> </span><span class="mi">1592</span><span class="w">
</span><span class="o">|</span><span class="w"> </span><span
class="mi">0</span><span class="w"> </span><span class="n">days</span><span
class="w"> </span><span class="mi">0</span><span class="w"> </span><span
class="n">hours</span><span class="w"> </span><span class="mi">0</span> [...]
-<span class="o">|</span><span class="w"> </span><span
class="n">customer</span><span class="w"> </span><span class="o">|</span><span
class="w"> </span><span class="mi">1592</span><span class="w">
</span><span class="o">|</span><span class="w"> </span><span
class="mi">0</span><span class="w"> </span><span class="n">days</span><span
class="w"> </span><span class="mi">0</span><span class="w"> </span><span
class="n">hours</span><span class="w"> </span><span class="mi">0</span> [...]
-<span class="o">|</span><span class="w"> </span><span
class="n">customer</span><span class="w"> </span><span class="o">|</span><span
class="w"> </span><span class="mi">1592</span><span class="w">
</span><span class="o">|</span><span class="w"> </span><span
class="mi">0</span><span class="w"> </span><span class="n">days</span><span
class="w"> </span><span class="mi">0</span><span class="w"> </span><span
class="n">hours</span><span class="w"> </span><span class="mi">0</span> [...]
-<span class="o">|</span><span class="w"> </span><span
class="n">customer</span><span class="w"> </span><span class="o">|</span><span
class="w"> </span><span class="mi">1592</span><span class="w">
</span><span class="o">|</span><span class="w"> </span><span
class="mi">0</span><span class="w"> </span><span class="n">days</span><span
class="w"> </span><span class="mi">0</span><span class="w"> </span><span
class="n">hours</span><span class="w"> </span><span class="mi">0</span> [...]
-<span class="o">|</span><span class="w"> </span><span
class="n">customer</span><span class="w"> </span><span class="o">|</span><span
class="w"> </span><span class="mi">1592</span><span class="w">
</span><span class="o">|</span><span class="w"> </span><span
class="mi">0</span><span class="w"> </span><span class="n">days</span><span
class="w"> </span><span class="mi">0</span><span class="w"> </span><span
class="n">hours</span><span class="w"> </span><span class="mi">0</span> [...]
-<span class="o">|</span><span class="w"> </span><span
class="n">lineitem</span><span class="w"> </span><span class="o">|</span><span
class="w"> </span><span class="mi">1600</span><span class="w">
</span><span class="o">|</span><span class="w"> </span><span
class="mi">0</span><span class="w"> </span><span class="n">days</span><span
class="w"> </span><span class="mi">0</span><span class="w"> </span><span
class="n">hours</span><span class="w"> </span><span class="mi">0</span> [...]
-<span class="o">|</span><span class="w"> </span><span
class="n">lineitem</span><span class="w"> </span><span class="o">|</span><span
class="w"> </span><span class="mi">1600</span><span class="w">
</span><span class="o">|</span><span class="w"> </span><span
class="mi">0</span><span class="w"> </span><span class="n">days</span><span
class="w"> </span><span class="mi">0</span><span class="w"> </span><span
class="n">hours</span><span class="w"> </span><span class="mi">0</span> [...]
-<span class="o">|</span><span class="w"> </span><span
class="n">lineitem</span><span class="w"> </span><span class="o">|</span><span
class="w"> </span><span class="mi">1600</span><span class="w">
</span><span class="o">|</span><span class="w"> </span><span
class="mi">0</span><span class="w"> </span><span class="n">days</span><span
class="w"> </span><span class="mi">0</span><span class="w"> </span><span
class="n">hours</span><span class="w"> </span><span class="mi">0</span> [...]
-<span class="o">|</span><span class="w"> </span><span
class="n">lineitem</span><span class="w"> </span><span class="o">|</span><span
class="w"> </span><span class="mi">1600</span><span class="w">
</span><span class="o">|</span><span class="w"> </span><span
class="mi">0</span><span class="w"> </span><span class="n">days</span><span
class="w"> </span><span class="mi">0</span><span class="w"> </span><span
class="n">hours</span><span class="w"> </span><span class="mi">0</span> [...]
-<span class="o">|</span><span class="w"> </span><span
class="n">lineitem</span><span class="w"> </span><span class="o">|</span><span
class="w"> </span><span class="mi">1600</span><span class="w">
</span><span class="o">|</span><span class="w"> </span><span
class="mi">0</span><span class="w"> </span><span class="n">days</span><span
class="w"> </span><span class="mi">0</span><span class="w"> </span><span
class="n">hours</span><span class="w"> </span><span class="mi">0</span> [...]
-<span class="o">|</span><span class="w"> </span><span
class="n">lineitem</span><span class="w"> </span><span class="o">|</span><span
class="w"> </span><span class="mi">1600</span><span class="w">
</span><span class="o">|</span><span class="w"> </span><span
class="mi">0</span><span class="w"> </span><span class="n">days</span><span
class="w"> </span><span class="mi">0</span><span class="w"> </span><span
class="n">hours</span><span class="w"> </span><span class="mi">0</span> [...]
-<span class="o">|</span><span class="w"> </span><span
class="n">lineitem</span><span class="w"> </span><span class="o">|</span><span
class="w"> </span><span class="mi">1600</span><span class="w">
</span><span class="o">|</span><span class="w"> </span><span
class="mi">0</span><span class="w"> </span><span class="n">days</span><span
class="w"> </span><span class="mi">0</span><span class="w"> </span><span
class="n">hours</span><span class="w"> </span><span class="mi">0</span> [...]
-<span class="o">|</span><span class="w"> </span><span
class="n">lineitem</span><span class="w"> </span><span class="o">|</span><span
class="w"> </span><span class="mi">1600</span><span class="w">
</span><span class="o">|</span><span class="w"> </span><span
class="mi">0</span><span class="w"> </span><span class="n">days</span><span
class="w"> </span><span class="mi">0</span><span class="w"> </span><span
class="n">hours</span><span class="w"> </span><span class="mi">0</span> [...]
-<span class="o">+</span><span
class="c1">----------+---------------------+-----------------------------------+-----------------+-------------------------------+</span>
+<div class="highlight-sql notranslate"><div
class="highlight"><pre><span></span><span class="o">></span><span class="w">
</span><span class="k">set</span><span class="w"> </span><span
class="n">datafusion</span><span class="p">.</span><span
class="n">runtime</span><span class="p">.</span><span
class="n">list_files_cache_ttl</span><span class="w"> </span><span
class="o">=</span><span class="w"> </span><span
class="ss">"30s"</span><span class="p">;</span>
+<span class="o">></span><span class="w"> </span><span
class="k">create</span><span class="w"> </span><span
class="k">external</span><span class="w"> </span><span
class="k">table</span><span class="w"> </span><span
class="n">overturemaps</span>
+<span class="n">stored</span><span class="w"> </span><span
class="k">as</span><span class="w"> </span><span class="n">parquet</span>
+<span class="k">location</span><span class="w"> </span><span
class="s1">'s3://overturemaps-us-west-2/release/2025-12-17.0/theme=base/type=infrastructure'</span><span
class="p">;</span>
+<span class="mi">0</span><span class="w"> </span><span
class="k">row</span><span class="p">(</span><span class="n">s</span><span
class="p">)</span><span class="w"> </span><span class="n">fetched</span><span
class="p">.</span>
+<span class="o">></span><span class="w"> </span><span
class="k">select</span><span class="w"> </span><span
class="k">table</span><span class="p">,</span><span class="w"> </span><span
class="n">path</span><span class="p">,</span><span class="w"> </span><span
class="n">metadata_size_bytes</span><span class="p">,</span><span class="w">
</span><span class="n">expires_in</span><span class="p">,</span><span
class="w"> </span><span class="k">unnest</span><span class="p">(</span><span
class=" [...]
+<span class="o">+</span><span
class="c1">--------------+-----------------------------------------------------+---------------------+-----------------------------------+-----------------+---------------------------------------+</span>
+<span class="o">|</span><span class="w"> </span><span
class="k">table</span><span class="w"> </span><span
class="o">|</span><span class="w"> </span><span class="n">path</span><span
class="w"> </span><span
class="o">|</span><span class="w"> </span><span
class="n">metadata_size_bytes</span><span class="w"> </span><span
class="o">|</span><span class="w"> </span><span
class="n">expires_in</span><span class="w"> </sp [...]
+<span class="o">+</span><span
class="c1">--------------+-----------------------------------------------------+---------------------+-----------------------------------+-----------------+---------------------------------------+</span>
+<span class="o">|</span><span class="w"> </span><span
class="n">overturemaps</span><span class="w"> </span><span
class="o">|</span><span class="w"> </span><span class="n">release</span><span
class="o">/</span><span class="mi">2025</span><span class="o">-</span><span
class="mi">12</span><span class="o">-</span><span class="mi">17</span><span
class="p">.</span><span class="mi">0</span><span class="o">/</span><span
class="n">theme</span><span class="o">=</span><span class="n">base</span><sp
[...]
+<span class="o">|</span><span class="w"> </span><span
class="n">overturemaps</span><span class="w"> </span><span
class="o">|</span><span class="w"> </span><span class="n">release</span><span
class="o">/</span><span class="mi">2025</span><span class="o">-</span><span
class="mi">12</span><span class="o">-</span><span class="mi">17</span><span
class="p">.</span><span class="mi">0</span><span class="o">/</span><span
class="n">theme</span><span class="o">=</span><span class="n">base</span><sp
[...]
+<span class="o">|</span><span class="w"> </span><span
class="n">overturemaps</span><span class="w"> </span><span
class="o">|</span><span class="w"> </span><span class="n">release</span><span
class="o">/</span><span class="mi">2025</span><span class="o">-</span><span
class="mi">12</span><span class="o">-</span><span class="mi">17</span><span
class="p">.</span><span class="mi">0</span><span class="o">/</span><span
class="n">theme</span><span class="o">=</span><span class="n">base</span><sp
[...]
+<span class="o">|</span><span class="w"> </span><span
class="n">overturemaps</span><span class="w"> </span><span
class="o">|</span><span class="w"> </span><span class="n">release</span><span
class="o">/</span><span class="mi">2025</span><span class="o">-</span><span
class="mi">12</span><span class="o">-</span><span class="mi">17</span><span
class="p">.</span><span class="mi">0</span><span class="o">/</span><span
class="n">theme</span><span class="o">=</span><span class="n">base</span><sp
[...]
+<span class="o">|</span><span class="w"> </span><span
class="n">overturemaps</span><span class="w"> </span><span
class="o">|</span><span class="w"> </span><span class="n">release</span><span
class="o">/</span><span class="mi">2025</span><span class="o">-</span><span
class="mi">12</span><span class="o">-</span><span class="mi">17</span><span
class="p">.</span><span class="mi">0</span><span class="o">/</span><span
class="n">theme</span><span class="o">=</span><span class="n">base</span><sp
[...]
+<span class="o">|</span><span class="w"> </span><span
class="n">overturemaps</span><span class="w"> </span><span
class="o">|</span><span class="w"> </span><span class="n">release</span><span
class="o">/</span><span class="mi">2025</span><span class="o">-</span><span
class="mi">12</span><span class="o">-</span><span class="mi">17</span><span
class="p">.</span><span class="mi">0</span><span class="o">/</span><span
class="n">theme</span><span class="o">=</span><span class="n">base</span><sp
[...]
+<span class="o">|</span><span class="w"> </span><span
class="n">overturemaps</span><span class="w"> </span><span
class="o">|</span><span class="w"> </span><span class="n">release</span><span
class="o">/</span><span class="mi">2025</span><span class="o">-</span><span
class="mi">12</span><span class="o">-</span><span class="mi">17</span><span
class="p">.</span><span class="mi">0</span><span class="o">/</span><span
class="n">theme</span><span class="o">=</span><span class="n">base</span><sp
[...]
+<span class="o">|</span><span class="w"> </span><span
class="n">overturemaps</span><span class="w"> </span><span
class="o">|</span><span class="w"> </span><span class="n">release</span><span
class="o">/</span><span class="mi">2025</span><span class="o">-</span><span
class="mi">12</span><span class="o">-</span><span class="mi">17</span><span
class="p">.</span><span class="mi">0</span><span class="o">/</span><span
class="n">theme</span><span class="o">=</span><span class="n">base</span><sp
[...]
+<span class="o">|</span><span class="w"> </span><span
class="n">overturemaps</span><span class="w"> </span><span
class="o">|</span><span class="w"> </span><span class="n">release</span><span
class="o">/</span><span class="mi">2025</span><span class="o">-</span><span
class="mi">12</span><span class="o">-</span><span class="mi">17</span><span
class="p">.</span><span class="mi">0</span><span class="o">/</span><span
class="n">theme</span><span class="o">=</span><span class="n">base</span><sp
[...]
+<span class="o">|</span><span class="w"> </span><span
class="n">overturemaps</span><span class="w"> </span><span
class="o">|</span><span class="w"> </span><span class="n">release</span><span
class="o">/</span><span class="mi">2025</span><span class="o">-</span><span
class="mi">12</span><span class="o">-</span><span class="mi">17</span><span
class="p">.</span><span class="mi">0</span><span class="o">/</span><span
class="n">theme</span><span class="o">=</span><span class="n">base</span><sp
[...]
+<span class="o">+</span><span
class="c1">--------------+-----------------------------------------------------+---------------------+-----------------------------------+-----------------+---------------------------------------+</span>
</pre></div>
</div>
<p>The columns of the returned table are:</p>
@@ -719,25 +718,39 @@ enabled.</p>
</tr>
</thead>
<tbody>
-<tr class="row-even"><td><p>path</p></td>
+<tr class="row-even"><td><p>table</p></td>
+<td><p>Utf8</p></td>
+<td><p>Name of the table</p></td>
+</tr>
+<tr class="row-odd"><td><p>path</p></td>
<td><p>Utf8</p></td>
<td><p>File path relative to the object store / filesystem root</p></td>
</tr>
-<tr class="row-odd"><td><p>metadata_size_bytes</p></td>
+<tr class="row-even"><td><p>metadata_size_bytes</p></td>
<td><p>UInt64</p></td>
<td><p>Size of the cached metadata in memory (not its thrift encoded
form)</p></td>
</tr>
-<tr class="row-even"><td><p>expires_in</p></td>
+<tr class="row-odd"><td><p>expires_in</p></td>
<td><p>Duration(ms)</p></td>
<td><p>Last modified time of the file</p></td>
</tr>
-<tr class="row-odd"><td><p>metadata_list</p></td>
+<tr class="row-even"><td><p>metadata_list</p></td>
<td><p>List(Struct)</p></td>
<td><p>List of metadatas, one for each file under the path.</p></td>
</tr>
</tbody>
</table>
</div>
+<p>A metadata struct in the metadata_list contains the following fields:</p>
+<div class="highlight-text notranslate"><div
class="highlight"><pre><span></span>{
+ "file_path":
"release/2025-12-17.0/theme=base/type=infrastructure/part-00000-d556e455-e0c5-4940-b367-daff3287a952-c000.zstd.parquet",
+ "file_modified": "2025-12-17T22:20:29",
+ "file_size_bytes": 999055952,
+ "e_tag": "35fc8fbe8400960b54c66fbb408c48e8-60",
+ "version": null
+}
+</pre></div>
+</div>
</section>
</section>
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
