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 f8166dfa10 Publish built docs triggered by
4e45c19d10600fe12442e6855c52ab3afcaa8493
f8166dfa10 is described below
commit f8166dfa10fe53a6712592815a9d412019ed89f2
Author: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
AuthorDate: Wed Dec 31 00:46:05 2025 +0000
Publish built docs triggered by 4e45c19d10600fe12442e6855c52ab3afcaa8493
---
_sources/library-user-guide/upgrading.md.txt | 17 ++++++++++++++---
_sources/user-guide/sql/scalar_functions.md.txt | 2 +-
library-user-guide/upgrading.html | 16 +++++++++++++---
searchindex.js | 2 +-
4 files changed, 29 insertions(+), 8 deletions(-)
diff --git a/_sources/library-user-guide/upgrading.md.txt
b/_sources/library-user-guide/upgrading.md.txt
index 39d52bd590..6b24c97ea4 100644
--- a/_sources/library-user-guide/upgrading.md.txt
+++ b/_sources/library-user-guide/upgrading.md.txt
@@ -45,15 +45,26 @@ directly on the `Field`. For example:
In prior versions, `ListingTableProvider` would issue `LIST` commands to
the underlying object store each time it needed to list files for a query.
To improve performance, `ListingTableProvider` now caches the results of
-`LIST` commands for the lifetime of the `ListingTableProvider` instance.
+`LIST` commands for the lifetime of the `ListingTableProvider` instance or
+until a cache entry expires.
Note that by default the cache has no expiration time, so if files are added
or removed
from the underlying object store, the `ListingTableProvider` will not see
those changes until the `ListingTableProvider` instance is dropped and
recreated.
-You will be able to configure the maximum cache size and cache expiration time
via a configuration option:
+You can configure the maximum cache size and cache entry expiration time via
configuration options:
-See <https://github.com/apache/datafusion/issues/19056> for more details.
+- `datafusion.runtime.list_files_cache_limit` - Limits the size of the cache
in bytes
+- `datafusion.runtime.list_files_cache_ttl` - Limits the TTL (time-to-live) of
an entry in seconds
+
+Detailed configuration information can be found in the [DataFusion Runtime
+Configuration](https://datafusion.apache.org/user-guide/configs.html#runtime-configuration-settings)
user's guide.
+
+Caching can be disabled by setting the limit to 0:
+
+```sql
+SET datafusion.runtime.list_files_cache_limit TO "0K";
+```
Note that the internal API has changed to use a trait `ListFilesCache` instead
of a type alias.
diff --git a/_sources/user-guide/sql/scalar_functions.md.txt
b/_sources/user-guide/sql/scalar_functions.md.txt
index cf35b9f3c3..ddf32a5066 100644
--- a/_sources/user-guide/sql/scalar_functions.md.txt
+++ b/_sources/user-guide/sql/scalar_functions.md.txt
@@ -5047,7 +5047,7 @@ arrow_cast(expression, datatype)
Returns the metadata of the input expression. If a key is provided, returns
the value for that key. If no key is provided, returns a Map of all metadata.
```sql
-arrow_metadata(expression, [key])
+arrow_metadata(expression[, key])
```
#### Arguments
diff --git a/library-user-guide/upgrading.html
b/library-user-guide/upgrading.html
index 2625da3a58..2b08848b6c 100644
--- a/library-user-guide/upgrading.html
+++ b/library-user-guide/upgrading.html
@@ -426,12 +426,22 @@ directly on the <code class="docutils literal
notranslate"><span class="pre">Fie
<p>In prior versions, <code class="docutils literal notranslate"><span
class="pre">ListingTableProvider</span></code> would issue <code
class="docutils literal notranslate"><span class="pre">LIST</span></code>
commands to
the underlying object store each time it needed to list files for a query.
To improve performance, <code class="docutils literal notranslate"><span
class="pre">ListingTableProvider</span></code> now caches the results of
-<code class="docutils literal notranslate"><span
class="pre">LIST</span></code> commands for the lifetime of the <code
class="docutils literal notranslate"><span
class="pre">ListingTableProvider</span></code> instance.</p>
+<code class="docutils literal notranslate"><span
class="pre">LIST</span></code> commands for the lifetime of the <code
class="docutils literal notranslate"><span
class="pre">ListingTableProvider</span></code> instance or
+until a cache entry expires.</p>
<p>Note that by default the cache has no expiration time, so if files are
added or removed
from the underlying object store, the <code class="docutils literal
notranslate"><span class="pre">ListingTableProvider</span></code> will not see
those changes until the <code class="docutils literal notranslate"><span
class="pre">ListingTableProvider</span></code> instance is dropped and
recreated.</p>
-<p>You will be able to configure the maximum cache size and cache expiration
time via a configuration option:</p>
-<p>See <a class="github reference external"
href="https://github.com/apache/datafusion/issues/19056";>apache/datafusion#19056</a>
for more details.</p>
+<p>You can configure the maximum cache size and cache entry expiration time
via configuration options:</p>
+<ul class="simple">
+<li><p><code class="docutils literal notranslate"><span
class="pre">datafusion.runtime.list_files_cache_limit</span></code> - Limits
the size of the cache in bytes</p></li>
+<li><p><code class="docutils literal notranslate"><span
class="pre">datafusion.runtime.list_files_cache_ttl</span></code> - Limits the
TTL (time-to-live) of an entry in seconds</p></li>
+</ul>
+<p>Detailed configuration information can be found in the <a class="reference
external"
href="https://datafusion.apache.org/user-guide/configs.html#runtime-configuration-settings";>DataFusion
Runtime
+Configuration</a> user’s guide.</p>
+<p>Caching can be disabled by setting the limit to 0:</p>
+<div class="highlight-sql notranslate"><div
class="highlight"><pre><span></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_limit</span><span class="w"> </span><span
class="k">TO</span><span class="w"> </span><span
class="ss">"0K"</span><span class="p">;</span>
+</pre></div>
+</div>
<p>Note that the internal API has changed to use a trait <code class="docutils
literal notranslate"><span class="pre">ListFilesCache</span></code> instead of
a type alias.</p>
</section>
<section id="newlines-in-values-moved-from-filescanconfig-to-csvoptions">
diff --git a/searchindex.js b/searchindex.js
index 23d8eb4435..d8cbfee090 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
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
