This is an automated email from the ASF dual-hosted git repository.
github-actions[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 f99c522311 Publish built docs triggered by
8c4638890378bfa8d2c6a54243310797c90fd157
f99c522311 is described below
commit f99c522311f6d7b35bb8c6f13569e6fbd6a97294
Author: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
AuthorDate: Sat Aug 1 08:31:59 2026 +0000
Publish built docs triggered by 8c4638890378bfa8d2c6a54243310797c90fd157
---
_sources/library-user-guide/upgrading/55.0.0.md.txt | 17 +++++++++++++++++
_sources/user-guide/sql/scalar_functions.md.txt | 2 +-
library-user-guide/upgrading/55.0.0.html | 16 ++++++++++++++++
searchindex.js | 2 +-
user-guide/sql/scalar_functions.html | 2 +-
5 files changed, 36 insertions(+), 3 deletions(-)
diff --git a/_sources/library-user-guide/upgrading/55.0.0.md.txt
b/_sources/library-user-guide/upgrading/55.0.0.md.txt
index d97082e881..803362d9d5 100644
--- a/_sources/library-user-guide/upgrading/55.0.0.md.txt
+++ b/_sources/library-user-guide/upgrading/55.0.0.md.txt
@@ -948,3 +948,20 @@ See [PR
#23827](https://github.com/apache/datafusion/pull/23827) for details.
The Minimum Supported Rust Version (MSRV) has been updated to [`1.94.0`].
[`1.94.0`]: https://releases.rs/docs/1.94.0/
+
+### `array_distance` scalar function now rejects multidimensional arrays
+
+`array_distance` only supports one-dimensional arrays. Previously, when given
+multidimensional arrays, it computed the distance using only the first
+subarray and ignored the remaining subarrays. For example:
+
+```sql
+SELECT array_distance(
+ [[1, 2], [100, 100]],
+ [[1, 4], [0, 0]]
+);
+```
+
+Previously, this query returned `2.0`, the distance between `[1, 2]` and
+`[1, 4]`. It now returns a planning error stating that `array_distance` only
+supports one-dimensional arrays.
diff --git a/_sources/user-guide/sql/scalar_functions.md.txt
b/_sources/user-guide/sql/scalar_functions.md.txt
index a865a3d182..e63ec0654c 100644
--- a/_sources/user-guide/sql/scalar_functions.md.txt
+++ b/_sources/user-guide/sql/scalar_functions.md.txt
@@ -3611,7 +3611,7 @@ array_dims(array)
### `array_distance`
-Returns the Euclidean distance between two input arrays of equal length.
+Returns the Euclidean distance between two one-dimensional input arrays of
equal length.
```sql
array_distance(array1, array2)
diff --git a/library-user-guide/upgrading/55.0.0.html
b/library-user-guide/upgrading/55.0.0.html
index 2392f1f980..0ad4d332e0 100644
--- a/library-user-guide/upgrading/55.0.0.html
+++ b/library-user-guide/upgrading/55.0.0.html
@@ -1263,6 +1263,21 @@ on a non-future value does not compile:</p>
<h3><code class="docutils literal notranslate"><span
class="pre">MSRV</span></code> updated to 1.94.0<a class="headerlink"
href="#msrv-updated-to-1-94-0" title="Link to this heading">#</a></h3>
<p>The Minimum Supported Rust Version (MSRV) has been updated to <a
class="reference external" href="https://releases.rs/docs/1.94.0/";><code
class="docutils literal notranslate"><span
class="pre">1.94.0</span></code></a>.</p>
</section>
+<section
id="array-distance-scalar-function-now-rejects-multidimensional-arrays">
+<h3><code class="docutils literal notranslate"><span
class="pre">array_distance</span></code> scalar function now rejects
multidimensional arrays<a class="headerlink"
href="#array-distance-scalar-function-now-rejects-multidimensional-arrays"
title="Link to this heading">#</a></h3>
+<p><code class="docutils literal notranslate"><span
class="pre">array_distance</span></code> only supports one-dimensional arrays.
Previously, when given
+multidimensional arrays, it computed the distance using only the first
+subarray and ignored the remaining subarrays. For example:</p>
+<div class="highlight-sql notranslate"><div
class="highlight"><pre><span></span><span class="k">SELECT</span><span
class="w"> </span><span class="n">array_distance</span><span class="p">(</span>
+<span class="w"> </span><span class="p">[[</span><span
class="mi">1</span><span class="p">,</span><span class="w"> </span><span
class="mi">2</span><span class="p">],</span><span class="w"> </span><span
class="p">[</span><span class="mi">100</span><span class="p">,</span><span
class="w"> </span><span class="mi">100</span><span class="p">]],</span>
+<span class="w"> </span><span class="p">[[</span><span
class="mi">1</span><span class="p">,</span><span class="w"> </span><span
class="mi">4</span><span class="p">],</span><span class="w"> </span><span
class="p">[</span><span class="mi">0</span><span class="p">,</span><span
class="w"> </span><span class="mi">0</span><span class="p">]]</span>
+<span class="p">);</span>
+</pre></div>
+</div>
+<p>Previously, this query returned <code class="docutils literal
notranslate"><span class="pre">2.0</span></code>, the distance between <code
class="docutils literal notranslate"><span class="pre">[1,</span> <span
class="pre">2]</span></code> and
+<code class="docutils literal notranslate"><span class="pre">[1,</span> <span
class="pre">4]</span></code>. It now returns a planning error stating that
<code class="docutils literal notranslate"><span
class="pre">array_distance</span></code> only
+supports one-dimensional arrays.</p>
+</section>
</section>
</section>
@@ -1340,6 +1355,7 @@ on a non-future value does not compile:</p>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link"
href="#unused-async-removed-from-several-public-functions">Unused <code
class="docutils literal notranslate"><span class="pre">async</span></code>
removed from several public functions</a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link"
href="#movingmin-and-movingmax-changed-to-pub-crate"><code class="docutils
literal notranslate"><span class="pre">MovingMin</span></code> and <code
class="docutils literal notranslate"><span class="pre">MovingMax</span></code>
changed to <code class="docutils literal notranslate"><span
class="pre">pub(crate)</span></code></a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link"
href="#msrv-updated-to-1-94-0"><code class="docutils literal notranslate"><span
class="pre">MSRV</span></code> updated to 1.94.0</a></li>
+<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link"
href="#array-distance-scalar-function-now-rejects-multidimensional-arrays"><code
class="docutils literal notranslate"><span
class="pre">array_distance</span></code> scalar function now rejects
multidimensional arrays</a></li>
</ul>
</li>
</ul>
diff --git a/searchindex.js b/searchindex.js
index f04a6e565e..0301774a9b 100644
--- a/searchindex.js
+++ b/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"alltitles":{"!=":[[74,"op-neq"]],"!~":[[74,"op-re-not-match"]],"!~*":[[74,"op-re-not-match-i"]],"!~~":[[74,"id19"]],"!~~*":[[74,"id20"]],"#":[[74,"op-bit-xor"]],"%":[[74,"op-modulo"]],"&":[[74,"op-bit-and"]],"(relation,
name) tuples in logical fields and logical columns are
unique":[[15,"relation-name-tuples-in-logical-fields-and-logical-columns-are-unique"]],"*":[[74,"op-multiply"]],"+":[[74,"op-plus"]],"-":[[74,"op-minus"]],"/":[[74,"op-divide"]],"1.
Array Literal Con [...]
\ No newline at end of file
+Search.setIndex({"alltitles":{"!=":[[74,"op-neq"]],"!~":[[74,"op-re-not-match"]],"!~*":[[74,"op-re-not-match-i"]],"!~~":[[74,"id19"]],"!~~*":[[74,"id20"]],"#":[[74,"op-bit-xor"]],"%":[[74,"op-modulo"]],"&":[[74,"op-bit-and"]],"(relation,
name) tuples in logical fields and logical columns are
unique":[[15,"relation-name-tuples-in-logical-fields-and-logical-columns-are-unique"]],"*":[[74,"op-multiply"]],"+":[[74,"op-plus"]],"-":[[74,"op-minus"]],"/":[[74,"op-divide"]],"1.
Array Literal Con [...]
\ No newline at end of file
diff --git a/user-guide/sql/scalar_functions.html
b/user-guide/sql/scalar_functions.html
index 9c3ceeb1bd..fbcb44d39c 100644
--- a/user-guide/sql/scalar_functions.html
+++ b/user-guide/sql/scalar_functions.html
@@ -4178,7 +4178,7 @@ Integers, unsigned integers, and floats are interpreted
as seconds since the uni
</section>
<section id="array-distance">
<h3><code class="docutils literal notranslate"><span
class="pre">array_distance</span></code><a class="headerlink"
href="#array-distance" title="Link to this heading">#</a></h3>
-<p>Returns the Euclidean distance between two input arrays of equal length.</p>
+<p>Returns the Euclidean distance between two one-dimensional input arrays of
equal length.</p>
<div class="highlight-sql notranslate"><div
class="highlight"><pre><span></span><span class="n">array_distance</span><span
class="p">(</span><span class="n">array1</span><span class="p">,</span><span
class="w"> </span><span class="n">array2</span><span class="p">)</span>
</pre></div>
</div>
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
