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-ballista.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 39a3d9a33 Publish built docs triggered by
2b514813db9fe8eb780aa043d72b65d5a1963571
39a3d9a33 is described below
commit 39a3d9a33b80366a6261fea0f14df0603e8ce832
Author: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
AuthorDate: Wed Jan 21 19:15:56 2026 +0000
Publish built docs triggered by 2b514813db9fe8eb780aa043d72b65d5a1963571
---
_sources/contributors-guide/development.md.txt | 2 +-
_sources/index.rst.txt | 1 -
_sources/user-guide/extensions-example.md.txt | 47 +++++++++++++++++++++++++
contributors-guide/development.html | 2 +-
searchindex.js | 2 +-
user-guide/extensions-example.html | 48 +++++++++++++++++++++++++-
6 files changed, 97 insertions(+), 5 deletions(-)
diff --git a/_sources/contributors-guide/development.md.txt
b/_sources/contributors-guide/development.md.txt
index feefc8a68..27b358509 100644
--- a/_sources/contributors-guide/development.md.txt
+++ b/_sources/contributors-guide/development.md.txt
@@ -68,7 +68,7 @@ cargo run --example standalone_sql
--features=ballista/standalone
## Benchmarking
-For performance testing and benchmarking with TPC-H and other datasets, see
the [benchmarks README](../../../benchmarks/README.md).
+For performance testing and benchmarking with TPC-H and other datasets, see
the [benchmarks
README](https://github.com/apache/datafusion-ballista/blob/main/benchmarks/README.md).
This includes instructions for:
diff --git a/_sources/index.rst.txt b/_sources/index.rst.txt
index d4c607500..625496198 100644
--- a/_sources/index.rst.txt
+++ b/_sources/index.rst.txt
@@ -44,7 +44,6 @@ Table of content
Python <user-guide/python>
Rust <user-guide/rust>
- Flight SQL JDBC <user-guide/flightsql>
SQL CLI <user-guide/cli>
.. toctree::
diff --git a/_sources/user-guide/extensions-example.md.txt
b/_sources/user-guide/extensions-example.md.txt
index b7c94d9ed..4d41da323 100644
--- a/_sources/user-guide/extensions-example.md.txt
+++ b/_sources/user-guide/extensions-example.md.txt
@@ -214,16 +214,63 @@ scheduler.
The logical extension codec typically consists of two components: Google
Protocol Buffer definitions:
```proto
+syntax = "proto3";
+
+package extension.ballista;
+
+// used in building the codecs and compiled to Rust at build time.
+import "datafusion_common.proto";
+//
+// message naming convention
+//
+// prefix L means logical
+// prefix P means physical
+//
+
+
+//
+// Logical Plan Extensions
+//
+
+
+// this is the root message that captures all possible
+// logical plan messages which can be sent across
message LMessage {
oneof Extension {
LSample sample = 1;
}
}
+
message LSample {
float fraction = 1;
optional int64 seed = 2;
}
+
+//
+// Physical Plan Extensions
+//
+
+
+message PMessage {
+ oneof Extension {
+ // opaque message means that extension codec does not handle
+ // those values hence encoding/decoding is delegated to some other
codec
+ // (in this case default datafusion codec).
+ bytes opaque = 1;
+ PSample sample = 2;
+
+ }
+}
+
+message PSample {
+ float fraction = 1;
+ optional int64 seed = 2;
+}
+```
+
+```
+
```
`LogicalExtensionCodec` extends `BallistaLogicalExtensionCodec` handling newly
defined operator messages:
diff --git a/contributors-guide/development.html
b/contributors-guide/development.html
index e7e33d69d..f7339daab 100644
--- a/contributors-guide/development.html
+++ b/contributors-guide/development.html
@@ -378,7 +378,7 @@ cargo<span class="w"> </span>run<span class="w">
</span>--example<span class="w"
</section>
<section id="benchmarking">
<h2>Benchmarking<a class="headerlink" href="#benchmarking" title="Link to this
heading">ΒΆ</a></h2>
-<p>For performance testing and benchmarking with TPC-H and other datasets, see
the <span class="xref myst">benchmarks README</span>.</p>
+<p>For performance testing and benchmarking with TPC-H and other datasets, see
the <a class="reference external"
href="https://github.com/apache/datafusion-ballista/blob/main/benchmarks/README.md";>benchmarks
README</a>.</p>
<p>This includes instructions for:</p>
<ul class="simple">
<li><p>Generating TPC-H test data</p></li>
diff --git a/searchindex.js b/searchindex.js
index 99c3de495..b8142b363 100644
--- a/searchindex.js
+++ b/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"alltitles": {"Apache DataFusion Ballista": [[4, null]],
"Arrow-native": [[1, "arrow-native"]], "Autoscaling Executors": [[11,
"autoscaling-executors"]], "Ballista Architecture": [[1, null]], "Ballista Code
Organization": [[2, null]], "Ballista Command-line Interface": [[5, null]],
"Ballista Configuration Settings": [[6, "ballista-configuration-settings"]],
"Ballista Development": [[3, null]], "Ballista Python Bindings": [[18, null]],
"Ballista Quickstart": [[12, null]], [...]
\ No newline at end of file
+Search.setIndex({"alltitles": {"Apache DataFusion Ballista": [[4, null]],
"Arrow-native": [[1, "arrow-native"]], "Autoscaling Executors": [[11,
"autoscaling-executors"]], "Ballista Architecture": [[1, null]], "Ballista Code
Organization": [[2, null]], "Ballista Command-line Interface": [[5, null]],
"Ballista Configuration Settings": [[6, "ballista-configuration-settings"]],
"Ballista Development": [[3, null]], "Ballista Python Bindings": [[18, null]],
"Ballista Quickstart": [[12, null]], [...]
\ No newline at end of file
diff --git a/user-guide/extensions-example.html
b/user-guide/extensions-example.html
index 8f0547ea6..0a39a688a 100644
--- a/user-guide/extensions-example.html
+++ b/user-guide/extensions-example.html
@@ -516,16 +516,62 @@ Please do not use implemented sampling operator for
production, statisticians wo
<p>With the extension in place, a custom logical extension codec is required
to transmit the client logical plan to the
scheduler.</p>
<p>The logical extension codec typically consists of two components: Google
Protocol Buffer definitions:</p>
-<div class="highlight-proto notranslate"><div
class="highlight"><pre><span></span><span class="kd">message</span><span
class="w"> </span><span class="nc">LMessage</span><span class="w"> </span><span
class="p">{</span>
+<div class="highlight-proto notranslate"><div
class="highlight"><pre><span></span><span class="k">syntax</span><span
class="w"> </span><span class="o">=</span><span class="w"> </span><span
class="s">"proto3"</span><span class="p">;</span>
+
+<span class="kn">package</span><span class="w"> </span><span
class="nn">extension</span><span class="o">.</span><span
class="n">ballista</span><span class="p">;</span>
+
+<span class="c1">// used in building the codecs and compiled to Rust at build
time.</span>
+<span class="k">import</span><span class="w"> </span><span
class="s">"datafusion_common.proto"</span><span class="p">;</span>
+<span class="c1">//</span>
+<span class="c1">// message naming convention</span>
+<span class="c1">//</span>
+<span class="c1">// prefix L means logical</span>
+<span class="c1">// prefix P means physical</span>
+<span class="c1">//</span>
+
+
+<span class="c1">//</span>
+<span class="c1">// Logical Plan Extensions</span>
+<span class="c1">//</span>
+
+
+<span class="c1">// this is the root message that captures all possible</span>
+<span class="c1">// logical plan messages which can be sent across</span>
+<span class="kd">message</span><span class="w"> </span><span
class="nc">LMessage</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="k">oneof</span><span class="w">
</span><span class="n">Extension</span><span class="w"> </span><span
class="p">{</span>
<span class="w"> </span><span class="n">LSample</span><span class="w">
</span><span class="na">sample</span><span class="w"> </span><span
class="o">=</span><span class="w"> </span><span class="mi">1</span><span
class="p">;</span>
<span class="w"> </span><span class="p">}</span>
<span class="p">}</span>
+
<span class="kd">message</span><span class="w"> </span><span
class="nc">LSample</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="kt">float</span><span class="w">
</span><span class="na">fraction</span><span class="w"> </span><span
class="o">=</span><span class="w"> </span><span class="mi">1</span><span
class="p">;</span>
<span class="w"> </span><span class="k">optional</span><span class="w">
</span><span class="kt">int64</span><span class="w"> </span><span
class="na">seed</span><span class="w"> </span><span class="o">=</span><span
class="w"> </span><span class="mi">2</span><span class="p">;</span>
<span class="p">}</span>
+
+<span class="c1">//</span>
+<span class="c1">// Physical Plan Extensions</span>
+<span class="c1">//</span>
+
+
+<span class="kd">message</span><span class="w"> </span><span
class="nc">PMessage</span><span class="w"> </span><span class="p">{</span>
+<span class="w"> </span><span class="k">oneof</span><span class="w">
</span><span class="n">Extension</span><span class="w"> </span><span
class="p">{</span>
+<span class="w"> </span><span class="c1">// opaque message means that
extension codec does not handle</span>
+<span class="w"> </span><span class="c1">// those values hence
encoding/decoding is delegated to some other codec</span>
+<span class="w"> </span><span class="c1">// (in this case default
datafusion codec).</span>
+<span class="w"> </span><span class="kt">bytes</span><span class="w">
</span><span class="na">opaque</span><span class="w"> </span><span
class="o">=</span><span class="w"> </span><span class="mi">1</span><span
class="p">;</span>
+<span class="w"> </span><span class="n">PSample</span><span class="w">
</span><span class="na">sample</span><span class="w"> </span><span
class="o">=</span><span class="w"> </span><span class="mi">2</span><span
class="p">;</span>
+
+<span class="w"> </span><span class="p">}</span>
+<span class="p">}</span>
+
+<span class="kd">message</span><span class="w"> </span><span
class="nc">PSample</span><span class="w"> </span><span class="p">{</span>
+<span class="w"> </span><span class="kt">float</span><span class="w">
</span><span class="na">fraction</span><span class="w"> </span><span
class="o">=</span><span class="w"> </span><span class="mi">1</span><span
class="p">;</span>
+<span class="w"> </span><span class="k">optional</span><span class="w">
</span><span class="kt">int64</span><span class="w"> </span><span
class="na">seed</span><span class="w"> </span><span class="o">=</span><span
class="w"> </span><span class="mi">2</span><span class="p">;</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<div class="highlight-default notranslate"><div
class="highlight"><pre><span></span>
</pre></div>
</div>
<p><code class="docutils literal notranslate"><span
class="pre">LogicalExtensionCodec</span></code> extends <code class="docutils
literal notranslate"><span
class="pre">BallistaLogicalExtensionCodec</span></code> handling newly defined
operator messages:</p>
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
