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 648d9006a9 Publish built docs triggered by
0c3bb78e24722e2a4f19cdc9a76f1c498949f5be
648d9006a9 is described below
commit 648d9006a997f06d131152592bde1436bd8857a7
Author: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
AuthorDate: Tue Jun 17 16:04:24 2025 +0000
Publish built docs triggered by 0c3bb78e24722e2a4f19cdc9a76f1c498949f5be
---
_sources/library-user-guide/upgrading.md.txt | 25 +++++++++++++++++
library-user-guide/upgrading.html | 41 ++++++++++++++++++++++++++++
searchindex.js | 2 +-
3 files changed, 67 insertions(+), 1 deletion(-)
diff --git a/_sources/library-user-guide/upgrading.md.txt
b/_sources/library-user-guide/upgrading.md.txt
index 8821d61857..b502850b59 100644
--- a/_sources/library-user-guide/upgrading.md.txt
+++ b/_sources/library-user-guide/upgrading.md.txt
@@ -19,6 +19,31 @@
# Upgrade Guides
+## DataFusion `49.0.0`
+
+### Metadata is now represented by `FieldMetadata`
+
+Metadata from the Arrow `Field` is now stored using the `FieldMetadata`
+structure. In prior versions it was stored as both a `HashMap<String, String>`
+and a `BTreeMap<String, String>`. `FieldMetadata` is a easier to work with and
+is more efficient.
+
+To create `FieldMetadata` from a `Field`:
+
+```rust
+ let metadata = FieldMetadata::from(&field);
+```
+
+To add metadata to a `Field`, use the `add_to_field` method:
+
+```rust
+let updated_field = metadata.add_to_field(field);
+```
+
+See [#16317] for details.
+
+[#16317]: https://github.com/apache/datafusion/pull/16317
+
## DataFusion `48.0.0`
### `Expr::Literal` has optional metadata
diff --git a/library-user-guide/upgrading.html
b/library-user-guide/upgrading.html
index 70ed5d3b08..734eec41b4 100644
--- a/library-user-guide/upgrading.html
+++ b/library-user-guide/upgrading.html
@@ -549,6 +549,28 @@
<nav id="bd-toc-nav">
<ul class="visible nav section-nav flex-column">
+ <li class="toc-h2 nav-item toc-entry">
+ <a class="reference internal nav-link" href="#datafusion-49-0-0">
+ DataFusion
+ <code class="docutils literal notranslate">
+ <span class="pre">
+ 49.0.0
+ </span>
+ </code>
+ </a>
+ <ul class="nav section-nav flex-column">
+ <li class="toc-h3 nav-item toc-entry">
+ <a class="reference internal nav-link"
href="#metadata-is-now-represented-by-fieldmetadata">
+ Metadata is now represented by
+ <code class="docutils literal notranslate">
+ <span class="pre">
+ FieldMetadata
+ </span>
+ </code>
+ </a>
+ </li>
+ </ul>
+ </li>
<li class="toc-h2 nav-item toc-entry">
<a class="reference internal nav-link" href="#datafusion-48-0-0">
DataFusion
@@ -926,6 +948,25 @@
-->
<section id="upgrade-guides">
<h1>Upgrade Guides<a class="headerlink" href="#upgrade-guides" title="Link to
this heading">¶</a></h1>
+<section id="datafusion-49-0-0">
+<h2>DataFusion <code class="docutils literal notranslate"><span
class="pre">49.0.0</span></code><a class="headerlink" href="#datafusion-49-0-0"
title="Link to this heading">¶</a></h2>
+<section id="metadata-is-now-represented-by-fieldmetadata">
+<h3>Metadata is now represented by <code class="docutils literal
notranslate"><span class="pre">FieldMetadata</span></code><a class="headerlink"
href="#metadata-is-now-represented-by-fieldmetadata" title="Link to this
heading">¶</a></h3>
+<p>Metadata from the Arrow <code class="docutils literal notranslate"><span
class="pre">Field</span></code> is now stored using the <code class="docutils
literal notranslate"><span class="pre">FieldMetadata</span></code>
+structure. In prior versions it was stored as both a <code class="docutils
literal notranslate"><span class="pre">HashMap<String,</span> <span
class="pre">String></span></code>
+and a <code class="docutils literal notranslate"><span
class="pre">BTreeMap<String,</span> <span
class="pre">String></span></code>. <code class="docutils literal
notranslate"><span class="pre">FieldMetadata</span></code> is a easier to work
with and
+is more efficient.</p>
+<p>To create <code class="docutils literal notranslate"><span
class="pre">FieldMetadata</span></code> from a <code class="docutils literal
notranslate"><span class="pre">Field</span></code>:</p>
+<div class="highlight-rust notranslate"><div
class="highlight"><pre><span></span><span class="w"> </span><span
class="kd">let</span><span class="w"> </span><span
class="n">metadata</span><span class="w"> </span><span class="o">=</span><span
class="w"> </span><span class="n">FieldMetadata</span><span
class="p">::</span><span class="n">from</span><span class="p">(</span><span
class="o">&</span><span class="n">field</span><span class="p">);</span>
+</pre></div>
+</div>
+<p>To add metadata to a <code class="docutils literal notranslate"><span
class="pre">Field</span></code>, use the <code class="docutils literal
notranslate"><span class="pre">add_to_field</span></code> method:</p>
+<div class="highlight-rust notranslate"><div
class="highlight"><pre><span></span><span class="kd">let</span><span class="w">
</span><span class="n">updated_field</span><span class="w"> </span><span
class="o">=</span><span class="w"> </span><span class="n">metadata</span><span
class="p">.</span><span class="n">add_to_field</span><span
class="p">(</span><span class="n">field</span><span class="p">);</span>
+</pre></div>
+</div>
+<p>See <a class="reference external"
href="https://github.com/apache/datafusion/pull/16317";>#16317</a> for
details.</p>
+</section>
+</section>
<section id="datafusion-48-0-0">
<h2>DataFusion <code class="docutils literal notranslate"><span
class="pre">48.0.0</span></code><a class="headerlink" href="#datafusion-48-0-0"
title="Link to this heading">¶</a></h2>
<section id="expr-literal-has-optional-metadata">
diff --git a/searchindex.js b/searchindex.js
index d5132937c9..d20af8bbe8 100644
--- a/searchindex.js
+++ b/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"alltitles":{"!=":[[57,"op-neq"]],"!~":[[57,"op-re-not-match"]],"!~*":[[57,"op-re-not-match-i"]],"!~~":[[57,"id19"]],"!~~*":[[57,"id20"]],"#":[[57,"op-bit-xor"]],"%":[[57,"op-modulo"]],"&":[[57,"op-bit-and"]],"(relation,
name) tuples in logical fields and logical columns are
unique":[[12,"relation-name-tuples-in-logical-fields-and-logical-columns-are-unique"]],"*":[[57,"op-multiply"]],"+":[[57,"op-plus"]],"-":[[57,"op-minus"]],"/":[[57,"op-divide"]],"2022
Q2":[[10,"q2"]] [...]
\ No newline at end of file
+Search.setIndex({"alltitles":{"!=":[[57,"op-neq"]],"!~":[[57,"op-re-not-match"]],"!~*":[[57,"op-re-not-match-i"]],"!~~":[[57,"id19"]],"!~~*":[[57,"id20"]],"#":[[57,"op-bit-xor"]],"%":[[57,"op-modulo"]],"&":[[57,"op-bit-and"]],"(relation,
name) tuples in logical fields and logical columns are
unique":[[12,"relation-name-tuples-in-logical-fields-and-logical-columns-are-unique"]],"*":[[57,"op-multiply"]],"+":[[57,"op-plus"]],"-":[[57,"op-minus"]],"/":[[57,"op-divide"]],"2022
Q2":[[10,"q2"]] [...]
\ No newline at end of file
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@datafusion.apache.org
For additional commands, e-mail: commits-h...@datafusion.apache.org
