You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@datafusion.apache.org by gi...@apache.org on 2025/03/03 11:24:41 UTC
(datafusion) branch asf-site updated: Publish built docs triggered by 57a122137a0b64ea523fe6c02b88423f92b9aa0f
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 9ff863fde3 Publish built docs triggered by 57a122137a0b64ea523fe6c02b88423f92b9aa0f
9ff863fde3 is described below
commit 9ff863fde30012caaa212868348ef35566b0c6fa
Author: github-actions[bot] <gi...@users.noreply.github.com>
AuthorDate: Mon Mar 3 11:24:36 2025 +0000
Publish built docs triggered by 57a122137a0b64ea523fe6c02b88423f92b9aa0f
---
.../api-health.md.txt | 8 +
_sources/index.rst.txt | 6 +-
_sources/library-user-guide/upgrading.md.txt | 203 +++++
.../api-health.html | 94 ++-
contributor-guide/architecture.html | 11 +-
contributor-guide/communication.html | 11 +-
contributor-guide/development_environment.html | 11 +-
contributor-guide/governance.html | 11 +-
contributor-guide/gsoc_application_guidelines.html | 11 +-
contributor-guide/gsoc_project_ideas.html | 11 +-
contributor-guide/howtos.html | 17 +-
contributor-guide/index.html | 17 +-
contributor-guide/inviting.html | 11 +-
contributor-guide/roadmap.html | 11 +-
contributor-guide/specification/index.html | 11 +-
contributor-guide/specification/invariants.html | 11 +-
.../specification/output-field-name-semantic.html | 11 +-
contributor-guide/testing.html | 17 +-
download.html | 11 +-
genindex.html | 11 +-
index.html | 16 +-
library-user-guide/adding-udfs.html | 11 +-
library-user-guide/building-logical-plans.html | 11 +-
library-user-guide/catalogs.html | 11 +-
library-user-guide/custom-table-providers.html | 11 +-
library-user-guide/extending-operators.html | 11 +-
library-user-guide/extensions.html | 11 +-
library-user-guide/index.html | 11 +-
library-user-guide/profiling.html | 11 +-
library-user-guide/query-optimizer.html | 17 +-
library-user-guide/upgrading.html | 878 +++++++++++++++++++++
library-user-guide/using-the-dataframe-api.html | 11 +-
library-user-guide/using-the-sql-api.html | 11 +-
library-user-guide/working-with-exprs.html | 11 +-
objects.inv | Bin 1837 -> 1845 bytes
search.html | 11 +-
searchindex.js | 2 +-
user-guide/cli/datasources.html | 11 +-
user-guide/cli/index.html | 11 +-
user-guide/cli/installation.html | 11 +-
user-guide/cli/overview.html | 11 +-
user-guide/cli/usage.html | 11 +-
user-guide/concepts-readings-events.html | 11 +-
user-guide/configs.html | 11 +-
user-guide/crate-configuration.html | 11 +-
user-guide/dataframe.html | 11 +-
user-guide/example-usage.html | 11 +-
user-guide/explain-usage.html | 11 +-
user-guide/expressions.html | 11 +-
user-guide/faq.html | 11 +-
user-guide/features.html | 11 +-
user-guide/introduction.html | 11 +-
user-guide/sql/aggregate_functions.html | 11 +-
user-guide/sql/data_types.html | 11 +-
user-guide/sql/ddl.html | 11 +-
user-guide/sql/dml.html | 11 +-
user-guide/sql/explain.html | 11 +-
user-guide/sql/index.html | 11 +-
user-guide/sql/information_schema.html | 11 +-
user-guide/sql/operators.html | 11 +-
user-guide/sql/prepared_statements.html | 11 +-
user-guide/sql/scalar_functions.html | 11 +-
user-guide/sql/select.html | 11 +-
user-guide/sql/special_functions.html | 11 +-
user-guide/sql/subqueries.html | 11 +-
user-guide/sql/window_functions.html | 11 +-
user-guide/sql/write_options.html | 11 +-
67 files changed, 1644 insertions(+), 236 deletions(-)
diff --git a/_sources/library-user-guide/api-health.md.txt b/_sources/contributor-guide/api-health.md.txt
similarity index 92%
rename from _sources/library-user-guide/api-health.md.txt
rename to _sources/contributor-guide/api-health.md.txt
index 87d3754b21..d811bc3574 100644
--- a/_sources/library-user-guide/api-health.md.txt
+++ b/_sources/contributor-guide/api-health.md.txt
@@ -26,6 +26,14 @@ breaking API changes, but they are sometimes necessary.
When possible, rather than making breaking API changes, we prefer to deprecate
APIs to give users time to adjust to the changes.
+## Upgrade Guides
+
+When making changes that require DataFusion users to make changes to their code
+as part of an upgrade please consider adding documentation to the version
+specific [Upgrade Guide]
+
+[upgrade guide]: ../library-user-guide/upgrading.md
+
## Breaking Changes
In general, a function is part of the public API if it appears on the [docs.rs page]
diff --git a/_sources/index.rst.txt b/_sources/index.rst.txt
index 839c896d0b..d618e00f68 100644
--- a/_sources/index.rst.txt
+++ b/_sources/index.rst.txt
@@ -132,8 +132,9 @@ To get started, see
library-user-guide/extending-operators
library-user-guide/profiling
library-user-guide/query-optimizer
- library-user-guide/api-health
-.. _toc.contributor-guide:
+ library-user-guide/upgrading
+
+.. .. _toc.contributor-guide:
.. toctree::
:maxdepth: 1
@@ -144,6 +145,7 @@ To get started, see
contributor-guide/development_environment
contributor-guide/architecture
contributor-guide/testing
+ contributor-guide/api-health
contributor-guide/howtos
contributor-guide/roadmap
contributor-guide/governance
diff --git a/_sources/library-user-guide/upgrading.md.txt b/_sources/library-user-guide/upgrading.md.txt
new file mode 100644
index 0000000000..7e477d4786
--- /dev/null
+++ b/_sources/library-user-guide/upgrading.md.txt
@@ -0,0 +1,203 @@
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+# Upgrade Guides
+
+## DataFusion `46.0.0`
+
+### Use `invoke_with_args` instead of `invoke()` and `invoke_batch()`
+
+DataFusion is moving to a consistent API for invoking ScalarUDFs,
+[`ScalarUDFImpl::invoke_with_args()`], and deprecating
+[`ScalarUDFImpl::invoke()`], [`ScalarUDFImpl::invoke_batch()`], and [`ScalarUDFImpl::invoke_no_args()`]
+
+If you see errors such as the following it means the older APIs are being used:
+
+```text
+This feature is not implemented: Function concat does not implement invoke but called
+```
+
+To fix this error, use [`ScalarUDFImpl::invoke_with_args()`] instead, as shown
+below. See [PR 14876] for an example.
+
+Given existing code like this:
+
+```rust
+impl ScalarUDFImpl for SparkConcat {
+...
+ fn invoke_batch(&self, args: &[ColumnarValue], number_rows: usize) -> Result<ColumnarValue> {
+ if args
+ .iter()
+ .any(|arg| matches!(arg.data_type(), DataType::List(_)))
+ {
+ ArrayConcat::new().invoke_batch(args, number_rows)
+ } else {
+ ConcatFunc::new().invoke_batch(args, number_rows)
+ }
+ }
+}
+```
+
+To
+
+```rust
+impl ScalarUDFImpl for SparkConcat {
+ ...
+ fn invoke_with_args(&self, args: ScalarFunctionArgs) -> Result<ColumnarValue> {
+ if args
+ .args
+ .iter()
+ .any(|arg| matches!(arg.data_type(), DataType::List(_)))
+ {
+ ArrayConcat::new().invoke_with_args(args)
+ } else {
+ ConcatFunc::new().invoke_with_args(args)
+ }
+ }
+}
+```
+
+[`scalarudfimpl::invoke()`]: https://docs.rs/datafusion/latest/datafusion/logical_expr/trait.ScalarUDFImpl.html#method.invoke
+[`scalarudfimpl::invoke_batch()`]: https://docs.rs/datafusion/latest/datafusion/logical_expr/trait.ScalarUDFImpl.html#method.invoke_batch
+[`scalarudfimpl::invoke_no_args()`]: https://docs.rs/datafusion/latest/datafusion/logical_expr/trait.ScalarUDFImpl.html#method.invoke_no_args
+[`scalarudfimpl::invoke_with_args()`]: https://docs.rs/datafusion/latest/datafusion/logical_expr/trait.ScalarUDFImpl.html#method.invoke_with_args
+[pr 14876]: https://github.com/apache/datafusion/pull/14876
+
+### `ParquetExec`, `AvroExec`, `CsvExec`, `JsonExec` deprecated
+
+DataFusion 46 has a major change to how the built in DataSources are organized.
+Instead of individual `ExecutionPlan`s for the different file formats they now
+all use `DataSourceExec` and the format specific information is embodied in new
+traits `DataSource` and `FileSource`.
+
+Here is more information about
+
+- [Design Ticket]
+- Change PR [PR #14224]
+- Example of an Upgrade [PR in delta-rs]
+
+[design ticket]: https://github.com/apache/datafusion/issues/13838
+[pr #14224]: https://github.com/apache/datafusion/pull/14224
+[pr in delta-rs]: https://github.com/delta-io/delta-rs/pull/3261
+
+### Cookbook: Changes to `ParquetExecBuilder`
+
+Code that looks for `ParquetExec` like this will no longer work:
+
+```rust
+ if let Some(parquet_exec) = plan.as_any().downcast_ref::<ParquetExec>() {
+ // Do something with ParquetExec here
+ }
+```
+
+Instead, with `DataSourceExec`, the same information is now on `FileScanConfig` and
+`ParquetSource`. The equivalent code is
+
+```rust
+if let Some(datasource_exec) = plan.as_any().downcast_ref::<DataSourceExec>() {
+ if let Some(scan_config) = datasource_exec.data_source().as_any().downcast_ref::<FileScanConfig>() {
+ // FileGroups, and other information is on the FileScanConfig
+ // parquet
+ if let Some(parquet_source) = scan_config.file_source.as_any().downcast_ref::<ParquetSource>()
+ {
+ // Information on PruningPredicates and parquet options are here
+ }
+}
+```
+
+### Cookbook: Changes to `ParquetExecBuilder`
+
+Likewise code that builds `ParquetExec` using the `ParquetExecBuilder` such as
+the following must be changed:
+
+```rust
+let mut exec_plan_builder = ParquetExecBuilder::new(
+ FileScanConfig::new(self.log_store.object_store_url(), file_schema)
+ .with_projection(self.projection.cloned())
+ .with_limit(self.limit)
+ .with_table_partition_cols(table_partition_cols),
+)
+.with_schema_adapter_factory(Arc::new(DeltaSchemaAdapterFactory {}))
+.with_table_parquet_options(parquet_options);
+
+// Add filter
+if let Some(predicate) = logical_filter {
+ if config.enable_parquet_pushdown {
+ exec_plan_builder = exec_plan_builder.with_predicate(predicate);
+ }
+};
+```
+
+New code should use `FileScanConfig` to build the appropriate `DataSourceExec`:
+
+```rust
+let mut file_source = ParquetSource::new(parquet_options)
+ .with_schema_adapter_factory(Arc::new(DeltaSchemaAdapterFactory {}));
+
+// Add filter
+if let Some(predicate) = logical_filter {
+ if config.enable_parquet_pushdown {
+ file_source = file_source.with_predicate(Arc::clone(&file_schema), predicate);
+ }
+};
+
+let file_scan_config = FileScanConfig::new(
+ self.log_store.object_store_url(),
+ file_schema,
+ Arc::new(file_source),
+)
+.with_statistics(stats)
+.with_projection(self.projection.cloned())
+.with_limit(self.limit)
+.with_table_partition_cols(table_partition_cols);
+
+// Build the actual scan like this
+parquet_scan: file_scan_config.build(),
+```
+
+### `datafusion-cli` no longer automatically unescapes strings
+
+`datafusion-cli` previously would incorrectly unescape string literals (see [ticket] for more details).
+
+To escape `'` in SQL literals, use `''`:
+
+```sql
+> select 'it''s escaped';
++----------------------+
+| Utf8("it's escaped") |
++----------------------+
+| it's escaped |
++----------------------+
+1 row(s) fetched.
+```
+
+To include special characters (such as newlines via `\n`) you can use an `E` literal string. For example
+
+```sql
+> select 'foo\nbar';
++------------------+
+| Utf8("foo\nbar") |
++------------------+
+| foo\nbar |
++------------------+
+1 row(s) fetched.
+Elapsed 0.005 seconds.
+```
+
+[ticket]: https://github.com/apache/datafusion/issues/13286
diff --git a/library-user-guide/api-health.html b/contributor-guide/api-health.html
similarity index 87%
rename from library-user-guide/api-health.html
rename to contributor-guide/api-health.html
index 1d2b8e7cc4..c4cefd95c5 100644
--- a/library-user-guide/api-health.html
+++ b/contributor-guide/api-health.html
@@ -34,8 +34,8 @@
<script async="true" defer="true" src="https://buttons.github.io/buttons.js"></script>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
- <link rel="next" title="Introduction" href="../contributor-guide/index.html" />
- <link rel="prev" title="DataFusion Query Optimizer" href="query-optimizer.html" />
+ <link rel="next" title="HOWTOs" href="howtos.html" />
+ <link rel="prev" title="Testing" href="testing.html" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<meta name="docsearch:language" content="en">
@@ -311,24 +311,24 @@
Library User Guide
</span>
</p>
-<ul class="current nav bd-sidenav">
+<ul class="nav bd-sidenav">
<li class="toctree-l1">
- <a class="reference internal" href="index.html">
+ <a class="reference internal" href="../library-user-guide/index.html">
Introduction
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="extensions.html">
+ <a class="reference internal" href="../library-user-guide/extensions.html">
Extensions List
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="using-the-sql-api.html">
+ <a class="reference internal" href="../library-user-guide/using-the-sql-api.html">
Using the SQL API
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="working-with-exprs.html">
+ <a class="reference internal" href="../library-user-guide/working-with-exprs.html">
Working with
<code class="docutils literal notranslate">
<span class="pre">
@@ -339,48 +339,48 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="using-the-dataframe-api.html">
+ <a class="reference internal" href="../library-user-guide/using-the-dataframe-api.html">
Using the DataFrame API
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="building-logical-plans.html">
+ <a class="reference internal" href="../library-user-guide/building-logical-plans.html">
Building Logical Plans
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="catalogs.html">
+ <a class="reference internal" href="../library-user-guide/catalogs.html">
Catalogs, Schemas, and Tables
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="adding-udfs.html">
+ <a class="reference internal" href="../library-user-guide/adding-udfs.html">
Adding User Defined Functions: Scalar/Window/Aggregate/Table Functions
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="custom-table-providers.html">
+ <a class="reference internal" href="../library-user-guide/custom-table-providers.html">
Custom Table Provider
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="extending-operators.html">
+ <a class="reference internal" href="../library-user-guide/extending-operators.html">
Extending DataFusion’s operators: custom LogicalPlan and Execution Plans
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="profiling.html">
+ <a class="reference internal" href="../library-user-guide/profiling.html">
Profiling Cookbook
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="query-optimizer.html">
+ <a class="reference internal" href="../library-user-guide/query-optimizer.html">
DataFusion Query Optimizer
</a>
</li>
- <li class="toctree-l1 current active">
- <a class="current reference internal" href="#">
- API health policy
+ <li class="toctree-l1">
+ <a class="reference internal" href="../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -389,54 +389,59 @@
Contributor Guide
</span>
</p>
-<ul class="nav bd-sidenav">
+<ul class="current nav bd-sidenav">
<li class="toctree-l1">
- <a class="reference internal" href="../contributor-guide/index.html">
+ <a class="reference internal" href="index.html">
Introduction
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../contributor-guide/communication.html">
+ <a class="reference internal" href="communication.html">
Communication
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../contributor-guide/development_environment.html">
+ <a class="reference internal" href="development_environment.html">
Development Environment
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../contributor-guide/architecture.html">
+ <a class="reference internal" href="architecture.html">
Architecture
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../contributor-guide/testing.html">
+ <a class="reference internal" href="testing.html">
Testing
</a>
</li>
+ <li class="toctree-l1 current active">
+ <a class="current reference internal" href="#">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
- <a class="reference internal" href="../contributor-guide/howtos.html">
+ <a class="reference internal" href="howtos.html">
HOWTOs
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../contributor-guide/roadmap.html">
+ <a class="reference internal" href="roadmap.html">
Roadmap
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../contributor-guide/governance.html">
+ <a class="reference internal" href="governance.html">
Governance
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../contributor-guide/inviting.html">
+ <a class="reference internal" href="inviting.html">
Inviting New Committers and PMC Members
</a>
</li>
<li class="toctree-l1 has-children">
- <a class="reference internal" href="../contributor-guide/specification/index.html">
+ <a class="reference internal" href="specification/index.html">
Specifications
</a>
<input class="toctree-checkbox" id="toctree-checkbox-3" name="toctree-checkbox-3" type="checkbox"/>
@@ -446,24 +451,24 @@
</label>
<ul>
<li class="toctree-l2">
- <a class="reference internal" href="../contributor-guide/specification/invariants.html">
+ <a class="reference internal" href="specification/invariants.html">
Invariants
</a>
</li>
<li class="toctree-l2">
- <a class="reference internal" href="../contributor-guide/specification/output-field-name-semantic.html">
+ <a class="reference internal" href="specification/output-field-name-semantic.html">
Output field name semantics
</a>
</li>
</ul>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../contributor-guide/gsoc_application_guidelines.html">
+ <a class="reference internal" href="gsoc_application_guidelines.html">
GSoC Application Guidelines
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../contributor-guide/gsoc_project_ideas.html">
+ <a class="reference internal" href="gsoc_project_ideas.html">
GSoC Project Ideas
</a>
</li>
@@ -518,6 +523,11 @@
<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="#upgrade-guides">
+ Upgrade Guides
+ </a>
+ </li>
<li class="toc-h2 nav-item toc-entry">
<a class="reference internal nav-link" href="#breaking-changes">
Breaking Changes
@@ -537,7 +547,7 @@
<div class="tocsection editthispage">
- <a href="https://github.com/apache/arrow-datafusion/edit/main/docs/source/library-user-guide/api-health.md">
+ <a href="https://github.com/apache/arrow-datafusion/edit/main/docs/source/contributor-guide/api-health.md">
<i class="fas fa-pencil-alt"></i> Edit this page
</a>
</div>
@@ -581,6 +591,12 @@ is important that the API is well maintained. In general, we try to minimize
breaking API changes, but they are sometimes necessary.</p>
<p>When possible, rather than making breaking API changes, we prefer to deprecate
APIs to give users time to adjust to the changes.</p>
+<section id="upgrade-guides">
+<h2>Upgrade Guides<a class="headerlink" href="#upgrade-guides" title="Link to this heading">¶</a></h2>
+<p>When making changes that require DataFusion users to make changes to their code
+as part of an upgrade please consider adding documentation to the version
+specific <a class="reference internal" href="../library-user-guide/upgrading.html"><span class="std std-doc">Upgrade Guide</span></a></p>
+</section>
<section id="breaking-changes">
<h2>Breaking Changes<a class="headerlink" href="#breaking-changes" title="Link to this heading">¶</a></h2>
<p>In general, a function is part of the public API if it appears on the <a class="reference external" href="https://docs.rs/datafusion/latest/datafusion/index.html">docs.rs page</a></p>
@@ -622,17 +638,17 @@ version will be <code class="docutils literal notranslate"><span class="pre">44.
<!-- Previous / next buttons -->
<div class='prev-next-area'>
- <a class='left-prev' id="prev-link" href="query-optimizer.html" title="previous page">
+ <a class='left-prev' id="prev-link" href="testing.html" title="previous page">
<i class="fas fa-angle-left"></i>
<div class="prev-next-info">
<p class="prev-next-subtitle">previous</p>
- <p class="prev-next-title">DataFusion Query Optimizer</p>
+ <p class="prev-next-title">Testing</p>
</div>
</a>
- <a class='right-next' id="next-link" href="../contributor-guide/index.html" title="next page">
+ <a class='right-next' id="next-link" href="howtos.html" title="next page">
<div class="prev-next-info">
<p class="prev-next-subtitle">next</p>
- <p class="prev-next-title">Introduction</p>
+ <p class="prev-next-title">HOWTOs</p>
</div>
<i class="fas fa-angle-right"></i>
</a>
@@ -658,7 +674,7 @@ version will be <code class="docutils literal notranslate"><span class="pre">44.
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/contributor-guide/architecture.html b/contributor-guide/architecture.html
index d4ce150014..b4e2333245 100644
--- a/contributor-guide/architecture.html
+++ b/contributor-guide/architecture.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="howtos.html">
HOWTOs
@@ -677,7 +682,7 @@ regression in functionality</p></li>
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/contributor-guide/communication.html b/contributor-guide/communication.html
index 8ca5ed3a64..e7375951e5 100644
--- a/contributor-guide/communication.html
+++ b/contributor-guide/communication.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="howtos.html">
HOWTOs
@@ -702,7 +707,7 @@ mailing list for release coordination and other project-wide discussions. Links:
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/contributor-guide/development_environment.html b/contributor-guide/development_environment.html
index 05de272c04..b027941081 100644
--- a/contributor-guide/development_environment.html
+++ b/contributor-guide/development_environment.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="howtos.html">
HOWTOs
@@ -702,7 +707,7 @@ libprotoc<span class="w"> </span><span class="m">3</span>.15.0
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/contributor-guide/governance.html b/contributor-guide/governance.html
index f9d657d84c..b59ee71b04 100644
--- a/contributor-guide/governance.html
+++ b/contributor-guide/governance.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="howtos.html">
HOWTOs
@@ -687,7 +692,7 @@ direction, typically over the course of a year or more.</p>
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/contributor-guide/gsoc_application_guidelines.html b/contributor-guide/gsoc_application_guidelines.html
index dad52c69f8..cfca478f41 100644
--- a/contributor-guide/gsoc_application_guidelines.html
+++ b/contributor-guide/gsoc_application_guidelines.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="howtos.html">
HOWTOs
@@ -738,7 +743,7 @@ Add anything else you believe strengthens your application.
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/contributor-guide/gsoc_project_ideas.html b/contributor-guide/gsoc_project_ideas.html
index ae2a250aa1..77f0675cea 100644
--- a/contributor-guide/gsoc_project_ideas.html
+++ b/contributor-guide/gsoc_project_ideas.html
@@ -378,8 +378,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -414,6 +414,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="howtos.html">
HOWTOs
@@ -789,7 +794,7 @@
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/contributor-guide/howtos.html b/contributor-guide/howtos.html
index ac5658a9da..2204a66d2a 100644
--- a/contributor-guide/howtos.html
+++ b/contributor-guide/howtos.html
@@ -35,7 +35,7 @@
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="Roadmap" href="roadmap.html" />
- <link rel="prev" title="Testing" href="testing.html" />
+ <link rel="prev" title="API health policy" href="api-health.html" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<meta name="docsearch:language" content="en">
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1 current active">
<a class="current reference internal" href="#">
HOWTOs
@@ -771,11 +776,11 @@ valid installation of <a class="reference external" href="https://github.com/pro
<!-- Previous / next buttons -->
<div class='prev-next-area'>
- <a class='left-prev' id="prev-link" href="testing.html" title="previous page">
+ <a class='left-prev' id="prev-link" href="api-health.html" title="previous page">
<i class="fas fa-angle-left"></i>
<div class="prev-next-info">
<p class="prev-next-subtitle">previous</p>
- <p class="prev-next-title">Testing</p>
+ <p class="prev-next-title">API health policy</p>
</div>
</a>
<a class='right-next' id="next-link" href="roadmap.html" title="next page">
@@ -807,7 +812,7 @@ valid installation of <a class="reference external" href="https://github.com/pro
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/contributor-guide/index.html b/contributor-guide/index.html
index c633bed116..dc3d417d0b 100644
--- a/contributor-guide/index.html
+++ b/contributor-guide/index.html
@@ -35,7 +35,7 @@
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="Communication" href="communication.html" />
- <link rel="prev" title="API health policy" href="../library-user-guide/api-health.html" />
+ <link rel="prev" title="Upgrade Guides" href="../library-user-guide/upgrading.html" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<meta name="docsearch:language" content="en">
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="howtos.html">
HOWTOs
@@ -823,11 +828,11 @@ Commenting on the PR will remove the <code class="docutils literal notranslate">
<!-- Previous / next buttons -->
<div class='prev-next-area'>
- <a class='left-prev' id="prev-link" href="../library-user-guide/api-health.html" title="previous page">
+ <a class='left-prev' id="prev-link" href="../library-user-guide/upgrading.html" title="previous page">
<i class="fas fa-angle-left"></i>
<div class="prev-next-info">
<p class="prev-next-subtitle">previous</p>
- <p class="prev-next-title">API health policy</p>
+ <p class="prev-next-title">Upgrade Guides</p>
</div>
</a>
<a class='right-next' id="next-link" href="communication.html" title="next page">
@@ -859,7 +864,7 @@ Commenting on the PR will remove the <code class="docutils literal notranslate">
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/contributor-guide/inviting.html b/contributor-guide/inviting.html
index 0c5c74f3be..6d3cf835d5 100644
--- a/contributor-guide/inviting.html
+++ b/contributor-guide/inviting.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="howtos.html">
HOWTOs
@@ -1071,7 +1076,7 @@ Congratulations and welcome!
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/contributor-guide/roadmap.html b/contributor-guide/roadmap.html
index bedef3daac..2a57bbae63 100644
--- a/contributor-guide/roadmap.html
+++ b/contributor-guide/roadmap.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="howtos.html">
HOWTOs
@@ -834,7 +839,7 @@ date.</p>
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/contributor-guide/specification/index.html b/contributor-guide/specification/index.html
index 38cdd27786..c793c632ca 100644
--- a/contributor-guide/specification/index.html
+++ b/contributor-guide/specification/index.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../howtos.html">
HOWTOs
@@ -600,7 +605,7 @@ specifications:</p>
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/contributor-guide/specification/invariants.html b/contributor-guide/specification/invariants.html
index c8540b3120..cc543aa295 100644
--- a/contributor-guide/specification/invariants.html
+++ b/contributor-guide/specification/invariants.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../howtos.html">
HOWTOs
@@ -1110,7 +1115,7 @@ schemas.</p>
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/contributor-guide/specification/output-field-name-semantic.html b/contributor-guide/specification/output-field-name-semantic.html
index bc17c8fdb6..4d513e972e 100644
--- a/contributor-guide/specification/output-field-name-semantic.html
+++ b/contributor-guide/specification/output-field-name-semantic.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../howtos.html">
HOWTOs
@@ -1036,7 +1041,7 @@ DataFusion queries planned from both SQL queries and Dataframe APIs.</p>
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/contributor-guide/testing.html b/contributor-guide/testing.html
index 3a4696160b..baa6dd02e8 100644
--- a/contributor-guide/testing.html
+++ b/contributor-guide/testing.html
@@ -34,7 +34,7 @@
<script async="true" defer="true" src="https://buttons.github.io/buttons.js"></script>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
- <link rel="next" title="HOWTOs" href="howtos.html" />
+ <link rel="next" title="API health policy" href="api-health.html" />
<link rel="prev" title="Architecture" href="architecture.html" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<meta name="docsearch:language" content="en">
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="howtos.html">
HOWTOs
@@ -762,10 +767,10 @@ tested in the same way using the <a class="reference external" href="https://doc
<p class="prev-next-title">Architecture</p>
</div>
</a>
- <a class='right-next' id="next-link" href="howtos.html" title="next page">
+ <a class='right-next' id="next-link" href="api-health.html" title="next page">
<div class="prev-next-info">
<p class="prev-next-subtitle">next</p>
- <p class="prev-next-title">HOWTOs</p>
+ <p class="prev-next-title">API health policy</p>
</div>
<i class="fas fa-angle-right"></i>
</a>
@@ -791,7 +796,7 @@ tested in the same way using the <a class="reference external" href="https://doc
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/download.html b/download.html
index 7607397033..ddccece6f3 100644
--- a/download.html
+++ b/download.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="contributor-guide/howtos.html">
HOWTOs
@@ -673,7 +678,7 @@ official Apache DataFusion releases are provided as source artifacts.</p>
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/genindex.html b/genindex.html
index 4547409a25..ff1651d32d 100644
--- a/genindex.html
+++ b/genindex.html
@@ -376,8 +376,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -412,6 +412,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="contributor-guide/howtos.html">
HOWTOs
@@ -552,7 +557,7 @@
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/index.html b/index.html
index ffe9bc5654..5bb2539065 100644
--- a/index.html
+++ b/index.html
@@ -378,8 +378,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -414,6 +414,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="contributor-guide/howtos.html">
HOWTOs
@@ -634,10 +639,10 @@ See the <a class="reference external" href="https://datafusion.apache.org/contri
<li class="toctree-l1"><a class="reference internal" href="library-user-guide/extending-operators.html">Extending DataFusion’s operators: custom LogicalPlan and Execution Plans</a></li>
<li class="toctree-l1"><a class="reference internal" href="library-user-guide/profiling.html">Profiling Cookbook</a></li>
<li class="toctree-l1"><a class="reference internal" href="library-user-guide/query-optimizer.html">DataFusion Query Optimizer</a></li>
-<li class="toctree-l1"><a class="reference internal" href="library-user-guide/api-health.html">API health policy</a></li>
+<li class="toctree-l1"><a class="reference internal" href="library-user-guide/upgrading.html">Upgrade Guides</a></li>
</ul>
</div>
-<div class="toctree-wrapper compound" id="toc-contributor-guide">
+<div class="toctree-wrapper compound">
<p aria-level="2" class="caption" role="heading"><span class="caption-text">Contributor Guide</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="contributor-guide/index.html">Introduction</a></li>
@@ -647,6 +652,7 @@ See the <a class="reference external" href="https://datafusion.apache.org/contri
<li class="toctree-l1"><a class="reference internal" href="contributor-guide/development_environment.html">Development Environment</a></li>
<li class="toctree-l1"><a class="reference internal" href="contributor-guide/architecture.html">Architecture</a></li>
<li class="toctree-l1"><a class="reference internal" href="contributor-guide/testing.html">Testing</a></li>
+<li class="toctree-l1"><a class="reference internal" href="contributor-guide/api-health.html">API health policy</a></li>
<li class="toctree-l1"><a class="reference internal" href="contributor-guide/howtos.html">HOWTOs</a></li>
<li class="toctree-l1"><a class="reference internal" href="contributor-guide/roadmap.html">Roadmap</a></li>
<li class="toctree-l1"><a class="reference internal" href="contributor-guide/roadmap.html#quarterly-roadmap">Quarterly Roadmap</a></li>
@@ -702,7 +708,7 @@ See the <a class="reference external" href="https://datafusion.apache.org/contri
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/library-user-guide/adding-udfs.html b/library-user-guide/adding-udfs.html
index d361e6baa4..e2e49bb70d 100644
--- a/library-user-guide/adding-udfs.html
+++ b/library-user-guide/adding-udfs.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="api-health.html">
- API health policy
+ <a class="reference internal" href="upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../contributor-guide/howtos.html">
HOWTOs
@@ -1359,7 +1364,7 @@ validation of the input <code class="docutils literal notranslate"><span class="
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/library-user-guide/building-logical-plans.html b/library-user-guide/building-logical-plans.html
index 9d1f44a7bd..a20272a435 100644
--- a/library-user-guide/building-logical-plans.html
+++ b/library-user-guide/building-logical-plans.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="api-health.html">
- API health policy
+ <a class="reference internal" href="upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../contributor-guide/howtos.html">
HOWTOs
@@ -805,7 +810,7 @@ suitable if you are using DataFusion to build logical plans but do not use DataF
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/library-user-guide/catalogs.html b/library-user-guide/catalogs.html
index 34e7bfa3d0..be3936dbb5 100644
--- a/library-user-guide/catalogs.html
+++ b/library-user-guide/catalogs.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="api-health.html">
- API health policy
+ <a class="reference internal" href="upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../contributor-guide/howtos.html">
HOWTOs
@@ -877,7 +882,7 @@
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/library-user-guide/custom-table-providers.html b/library-user-guide/custom-table-providers.html
index c1a6e5f71d..ba5abe3afb 100644
--- a/library-user-guide/custom-table-providers.html
+++ b/library-user-guide/custom-table-providers.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="api-health.html">
- API health policy
+ <a class="reference internal" href="upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../contributor-guide/howtos.html">
HOWTOs
@@ -929,7 +934,7 @@
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/library-user-guide/extending-operators.html b/library-user-guide/extending-operators.html
index 14b37fa4a0..a464f39c78 100644
--- a/library-user-guide/extending-operators.html
+++ b/library-user-guide/extending-operators.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="api-health.html">
- API health policy
+ <a class="reference internal" href="upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../contributor-guide/howtos.html">
HOWTOs
@@ -606,7 +611,7 @@
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/library-user-guide/extensions.html b/library-user-guide/extensions.html
index 90ba47e2d8..93e1de27a5 100644
--- a/library-user-guide/extensions.html
+++ b/library-user-guide/extensions.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="api-health.html">
- API health policy
+ <a class="reference internal" href="upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../contributor-guide/howtos.html">
HOWTOs
@@ -669,7 +674,7 @@ your extension.</p>
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/library-user-guide/index.html b/library-user-guide/index.html
index 3471861d6e..6824aeb576 100644
--- a/library-user-guide/index.html
+++ b/library-user-guide/index.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="api-health.html">
- API health policy
+ <a class="reference internal" href="upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../contributor-guide/howtos.html">
HOWTOs
@@ -621,7 +626,7 @@ useful place to get the lay of the land before starting down a specific path.</p
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/library-user-guide/profiling.html b/library-user-guide/profiling.html
index 397b1e3c7e..bc20304ca8 100644
--- a/library-user-guide/profiling.html
+++ b/library-user-guide/profiling.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="api-health.html">
- API health policy
+ <a class="reference internal" href="upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../contributor-guide/howtos.html">
HOWTOs
@@ -731,7 +736,7 @@ in images such as this:</p>
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/library-user-guide/query-optimizer.html b/library-user-guide/query-optimizer.html
index 9161beeef8..3d8c5db18d 100644
--- a/library-user-guide/query-optimizer.html
+++ b/library-user-guide/query-optimizer.html
@@ -34,7 +34,7 @@
<script async="true" defer="true" src="https://buttons.github.io/buttons.js"></script>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
- <link rel="next" title="API health policy" href="api-health.html" />
+ <link rel="next" title="Upgrade Guides" href="upgrading.html" />
<link rel="prev" title="Profiling Cookbook" href="profiling.html" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<meta name="docsearch:language" content="en">
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="api-health.html">
- API health policy
+ <a class="reference internal" href="upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../contributor-guide/howtos.html">
HOWTOs
@@ -1088,10 +1093,10 @@ take.</p>
<p class="prev-next-title">Profiling Cookbook</p>
</div>
</a>
- <a class='right-next' id="next-link" href="api-health.html" title="next page">
+ <a class='right-next' id="next-link" href="upgrading.html" title="next page">
<div class="prev-next-info">
<p class="prev-next-subtitle">next</p>
- <p class="prev-next-title">API health policy</p>
+ <p class="prev-next-title">Upgrade Guides</p>
</div>
<i class="fas fa-angle-right"></i>
</a>
@@ -1117,7 +1122,7 @@ take.</p>
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/library-user-guide/upgrading.html b/library-user-guide/upgrading.html
new file mode 100644
index 0000000000..e73f5f137f
--- /dev/null
+++ b/library-user-guide/upgrading.html
@@ -0,0 +1,878 @@
+<!DOCTYPE html>
+
+<html lang="en" data-content_root="../">
+ <head>
+ <meta charset="utf-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
+
+ <title>Upgrade Guides — Apache DataFusion documentation</title>
+
+ <link href="../_static/styles/theme.css?digest=1999514e3f237ded88cf" rel="stylesheet">
+<link href="../_static/styles/pydata-sphinx-theme.css?digest=1999514e3f237ded88cf" rel="stylesheet">
+
+
+ <link rel="stylesheet"
+ href="../_static/vendor/fontawesome/5.13.0/css/all.min.css">
+ <link rel="preload" as="font" type="font/woff2" crossorigin
+ href="../_static/vendor/fontawesome/5.13.0/webfonts/fa-solid-900.woff2">
+ <link rel="preload" as="font" type="font/woff2" crossorigin
+ href="../_static/vendor/fontawesome/5.13.0/webfonts/fa-brands-400.woff2">
+
+
+
+
+
+ <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=8f2a1f02" />
+ <link rel="stylesheet" type="text/css" href="../_static/styles/pydata-sphinx-theme.css?v=1140d252" />
+ <link rel="stylesheet" type="text/css" href="../_static/theme_overrides.css?v=c6d785ac" />
+
+ <link rel="preload" as="script" href="../_static/scripts/pydata-sphinx-theme.js?digest=1999514e3f237ded88cf">
+
+ <script src="../_static/documentation_options.js?v=8a448e45"></script>
+ <script src="../_static/doctools.js?v=9bcbadda"></script>
+ <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
+ <script async="true" defer="true" src="https://buttons.github.io/buttons.js"></script>
+ <link rel="index" title="Index" href="../genindex.html" />
+ <link rel="search" title="Search" href="../search.html" />
+ <link rel="next" title="Introduction" href="../contributor-guide/index.html" />
+ <link rel="prev" title="DataFusion Query Optimizer" href="query-optimizer.html" />
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
+ <meta name="docsearch:language" content="en">
+
+
+ <!-- Google Analytics -->
+
+ </head>
+ <body data-spy="scroll" data-target="#bd-toc-nav" data-offset="80">
+
+ <div class="container-fluid" id="banner"></div>
+
+
+
+
+ <div class="container-xl">
+ <div class="row">
+
+
+ <!-- Only show if we have sidebars configured, else just a small margin -->
+ <div class="col-12 col-md-3 bd-sidebar">
+ <div class="sidebar-start-items">
+
+<form class="bd-search d-flex align-items-center" action="../search.html" method="get">
+ <i class="icon fas fa-search"></i>
+ <input type="search" class="form-control" name="q" id="search-input" placeholder="Search the docs ..." aria-label="Search the docs ..." autocomplete="off" >
+</form>
+
+<nav class="bd-links" id="bd-docs-nav" aria-label="Main navigation">
+ <div class="bd-toc-item active">
+
+ <p aria-level="2" class="caption" role="heading">
+ <span class="caption-text">
+ ASF Links
+ </span>
+</p>
+<ul class="nav bd-sidenav">
+ <li class="toctree-l1">
+ <a class="reference external" href="https://apache.org">
+ Apache Software Foundation
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference external" href="https://www.apache.org/licenses/">
+ License
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference external" href="https://www.apache.org/foundation/sponsorship.html">
+ Donate
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference external" href="https://www.apache.org/foundation/thanks.html">
+ Thanks
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference external" href="https://www.apache.org/security/">
+ Security
+ </a>
+ </li>
+</ul>
+<p aria-level="2" class="caption" role="heading">
+ <span class="caption-text">
+ Links
+ </span>
+</p>
+<ul class="nav bd-sidenav">
+ <li class="toctree-l1">
+ <a class="reference external" href="https://github.com/apache/datafusion">
+ GitHub and Issue Tracker
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference external" href="https://crates.io/crates/datafusion">
+ crates.io
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference external" href="https://docs.rs/datafusion/latest/datafusion/">
+ API Docs
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference external" href="https://datafusion.apache.org/blog/">
+ Blog
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference external" href="https://github.com/apache/datafusion/blob/main/CODE_OF_CONDUCT.md">
+ Code of conduct
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../download.html">
+ Download
+ </a>
+ </li>
+</ul>
+<p aria-level="2" class="caption" role="heading">
+ <span class="caption-text">
+ User Guide
+ </span>
+</p>
+<ul class="nav bd-sidenav">
+ <li class="toctree-l1">
+ <a class="reference internal" href="../user-guide/introduction.html">
+ Introduction
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../user-guide/example-usage.html">
+ Example Usage
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../user-guide/features.html">
+ Features
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../user-guide/concepts-readings-events.html">
+ Concepts, Readings, Events
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../user-guide/crate-configuration.html">
+ Crate Configuration
+ </a>
+ </li>
+ <li class="toctree-l1 has-children">
+ <a class="reference internal" href="../user-guide/cli/index.html">
+ DataFusion CLI
+ </a>
+ <input class="toctree-checkbox" id="toctree-checkbox-1" name="toctree-checkbox-1" type="checkbox"/>
+ <label for="toctree-checkbox-1">
+ <i class="fas fa-chevron-down">
+ </i>
+ </label>
+ <ul>
+ <li class="toctree-l2">
+ <a class="reference internal" href="../user-guide/cli/overview.html">
+ Overview
+ </a>
+ </li>
+ <li class="toctree-l2">
+ <a class="reference internal" href="../user-guide/cli/installation.html">
+ Installation
+ </a>
+ </li>
+ <li class="toctree-l2">
+ <a class="reference internal" href="../user-guide/cli/usage.html">
+ Usage
+ </a>
+ </li>
+ <li class="toctree-l2">
+ <a class="reference internal" href="../user-guide/cli/datasources.html">
+ Local Files / Directories
+ </a>
+ </li>
+ </ul>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../user-guide/dataframe.html">
+ DataFrame API
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../user-guide/expressions.html">
+ Expression API
+ </a>
+ </li>
+ <li class="toctree-l1 has-children">
+ <a class="reference internal" href="../user-guide/sql/index.html">
+ SQL Reference
+ </a>
+ <input class="toctree-checkbox" id="toctree-checkbox-2" name="toctree-checkbox-2" type="checkbox"/>
+ <label for="toctree-checkbox-2">
+ <i class="fas fa-chevron-down">
+ </i>
+ </label>
+ <ul>
+ <li class="toctree-l2">
+ <a class="reference internal" href="../user-guide/sql/data_types.html">
+ Data Types
+ </a>
+ </li>
+ <li class="toctree-l2">
+ <a class="reference internal" href="../user-guide/sql/select.html">
+ SELECT syntax
+ </a>
+ </li>
+ <li class="toctree-l2">
+ <a class="reference internal" href="../user-guide/sql/subqueries.html">
+ Subqueries
+ </a>
+ </li>
+ <li class="toctree-l2">
+ <a class="reference internal" href="../user-guide/sql/ddl.html">
+ DDL
+ </a>
+ </li>
+ <li class="toctree-l2">
+ <a class="reference internal" href="../user-guide/sql/dml.html">
+ DML
+ </a>
+ </li>
+ <li class="toctree-l2">
+ <a class="reference internal" href="../user-guide/sql/explain.html">
+ EXPLAIN
+ </a>
+ </li>
+ <li class="toctree-l2">
+ <a class="reference internal" href="../user-guide/sql/information_schema.html">
+ Information Schema
+ </a>
+ </li>
+ <li class="toctree-l2">
+ <a class="reference internal" href="../user-guide/sql/operators.html">
+ Operators and Literals
+ </a>
+ </li>
+ <li class="toctree-l2">
+ <a class="reference internal" href="../user-guide/sql/aggregate_functions.html">
+ Aggregate Functions
+ </a>
+ </li>
+ <li class="toctree-l2">
+ <a class="reference internal" href="../user-guide/sql/window_functions.html">
+ Window Functions
+ </a>
+ </li>
+ <li class="toctree-l2">
+ <a class="reference internal" href="../user-guide/sql/scalar_functions.html">
+ Scalar Functions
+ </a>
+ </li>
+ <li class="toctree-l2">
+ <a class="reference internal" href="../user-guide/sql/special_functions.html">
+ Special Functions
+ </a>
+ </li>
+ <li class="toctree-l2">
+ <a class="reference internal" href="../user-guide/sql/write_options.html">
+ Write Options
+ </a>
+ </li>
+ <li class="toctree-l2">
+ <a class="reference internal" href="../user-guide/sql/prepared_statements.html">
+ Prepared Statements
+ </a>
+ </li>
+ </ul>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../user-guide/configs.html">
+ Configuration Settings
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../user-guide/explain-usage.html">
+ Reading Explain Plans
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../user-guide/faq.html">
+ Frequently Asked Questions
+ </a>
+ </li>
+</ul>
+<p aria-level="2" class="caption" role="heading">
+ <span class="caption-text">
+ Library User Guide
+ </span>
+</p>
+<ul class="current nav bd-sidenav">
+ <li class="toctree-l1">
+ <a class="reference internal" href="index.html">
+ Introduction
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="extensions.html">
+ Extensions List
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="using-the-sql-api.html">
+ Using the SQL API
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="working-with-exprs.html">
+ Working with
+ <code class="docutils literal notranslate">
+ <span class="pre">
+ Expr
+ </span>
+ </code>
+ s
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="using-the-dataframe-api.html">
+ Using the DataFrame API
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="building-logical-plans.html">
+ Building Logical Plans
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="catalogs.html">
+ Catalogs, Schemas, and Tables
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="adding-udfs.html">
+ Adding User Defined Functions: Scalar/Window/Aggregate/Table Functions
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="custom-table-providers.html">
+ Custom Table Provider
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="extending-operators.html">
+ Extending DataFusion’s operators: custom LogicalPlan and Execution Plans
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="profiling.html">
+ Profiling Cookbook
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="query-optimizer.html">
+ DataFusion Query Optimizer
+ </a>
+ </li>
+ <li class="toctree-l1 current active">
+ <a class="current reference internal" href="#">
+ Upgrade Guides
+ </a>
+ </li>
+</ul>
+<p aria-level="2" class="caption" role="heading">
+ <span class="caption-text">
+ Contributor Guide
+ </span>
+</p>
+<ul class="nav bd-sidenav">
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/index.html">
+ Introduction
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/communication.html">
+ Communication
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/development_environment.html">
+ Development Environment
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/architecture.html">
+ Architecture
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/testing.html">
+ Testing
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/howtos.html">
+ HOWTOs
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/roadmap.html">
+ Roadmap
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/governance.html">
+ Governance
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/inviting.html">
+ Inviting New Committers and PMC Members
+ </a>
+ </li>
+ <li class="toctree-l1 has-children">
+ <a class="reference internal" href="../contributor-guide/specification/index.html">
+ Specifications
+ </a>
+ <input class="toctree-checkbox" id="toctree-checkbox-3" name="toctree-checkbox-3" type="checkbox"/>
+ <label for="toctree-checkbox-3">
+ <i class="fas fa-chevron-down">
+ </i>
+ </label>
+ <ul>
+ <li class="toctree-l2">
+ <a class="reference internal" href="../contributor-guide/specification/invariants.html">
+ Invariants
+ </a>
+ </li>
+ <li class="toctree-l2">
+ <a class="reference internal" href="../contributor-guide/specification/output-field-name-semantic.html">
+ Output field name semantics
+ </a>
+ </li>
+ </ul>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/gsoc_application_guidelines.html">
+ GSoC Application Guidelines
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/gsoc_project_ideas.html">
+ GSoC Project Ideas
+ </a>
+ </li>
+</ul>
+<p aria-level="2" class="caption" role="heading">
+ <span class="caption-text">
+ DataFusion Subprojects
+ </span>
+</p>
+<ul class="nav bd-sidenav">
+ <li class="toctree-l1">
+ <a class="reference external" href="https://arrow.apache.org/ballista/">
+ DataFusion Ballista
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference external" href="https://datafusion.apache.org/comet/">
+ DataFusion Comet
+ </a>
+ </li>
+ <li class="toctree-l1">
+ <a class="reference external" href="https://datafusion.apache.org/python/">
+ DataFusion Python
+ </a>
+ </li>
+</ul>
+
+
+ </div>
+
+ <a class="navbar-brand" href="../index.html">
+ <img src="../_static/images/2x_bgwhite_original.png" class="logo" alt="logo">
+ </a>
+</nav>
+
+ </div>
+ <div class="sidebar-end-items">
+ </div>
+ </div>
+
+
+
+
+ <div class="d-none d-xl-block col-xl-2 bd-toc">
+
+
+ <div class="toc-item">
+
+<div class="tocsection onthispage pt-5 pb-3">
+ <i class="fas fa-list"></i> On this page
+</div>
+
+<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-46-0-0">
+ DataFusion
+ <code class="docutils literal notranslate">
+ <span class="pre">
+ 46.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="#use-invoke-with-args-instead-of-invoke-and-invoke-batch">
+ Use
+ <code class="docutils literal notranslate">
+ <span class="pre">
+ invoke_with_args
+ </span>
+ </code>
+ instead of
+ <code class="docutils literal notranslate">
+ <span class="pre">
+ invoke()
+ </span>
+ </code>
+ and
+ <code class="docutils literal notranslate">
+ <span class="pre">
+ invoke_batch()
+ </span>
+ </code>
+ </a>
+ </li>
+ <li class="toc-h3 nav-item toc-entry">
+ <a class="reference internal nav-link" href="#parquetexec-avroexec-csvexec-jsonexec-deprecated">
+ <code class="docutils literal notranslate">
+ <span class="pre">
+ ParquetExec
+ </span>
+ </code>
+ ,
+ <code class="docutils literal notranslate">
+ <span class="pre">
+ AvroExec
+ </span>
+ </code>
+ ,
+ <code class="docutils literal notranslate">
+ <span class="pre">
+ CsvExec
+ </span>
+ </code>
+ ,
+ <code class="docutils literal notranslate">
+ <span class="pre">
+ JsonExec
+ </span>
+ </code>
+ deprecated
+ </a>
+ </li>
+ <li class="toc-h3 nav-item toc-entry">
+ <a class="reference internal nav-link" href="#cookbook-changes-to-parquetexecbuilder">
+ Cookbook: Changes to
+ <code class="docutils literal notranslate">
+ <span class="pre">
+ ParquetExecBuilder
+ </span>
+ </code>
+ </a>
+ </li>
+ <li class="toc-h3 nav-item toc-entry">
+ <a class="reference internal nav-link" href="#id1">
+ Cookbook: Changes to
+ <code class="docutils literal notranslate">
+ <span class="pre">
+ ParquetExecBuilder
+ </span>
+ </code>
+ </a>
+ </li>
+ <li class="toc-h3 nav-item toc-entry">
+ <a class="reference internal nav-link" href="#datafusion-cli-no-longer-automatically-unescapes-strings">
+ <code class="docutils literal notranslate">
+ <span class="pre">
+ datafusion-cli
+ </span>
+ </code>
+ no longer automatically unescapes strings
+ </a>
+ </li>
+ </ul>
+ </li>
+</ul>
+
+</nav>
+ </div>
+
+ <div class="toc-item">
+
+
+<div class="tocsection editthispage">
+ <a href="https://github.com/apache/arrow-datafusion/edit/main/docs/source/library-user-guide/upgrading.md">
+ <i class="fas fa-pencil-alt"></i> Edit this page
+ </a>
+</div>
+
+ </div>
+
+
+ </div>
+
+
+
+
+
+
+ <main class="col-12 col-md-9 col-xl-7 py-md-5 pl-md-5 pr-md-4 bd-content" role="main">
+
+ <div>
+
+ <!---
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+<section id="upgrade-guides">
+<h1>Upgrade Guides<a class="headerlink" href="#upgrade-guides" title="Link to this heading">¶</a></h1>
+<section id="datafusion-46-0-0">
+<h2>DataFusion <code class="docutils literal notranslate"><span class="pre">46.0.0</span></code><a class="headerlink" href="#datafusion-46-0-0" title="Link to this heading">¶</a></h2>
+<section id="use-invoke-with-args-instead-of-invoke-and-invoke-batch">
+<h3>Use <code class="docutils literal notranslate"><span class="pre">invoke_with_args</span></code> instead of <code class="docutils literal notranslate"><span class="pre">invoke()</span></code> and <code class="docutils literal notranslate"><span class="pre">invoke_batch()</span></code><a class="headerlink" href="#use-invoke-with-args-instead-of-invoke-and-invoke-batch" title="Link to this heading">¶</a></h3>
+<p>DataFusion is moving to a consistent API for invoking ScalarUDFs,
+<a class="reference external" href="https://docs.rs/datafusion/latest/datafusion/logical_expr/trait.ScalarUDFImpl.html#method.invoke_with_args"><code class="docutils literal notranslate"><span class="pre">ScalarUDFImpl::invoke_with_args()</span></code></a>, and deprecating
+<a class="reference external" href="https://docs.rs/datafusion/latest/datafusion/logical_expr/trait.ScalarUDFImpl.html#method.invoke"><code class="docutils literal notranslate"><span class="pre">ScalarUDFImpl::invoke()</span></code></a>, <a class="reference external" href="https://docs.rs/datafusion/latest/datafusion/logical_expr/trait.ScalarUDFImpl.html#method.invoke_batch"><code class="docutils literal notranslate"><span class="pre">ScalarUDFImpl::invoke_batch()</span></code></a>, and [...]
+<p>If you see errors such as the following it means the older APIs are being used:</p>
+<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>This feature is not implemented: Function concat does not implement invoke but called
+</pre></div>
+</div>
+<p>To fix this error, use <a class="reference external" href="https://docs.rs/datafusion/latest/datafusion/logical_expr/trait.ScalarUDFImpl.html#method.invoke_with_args"><code class="docutils literal notranslate"><span class="pre">ScalarUDFImpl::invoke_with_args()</span></code></a> instead, as shown
+below. See <a class="reference external" href="https://github.com/apache/datafusion/pull/14876">PR 14876</a> for an example.</p>
+<p>Given existing code like this:</p>
+<div class="highlight-rust notranslate"><div class="highlight"><pre><span></span><span class="k">impl</span><span class="w"> </span><span class="n">ScalarUDFImpl</span><span class="w"> </span><span class="k">for</span><span class="w"> </span><span class="n">SparkConcat</span><span class="w"> </span><span class="p">{</span>
+<span class="o">..</span><span class="p">.</span>
+<span class="w"> </span><span class="k">fn</span><span class="w"> </span><span class="nf">invoke_batch</span><span class="p">(</span><span class="o">&</span><span class="bp">self</span><span class="p">,</span><span class="w"> </span><span class="n">args</span><span class="p">:</span><span class="w"> </span><span class="kp">&</span><span class="p">[</span><span class="n">ColumnarValue</span><span class="p">],</span><span class="w"> </span><span class="n">number_rows</span><span [...]
+<span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="n">args</span>
+<span class="w"> </span><span class="p">.</span><span class="n">iter</span><span class="p">()</span>
+<span class="w"> </span><span class="p">.</span><span class="n">any</span><span class="p">(</span><span class="o">|</span><span class="n">arg</span><span class="o">|</span><span class="w"> </span><span class="fm">matches!</span><span class="p">(</span><span class="n">arg</span><span class="p">.</span><span class="n">data_type</span><span class="p">(),</span><span class="w"> </span><span class="n">DataType</span><span class="p">::</span><span class="n">List</span><span class="p [...]
+<span class="w"> </span><span class="p">{</span>
+<span class="w"> </span><span class="n">ArrayConcat</span><span class="p">::</span><span class="n">new</span><span class="p">().</span><span class="n">invoke_batch</span><span class="p">(</span><span class="n">args</span><span class="p">,</span><span class="w"> </span><span class="n">number_rows</span><span class="p">)</span>
+<span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="k">else</span><span class="w"> </span><span class="p">{</span>
+<span class="w"> </span><span class="n">ConcatFunc</span><span class="p">::</span><span class="n">new</span><span class="p">().</span><span class="n">invoke_batch</span><span class="p">(</span><span class="n">args</span><span class="p">,</span><span class="w"> </span><span class="n">number_rows</span><span class="p">)</span>
+<span class="w"> </span><span class="p">}</span>
+<span class="w"> </span><span class="p">}</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p>To</p>
+<div class="highlight-rust notranslate"><div class="highlight"><pre><span></span><span class="k">impl</span><span class="w"> </span><span class="n">ScalarUDFImpl</span><span class="w"> </span><span class="k">for</span><span class="w"> </span><span class="n">SparkConcat</span><span class="w"> </span><span class="p">{</span>
+<span class="w"> </span><span class="o">..</span><span class="p">.</span>
+<span class="w"> </span><span class="k">fn</span><span class="w"> </span><span class="nf">invoke_with_args</span><span class="p">(</span><span class="o">&</span><span class="bp">self</span><span class="p">,</span><span class="w"> </span><span class="n">args</span><span class="p">:</span><span class="w"> </span><span class="nc">ScalarFunctionArgs</span><span class="p">)</span><span class="w"> </span><span class="p">-></span><span class="w"> </span><span class="nb">Result</span>< [...]
+<span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="n">args</span>
+<span class="w"> </span><span class="p">.</span><span class="n">args</span>
+<span class="w"> </span><span class="p">.</span><span class="n">iter</span><span class="p">()</span>
+<span class="w"> </span><span class="p">.</span><span class="n">any</span><span class="p">(</span><span class="o">|</span><span class="n">arg</span><span class="o">|</span><span class="w"> </span><span class="fm">matches!</span><span class="p">(</span><span class="n">arg</span><span class="p">.</span><span class="n">data_type</span><span class="p">(),</span><span class="w"> </span><span class="n">DataType</span><span class="p">::</span><span class="n">List</span><span class="p [...]
+<span class="w"> </span><span class="p">{</span>
+<span class="w"> </span><span class="n">ArrayConcat</span><span class="p">::</span><span class="n">new</span><span class="p">().</span><span class="n">invoke_with_args</span><span class="p">(</span><span class="n">args</span><span class="p">)</span>
+<span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="k">else</span><span class="w"> </span><span class="p">{</span>
+<span class="w"> </span><span class="n">ConcatFunc</span><span class="p">::</span><span class="n">new</span><span class="p">().</span><span class="n">invoke_with_args</span><span class="p">(</span><span class="n">args</span><span class="p">)</span>
+<span class="w"> </span><span class="p">}</span>
+<span class="w"> </span><span class="p">}</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</section>
+<section id="parquetexec-avroexec-csvexec-jsonexec-deprecated">
+<h3><code class="docutils literal notranslate"><span class="pre">ParquetExec</span></code>, <code class="docutils literal notranslate"><span class="pre">AvroExec</span></code>, <code class="docutils literal notranslate"><span class="pre">CsvExec</span></code>, <code class="docutils literal notranslate"><span class="pre">JsonExec</span></code> deprecated<a class="headerlink" href="#parquetexec-avroexec-csvexec-jsonexec-deprecated" title="Link to this heading">¶</a></h3>
+<p>DataFusion 46 has a major change to how the built in DataSources are organized.
+Instead of individual <code class="docutils literal notranslate"><span class="pre">ExecutionPlan</span></code>s for the different file formats they now
+all use <code class="docutils literal notranslate"><span class="pre">DataSourceExec</span></code> and the format specific information is embodied in new
+traits <code class="docutils literal notranslate"><span class="pre">DataSource</span></code> and <code class="docutils literal notranslate"><span class="pre">FileSource</span></code>.</p>
+<p>Here is more information about</p>
+<ul class="simple">
+<li><p><a class="reference external" href="https://github.com/apache/datafusion/issues/13838">Design Ticket</a></p></li>
+<li><p>Change PR <a class="reference external" href="https://github.com/apache/datafusion/pull/14224">PR #14224</a></p></li>
+<li><p>Example of an Upgrade <a class="reference external" href="https://github.com/delta-io/delta-rs/pull/3261">PR in delta-rs</a></p></li>
+</ul>
+</section>
+<section id="cookbook-changes-to-parquetexecbuilder">
+<h3>Cookbook: Changes to <code class="docutils literal notranslate"><span class="pre">ParquetExecBuilder</span></code><a class="headerlink" href="#cookbook-changes-to-parquetexecbuilder" title="Link to this heading">¶</a></h3>
+<p>Code that looks for <code class="docutils literal notranslate"><span class="pre">ParquetExec</span></code> like this will no longer work:</p>
+<div class="highlight-rust notranslate"><div class="highlight"><pre><span></span><span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="kd">let</span><span class="w"> </span><span class="nb">Some</span><span class="p">(</span><span class="n">parquet_exec</span><span class="p">)</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">plan</span><span class="p">.</span><span class="n">as_any</span><span class="p">().</ [...]
+<span class="w"> </span><span class="c1">// Do something with ParquetExec here</span>
+<span class="w"> </span><span class="p">}</span>
+</pre></div>
+</div>
+<p>Instead, with <code class="docutils literal notranslate"><span class="pre">DataSourceExec</span></code>, the same information is now on <code class="docutils literal notranslate"><span class="pre">FileScanConfig</span></code> and
+<code class="docutils literal notranslate"><span class="pre">ParquetSource</span></code>. The equivalent code is</p>
+<div class="highlight-rust notranslate"><div class="highlight"><pre><span></span><span class="k">if</span><span class="w"> </span><span class="kd">let</span><span class="w"> </span><span class="nb">Some</span><span class="p">(</span><span class="n">datasource_exec</span><span class="p">)</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">plan</span><span class="p">.</span><span class="n">as_any</span><span class="p">().</span><span class="n">dow [...]
+<span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="kd">let</span><span class="w"> </span><span class="nb">Some</span><span class="p">(</span><span class="n">scan_config</span><span class="p">)</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">datasource_exec</span><span class="p">.</span><span class="n">data_source</span><span class="p">().</span><span class="n">as_any</span><span class="p">().</span><span cl [...]
+<span class="w"> </span><span class="c1">// FileGroups, and other information is on the FileScanConfig</span>
+<span class="w"> </span><span class="c1">// parquet</span>
+<span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="kd">let</span><span class="w"> </span><span class="nb">Some</span><span class="p">(</span><span class="n">parquet_source</span><span class="p">)</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">scan_config</span><span class="p">.</span><span class="n">file_source</span><span class="p">.</span><span class="n">as_any</span><span class="p">().</span><span cla [...]
+<span class="w"> </span><span class="p">{</span>
+<span class="w"> </span><span class="c1">// Information on PruningPredicates and parquet options are here</span>
+<span class="w"> </span><span class="p">}</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</section>
+<section id="id1">
+<h3>Cookbook: Changes to <code class="docutils literal notranslate"><span class="pre">ParquetExecBuilder</span></code><a class="headerlink" href="#id1" title="Link to this heading">¶</a></h3>
+<p>Likewise code that builds <code class="docutils literal notranslate"><span class="pre">ParquetExec</span></code> using the <code class="docutils literal notranslate"><span class="pre">ParquetExecBuilder</span></code> such as
+the following must be changed:</p>
+<div class="highlight-rust notranslate"><div class="highlight"><pre><span></span><span class="kd">let</span><span class="w"> </span><span class="k">mut</span><span class="w"> </span><span class="n">exec_plan_builder</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">ParquetExecBuilder</span><span class="p">::</span><span class="n">new</span><span class="p">(</span>
+<span class="w"> </span><span class="n">FileScanConfig</span><span class="p">::</span><span class="n">new</span><span class="p">(</span><span class="bp">self</span><span class="p">.</span><span class="n">log_store</span><span class="p">.</span><span class="n">object_store_url</span><span class="p">(),</span><span class="w"> </span><span class="n">file_schema</span><span class="p">)</span>
+<span class="w"> </span><span class="p">.</span><span class="n">with_projection</span><span class="p">(</span><span class="bp">self</span><span class="p">.</span><span class="n">projection</span><span class="p">.</span><span class="n">cloned</span><span class="p">())</span>
+<span class="w"> </span><span class="p">.</span><span class="n">with_limit</span><span class="p">(</span><span class="bp">self</span><span class="p">.</span><span class="n">limit</span><span class="p">)</span>
+<span class="w"> </span><span class="p">.</span><span class="n">with_table_partition_cols</span><span class="p">(</span><span class="n">table_partition_cols</span><span class="p">),</span>
+<span class="p">)</span>
+<span class="p">.</span><span class="n">with_schema_adapter_factory</span><span class="p">(</span><span class="n">Arc</span><span class="p">::</span><span class="n">new</span><span class="p">(</span><span class="n">DeltaSchemaAdapterFactory</span><span class="w"> </span><span class="p">{}))</span>
+<span class="p">.</span><span class="n">with_table_parquet_options</span><span class="p">(</span><span class="n">parquet_options</span><span class="p">);</span>
+
+<span class="c1">// Add filter</span>
+<span class="k">if</span><span class="w"> </span><span class="kd">let</span><span class="w"> </span><span class="nb">Some</span><span class="p">(</span><span class="n">predicate</span><span class="p">)</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">logical_filter</span><span class="w"> </span><span class="p">{</span>
+<span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="n">config</span><span class="p">.</span><span class="n">enable_parquet_pushdown</span><span class="w"> </span><span class="p">{</span>
+<span class="w"> </span><span class="n">exec_plan_builder</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">exec_plan_builder</span><span class="p">.</span><span class="n">with_predicate</span><span class="p">(</span><span class="n">predicate</span><span class="p">);</span>
+<span class="w"> </span><span class="p">}</span>
+<span class="p">};</span>
+</pre></div>
+</div>
+<p>New code should use <code class="docutils literal notranslate"><span class="pre">FileScanConfig</span></code> to build the appropriate <code class="docutils literal notranslate"><span class="pre">DataSourceExec</span></code>:</p>
+<div class="highlight-rust notranslate"><div class="highlight"><pre><span></span><span class="kd">let</span><span class="w"> </span><span class="k">mut</span><span class="w"> </span><span class="n">file_source</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">ParquetSource</span><span class="p">::</span><span class="n">new</span><span class="p">(</span><span class="n">parquet_options</span><span class="p">)</span>
+<span class="w"> </span><span class="p">.</span><span class="n">with_schema_adapter_factory</span><span class="p">(</span><span class="n">Arc</span><span class="p">::</span><span class="n">new</span><span class="p">(</span><span class="n">DeltaSchemaAdapterFactory</span><span class="w"> </span><span class="p">{}));</span>
+
+<span class="c1">// Add filter</span>
+<span class="k">if</span><span class="w"> </span><span class="kd">let</span><span class="w"> </span><span class="nb">Some</span><span class="p">(</span><span class="n">predicate</span><span class="p">)</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">logical_filter</span><span class="w"> </span><span class="p">{</span>
+<span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="n">config</span><span class="p">.</span><span class="n">enable_parquet_pushdown</span><span class="w"> </span><span class="p">{</span>
+<span class="w"> </span><span class="n">file_source</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">file_source</span><span class="p">.</span><span class="n">with_predicate</span><span class="p">(</span><span class="n">Arc</span><span class="p">::</span><span class="n">clone</span><span class="p">(</span><span class="o">&</span><span class="n">file_schema</span><span class="p">),</span><span class="w"> </span><span class="n">predic [...]
+<span class="w"> </span><span class="p">}</span>
+<span class="p">};</span>
+
+<span class="kd">let</span><span class="w"> </span><span class="n">file_scan_config</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">FileScanConfig</span><span class="p">::</span><span class="n">new</span><span class="p">(</span>
+<span class="w"> </span><span class="bp">self</span><span class="p">.</span><span class="n">log_store</span><span class="p">.</span><span class="n">object_store_url</span><span class="p">(),</span>
+<span class="w"> </span><span class="n">file_schema</span><span class="p">,</span>
+<span class="w"> </span><span class="n">Arc</span><span class="p">::</span><span class="n">new</span><span class="p">(</span><span class="n">file_source</span><span class="p">),</span>
+<span class="p">)</span>
+<span class="p">.</span><span class="n">with_statistics</span><span class="p">(</span><span class="n">stats</span><span class="p">)</span>
+<span class="p">.</span><span class="n">with_projection</span><span class="p">(</span><span class="bp">self</span><span class="p">.</span><span class="n">projection</span><span class="p">.</span><span class="n">cloned</span><span class="p">())</span>
+<span class="p">.</span><span class="n">with_limit</span><span class="p">(</span><span class="bp">self</span><span class="p">.</span><span class="n">limit</span><span class="p">)</span>
+<span class="p">.</span><span class="n">with_table_partition_cols</span><span class="p">(</span><span class="n">table_partition_cols</span><span class="p">);</span>
+
+<span class="c1">// Build the actual scan like this</span>
+<span class="n">parquet_scan</span><span class="p">:</span><span class="w"> </span><span class="nc">file_scan_config</span><span class="p">.</span><span class="n">build</span><span class="p">(),</span>
+</pre></div>
+</div>
+</section>
+<section id="datafusion-cli-no-longer-automatically-unescapes-strings">
+<h3><code class="docutils literal notranslate"><span class="pre">datafusion-cli</span></code> no longer automatically unescapes strings<a class="headerlink" href="#datafusion-cli-no-longer-automatically-unescapes-strings" title="Link to this heading">¶</a></h3>
+<p><code class="docutils literal notranslate"><span class="pre">datafusion-cli</span></code> previously would incorrectly unescape string literals (see <a class="reference external" href="https://github.com/apache/datafusion/issues/13286">ticket</a> for more details).</p>
+<p>To escape <code class="docutils literal notranslate"><span class="pre">'</span></code> in SQL literals, use <code class="docutils literal notranslate"><span class="pre">''</span></code>:</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="s1">'it''s escaped'</span><span class="p">;</span>
+<span class="o">+</span><span class="c1">----------------------+</span>
+<span class="o">|</span><span class="w"> </span><span class="n">Utf8</span><span class="p">(</span><span class="ss">"it's escaped"</span><span class="p">)</span><span class="w"> </span><span class="o">|</span>
+<span class="o">+</span><span class="c1">----------------------+</span>
+<span class="o">|</span><span class="w"> </span><span class="n">it</span><span class="err">'</span><span class="n">s</span><span class="w"> </span><span class="n">escaped</span><span class="w"> </span><span class="o">|</span>
+<span class="o">+</span><span class="c1">----------------------+</span>
+<span class="mi">1</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>
+</pre></div>
+</div>
+<p>To include special characters (such as newlines via <code class="docutils literal notranslate"><span class="pre">\n</span></code>) you can use an <code class="docutils literal notranslate"><span class="pre">E</span></code> literal string. 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="s1">'foo\nbar'</span><span class="p">;</span>
+<span class="o">+</span><span class="c1">------------------+</span>
+<span class="o">|</span><span class="w"> </span><span class="n">Utf8</span><span class="p">(</span><span class="ss">"foo\nbar"</span><span class="p">)</span><span class="w"> </span><span class="o">|</span>
+<span class="o">+</span><span class="c1">------------------+</span>
+<span class="o">|</span><span class="w"> </span><span class="n">foo</span><span class="err">\</span><span class="n">nbar</span><span class="w"> </span><span class="o">|</span>
+<span class="o">+</span><span class="c1">------------------+</span>
+<span class="mi">1</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="n">Elapsed</span><span class="w"> </span><span class="mi">0</span><span class="p">.</span><span class="mi">005</span><span class="w"> </span><span class="n">seconds</span><span class="p">.</span>
+</pre></div>
+</div>
+</section>
+</section>
+</section>
+
+
+ </div>
+
+
+ <!-- Previous / next buttons -->
+<div class='prev-next-area'>
+ <a class='left-prev' id="prev-link" href="query-optimizer.html" title="previous page">
+ <i class="fas fa-angle-left"></i>
+ <div class="prev-next-info">
+ <p class="prev-next-subtitle">previous</p>
+ <p class="prev-next-title">DataFusion Query Optimizer</p>
+ </div>
+ </a>
+ <a class='right-next' id="next-link" href="../contributor-guide/index.html" title="next page">
+ <div class="prev-next-info">
+ <p class="prev-next-subtitle">next</p>
+ <p class="prev-next-title">Introduction</p>
+ </div>
+ <i class="fas fa-angle-right"></i>
+ </a>
+</div>
+
+ </main>
+
+
+ </div>
+ </div>
+
+ <script src="../_static/scripts/pydata-sphinx-theme.js?digest=1999514e3f237ded88cf"></script>
+
+<!-- Based on pydata_sphinx_theme/footer.html -->
+<footer class="footer mt-5 mt-md-0">
+ <div class="container">
+
+ <div class="footer-item">
+ <p class="copyright">
+ © Copyright 2019-2024, Apache Software Foundation.<br>
+</p>
+ </div>
+
+ <div class="footer-item">
+ <p class="sphinx-version">
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
+</p>
+ </div>
+
+ <div class="footer-item">
+ <p>Apache DataFusion, Apache, the Apache feather logo, and the Apache DataFusion project logo</p>
+ <p>are either registered trademarks or trademarks of The Apache Software Foundation in the United States and other countries.</p>
+ </div>
+ </div>
+</footer>
+
+
+ </body>
+</html>
\ No newline at end of file
diff --git a/library-user-guide/using-the-dataframe-api.html b/library-user-guide/using-the-dataframe-api.html
index 8bfcf70a09..1c2bf82ad5 100644
--- a/library-user-guide/using-the-dataframe-api.html
+++ b/library-user-guide/using-the-dataframe-api.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="api-health.html">
- API health policy
+ <a class="reference internal" href="upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../contributor-guide/howtos.html">
HOWTOs
@@ -895,7 +900,7 @@ easily go back and forth between them.</p>
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/library-user-guide/using-the-sql-api.html b/library-user-guide/using-the-sql-api.html
index 5ea6dce63b..2d290eb71c 100644
--- a/library-user-guide/using-the-sql-api.html
+++ b/library-user-guide/using-the-sql-api.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="api-health.html">
- API health policy
+ <a class="reference internal" href="upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../contributor-guide/howtos.html">
HOWTOs
@@ -845,7 +850,7 @@ statement.</p>
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/library-user-guide/working-with-exprs.html b/library-user-guide/working-with-exprs.html
index d6a818ce35..44d12a6f2b 100644
--- a/library-user-guide/working-with-exprs.html
+++ b/library-user-guide/working-with-exprs.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="api-health.html">
- API health policy
+ <a class="reference internal" href="upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../contributor-guide/howtos.html">
HOWTOs
@@ -886,7 +891,7 @@
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/objects.inv b/objects.inv
index a37f6017b9..ea2861e6f6 100644
Binary files a/objects.inv and b/objects.inv differ
diff --git a/search.html b/search.html
index 75f278610f..7707d74958 100644
--- a/search.html
+++ b/search.html
@@ -383,8 +383,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -419,6 +419,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="contributor-guide/howtos.html">
HOWTOs
@@ -579,7 +584,7 @@
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/searchindex.js b/searchindex.js
index 5d878dc2b8..a68b356cd9 100644
--- a/searchindex.js
+++ b/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"alltitles":{"!=":[[51,"op-neq"]],"!~":[[51,"op-re-not-match"]],"!~*":[[51,"op-re-not-match-i"]],"!~~":[[51,"id19"]],"!~~*":[[51,"id20"]],"#":[[51,"op-bit-xor"]],"%":[[51,"op-modulo"]],"&":[[51,"op-bit-and"]],"(relation, name) tuples in logical fields and logical columns are unique":[[11,"relation-name-tuples-in-logical-fields-and-logical-columns-are-unique"]],"*":[[51,"op-multiply"]],"+":[[51,"op-plus"]],"-":[[51,"op-minus"]],"/":[[51,"op-divide"]],"2022 Q2":[[9,"q2"]], [...]
\ No newline at end of file
+Search.setIndex({"alltitles":{"!=":[[52,"op-neq"]],"!~":[[52,"op-re-not-match"]],"!~*":[[52,"op-re-not-match-i"]],"!~~":[[52,"id19"]],"!~~*":[[52,"id20"]],"#":[[52,"op-bit-xor"]],"%":[[52,"op-modulo"]],"&":[[52,"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"]],"*":[[52,"op-multiply"]],"+":[[52,"op-plus"]],"-":[[52,"op-minus"]],"/":[[52,"op-divide"]],"2022 Q2":[[10,"q2"]] [...]
\ No newline at end of file
diff --git a/user-guide/cli/datasources.html b/user-guide/cli/datasources.html
index f375bf8d56..7142f925b7 100644
--- a/user-guide/cli/datasources.html
+++ b/user-guide/cli/datasources.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../../contributor-guide/howtos.html">
HOWTOs
@@ -1024,7 +1029,7 @@ DataFusion<span class="w"> </span>CLI<span class="w"> </span>v21.0.0
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/user-guide/cli/index.html b/user-guide/cli/index.html
index 205543d7b1..55e0886fdc 100644
--- a/user-guide/cli/index.html
+++ b/user-guide/cli/index.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../../contributor-guide/howtos.html">
HOWTOs
@@ -629,7 +634,7 @@
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/user-guide/cli/installation.html b/user-guide/cli/installation.html
index df277074bd..ac34077123 100644
--- a/user-guide/cli/installation.html
+++ b/user-guide/cli/installation.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../../contributor-guide/howtos.html">
HOWTOs
@@ -663,7 +668,7 @@ docker<span class="w"> </span>run<span class="w"> </span>--rm<span class="w"> </
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/user-guide/cli/overview.html b/user-guide/cli/overview.html
index c7010ca0dd..9c8ccabf3f 100644
--- a/user-guide/cli/overview.html
+++ b/user-guide/cli/overview.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../../contributor-guide/howtos.html">
HOWTOs
@@ -625,7 +630,7 @@ and <a class="reference internal" href="datasources.html"><span class="doc std s
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/user-guide/cli/usage.html b/user-guide/cli/usage.html
index 64d4b1a811..fc204a3ab2 100644
--- a/user-guide/cli/usage.html
+++ b/user-guide/cli/usage.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../../contributor-guide/howtos.html">
HOWTOs
@@ -1012,7 +1017,7 @@ in the file. Please refer to the <a class="reference external" href="https://par
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/user-guide/concepts-readings-events.html b/user-guide/concepts-readings-events.html
index b2baf68654..7e51667528 100644
--- a/user-guide/concepts-readings-events.html
+++ b/user-guide/concepts-readings-events.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../contributor-guide/howtos.html">
HOWTOs
@@ -732,7 +737,7 @@
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/user-guide/configs.html b/user-guide/configs.html
index b0837c814d..5b284cfce6 100644
--- a/user-guide/configs.html
+++ b/user-guide/configs.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../contributor-guide/howtos.html">
HOWTOs
@@ -996,7 +1001,7 @@ Environment variables are read during <code class="docutils literal notranslate"
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/user-guide/crate-configuration.html b/user-guide/crate-configuration.html
index d933ba4ae4..428088cf82 100644
--- a/user-guide/crate-configuration.html
+++ b/user-guide/crate-configuration.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../contributor-guide/howtos.html">
HOWTOs
@@ -767,7 +772,7 @@ backtrace:<span class="w"> </span><span class="m">0</span>:<span class="w"> <
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/user-guide/dataframe.html b/user-guide/dataframe.html
index d2ac8318e1..af9e1c4448 100644
--- a/user-guide/dataframe.html
+++ b/user-guide/dataframe.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../contributor-guide/howtos.html">
HOWTOs
@@ -656,7 +661,7 @@ the following statement.</p>
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/user-guide/example-usage.html b/user-guide/example-usage.html
index 342e2d99bf..7a7e594961 100644
--- a/user-guide/example-usage.html
+++ b/user-guide/example-usage.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../contributor-guide/howtos.html">
HOWTOs
@@ -802,7 +807,7 @@ unexpectedly.</p>
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/user-guide/explain-usage.html b/user-guide/explain-usage.html
index 6d9d0685a1..8494b7b2a5 100644
--- a/user-guide/explain-usage.html
+++ b/user-guide/explain-usage.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../contributor-guide/howtos.html">
HOWTOs
@@ -1055,7 +1060,7 @@ Elapsed<span class="w"> </span><span class="m">0</span>.062<span class="w"> </sp
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/user-guide/expressions.html b/user-guide/expressions.html
index 2498724c71..92e0e48aa1 100644
--- a/user-guide/expressions.html
+++ b/user-guide/expressions.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../contributor-guide/howtos.html">
HOWTOs
@@ -1473,7 +1478,7 @@ but these operators always return a <code class="docutils literal notranslate"><
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/user-guide/faq.html b/user-guide/faq.html
index 5de6f8486b..db86bbd54c 100644
--- a/user-guide/faq.html
+++ b/user-guide/faq.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../contributor-guide/howtos.html">
HOWTOs
@@ -674,7 +679,7 @@ targets end-users rather than developers of other database systems.</p></li>
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/user-guide/features.html b/user-guide/features.html
index 298c3420fa..957c141dc7 100644
--- a/user-guide/features.html
+++ b/user-guide/features.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../contributor-guide/howtos.html">
HOWTOs
@@ -756,7 +761,7 @@ trait, DataFusion includes built in support for the following formats:</p>
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/user-guide/introduction.html b/user-guide/introduction.html
index 0d8469d223..c7326c119f 100644
--- a/user-guide/introduction.html
+++ b/user-guide/introduction.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../contributor-guide/howtos.html">
HOWTOs
@@ -794,7 +799,7 @@ provide integrations with other systems, some of which are described below:</p>
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/user-guide/sql/aggregate_functions.html b/user-guide/sql/aggregate_functions.html
index 8d42abc6ef..ff633dbb2e 100644
--- a/user-guide/sql/aggregate_functions.html
+++ b/user-guide/sql/aggregate_functions.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../../contributor-guide/howtos.html">
HOWTOs
@@ -2307,7 +2312,7 @@ dev/update_function_docs.sh file for updating surrounding text.
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/user-guide/sql/data_types.html b/user-guide/sql/data_types.html
index 3efdc870e4..1631ba22ff 100644
--- a/user-guide/sql/data_types.html
+++ b/user-guide/sql/data_types.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../../contributor-guide/howtos.html">
HOWTOs
@@ -935,7 +940,7 @@ For example, to cast the output of <code class="docutils literal notranslate"><s
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/user-guide/sql/ddl.html b/user-guide/sql/ddl.html
index 35449a3f03..9aca615c60 100644
--- a/user-guide/sql/ddl.html
+++ b/user-guide/sql/ddl.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../../contributor-guide/howtos.html">
HOWTOs
@@ -882,7 +887,7 @@ DROP VIEW [ IF EXISTS ] <b><i>view_name</i></b>;
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/user-guide/sql/dml.html b/user-guide/sql/dml.html
index fde63f18b2..9b919531a4 100644
--- a/user-guide/sql/dml.html
+++ b/user-guide/sql/dml.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../../contributor-guide/howtos.html">
HOWTOs
@@ -737,7 +742,7 @@ INSERT INTO <i><b>table_name</i></b> { VALUES ( <i><b>expression</i></b> [, ...]
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/user-guide/sql/explain.html b/user-guide/sql/explain.html
index 38160eb8aa..db9cfe9d01 100644
--- a/user-guide/sql/explain.html
+++ b/user-guide/sql/explain.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../../contributor-guide/howtos.html">
HOWTOs
@@ -670,7 +675,7 @@ If you need more information output, use <code class="docutils literal notransla
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/user-guide/sql/index.html b/user-guide/sql/index.html
index fed0ceafeb..13d6505e71 100644
--- a/user-guide/sql/index.html
+++ b/user-guide/sql/index.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../../contributor-guide/howtos.html">
HOWTOs
@@ -702,7 +707,7 @@
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/user-guide/sql/information_schema.html b/user-guide/sql/information_schema.html
index ef89cf5708..b1b0d3881b 100644
--- a/user-guide/sql/information_schema.html
+++ b/user-guide/sql/information_schema.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../../contributor-guide/howtos.html">
HOWTOs
@@ -752,7 +757,7 @@ the <code class="docutils literal notranslate"><span class="pre">information_sch
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/user-guide/sql/operators.html b/user-guide/sql/operators.html
index 6c0d296adf..66cf6abf70 100644
--- a/user-guide/sql/operators.html
+++ b/user-guide/sql/operators.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../../contributor-guide/howtos.html">
HOWTOs
@@ -1473,7 +1478,7 @@ bar
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/user-guide/sql/prepared_statements.html b/user-guide/sql/prepared_statements.html
index f174a8005f..216fe8fe3a 100644
--- a/user-guide/sql/prepared_statements.html
+++ b/user-guide/sql/prepared_statements.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../../contributor-guide/howtos.html">
HOWTOs
@@ -700,7 +705,7 @@
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/user-guide/sql/scalar_functions.html b/user-guide/sql/scalar_functions.html
index ea9510fe6a..75a1efdfbe 100644
--- a/user-guide/sql/scalar_functions.html
+++ b/user-guide/sql/scalar_functions.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../../contributor-guide/howtos.html">
HOWTOs
@@ -9290,7 +9295,7 @@ syntax such as <code class="docutils literal notranslate"><span class="pre">my_s
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/user-guide/sql/select.html b/user-guide/sql/select.html
index 6f561e9e8d..0a5909fcd7 100644
--- a/user-guide/sql/select.html
+++ b/user-guide/sql/select.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../../contributor-guide/howtos.html">
HOWTOs
@@ -912,7 +917,7 @@ This order can be changed to descending by adding <code class="docutils literal
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/user-guide/sql/special_functions.html b/user-guide/sql/special_functions.html
index 203fdf9011..ce02026b7d 100644
--- a/user-guide/sql/special_functions.html
+++ b/user-guide/sql/special_functions.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../../contributor-guide/howtos.html">
HOWTOs
@@ -747,7 +752,7 @@ Can be a constant, column, or function, and any combination of object operators.
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/user-guide/sql/subqueries.html b/user-guide/sql/subqueries.html
index e08d66523f..5de80e3995 100644
--- a/user-guide/sql/subqueries.html
+++ b/user-guide/sql/subqueries.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../../contributor-guide/howtos.html">
HOWTOs
@@ -1135,7 +1140,7 @@ returns 0 rows.</p>
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/user-guide/sql/window_functions.html b/user-guide/sql/window_functions.html
index 99bbccd3ba..24a692e696 100644
--- a/user-guide/sql/window_functions.html
+++ b/user-guide/sql/window_functions.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../../contributor-guide/howtos.html">
HOWTOs
@@ -1026,7 +1031,7 @@ Instead, the rows retain their separate identities. Behind the scenes, the windo
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
diff --git a/user-guide/sql/write_options.html b/user-guide/sql/write_options.html
index fd526cea38..fdd48dd639 100644
--- a/user-guide/sql/write_options.html
+++ b/user-guide/sql/write_options.html
@@ -379,8 +379,8 @@
</a>
</li>
<li class="toctree-l1">
- <a class="reference internal" href="../../library-user-guide/api-health.html">
- API health policy
+ <a class="reference internal" href="../../library-user-guide/upgrading.html">
+ Upgrade Guides
</a>
</li>
</ul>
@@ -415,6 +415,11 @@
Testing
</a>
</li>
+ <li class="toctree-l1">
+ <a class="reference internal" href="../../contributor-guide/api-health.html">
+ API health policy
+ </a>
+ </li>
<li class="toctree-l1">
<a class="reference internal" href="../../contributor-guide/howtos.html">
HOWTOs
@@ -847,7 +852,7 @@
<div class="footer-item">
<p class="sphinx-version">
-Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.1.<br>
+Created using <a href="http://sphinx-doc.org/">Sphinx</a> 8.2.3.<br>
</p>
</div>
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@datafusion.apache.org
For additional commands, e-mail: commits-help@datafusion.apache.org