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/arrow-adbc.git
The following commit(s) were added to refs/heads/asf-site by this push:
new f7ed7644 publish documentation
f7ed7644 is described below
commit f7ed7644480c8d5ac8715e78140ce052f82c88d5
Author: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
AuthorDate: Wed Jul 12 18:08:35 2023 +0000
publish documentation
---
main/_sources/faq.rst.txt | 13 +++++++++++++
main/faq.html | 10 ++++++++++
main/searchindex.js | 2 +-
3 files changed, 24 insertions(+), 1 deletion(-)
diff --git a/main/_sources/faq.rst.txt b/main/_sources/faq.rst.txt
index 3f07a8f4..937cf0f8 100644
--- a/main/_sources/faq.rst.txt
+++ b/main/_sources/faq.rst.txt
@@ -145,3 +145,16 @@ JDBC driver in a bespoke Arrow-based API.
.. _arrow-jdbc:
https://central.sonatype.com/artifact/org.apache.arrow/arrow-jdbc/11.0.0
.. _Turbodbc: https://turbodbc.readthedocs.io/en/latest/
+
+What is the ADBC SQL dialect?
+=============================
+
+Trick question! ADBC is not a SQL dialect. All an ADBC driver is
+required to do, is pass your query string to the database and get the
+result set as Arrow data. In that respect, it's like JDBC. (ODBC has
+a "standard" SQL dialect it defines; ADBC does not do this.)
+
+For a project that does try to tackle the problem of defining a
+vendor-independent query language, see Substrait_.
+
+.. _Substrait: https://substrait.io/
diff --git a/main/faq.html b/main/faq.html
index c4be6e83..dd41b11f 100644
--- a/main/faq.html
+++ b/main/faq.html
@@ -428,6 +428,15 @@ conversions yourself.</p>
ODBC driver in Python’s DBAPI (PEP 249), and <a class="reference external"
href="https://central.sonatype.com/artifact/org.apache.arrow/arrow-jdbc/11.0.0">arrow-jdbc</a>
wraps any
JDBC driver in a bespoke Arrow-based API.</p>
</section>
+<section id="what-is-the-adbc-sql-dialect">
+<h2>What is the ADBC SQL dialect?<a class="headerlink"
href="#what-is-the-adbc-sql-dialect" title="Permalink to this
heading">#</a></h2>
+<p>Trick question! ADBC is not a SQL dialect. All an ADBC driver is
+required to do, is pass your query string to the database and get the
+result set as Arrow data. In that respect, it’s like JDBC. (ODBC has
+a “standard” SQL dialect it defines; ADBC does not do this.)</p>
+<p>For a project that does try to tackle the problem of defining a
+vendor-independent query language, see <a class="reference external"
href="https://substrait.io/">Substrait</a>.</p>
+</section>
</section>
</article>
@@ -493,6 +502,7 @@ JDBC driver in a bespoke Arrow-based API.</p>
<li><a class="reference internal"
href="#then-do-we-even-need-arrow-flight-sql">Then do we even need Arrow Flight
SQL?</a></li>
<li><a class="reference internal"
href="#so-what-is-the-adbc-flight-sql-driver-then">So what is the “ADBC Flight
SQL driver” then?</a></li>
<li><a class="reference internal"
href="#and-then-what-is-the-adbc-jdbc-driver">And then what is the “ADBC JDBC
driver”?</a></li>
+<li><a class="reference internal" href="#what-is-the-adbc-sql-dialect">What is
the ADBC SQL dialect?</a></li>
</ul>
</li>
</ul>
diff --git a/main/searchindex.js b/main/searchindex.js
index 133fb07e..e66d70ed 100644
--- a/main/searchindex.js
+++ b/main/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"docnames": ["cpp/api/adbc", "cpp/api/adbc_driver_manager",
"cpp/api/index", "cpp/concurrency", "cpp/driver_manager", "cpp/index",
"cpp/quickstart", "development/contributing", "development/nightly",
"development/releasing", "driver/flight_sql", "driver/installation",
"driver/jdbc", "driver/postgresql", "driver/snowflake", "driver/sqlite",
"driver/status", "faq", "format/comparison", "format/specification",
"format/versioning", "index", "java/index", "python/api/adbc_dri [...]
\ No newline at end of file
+Search.setIndex({"docnames": ["cpp/api/adbc", "cpp/api/adbc_driver_manager",
"cpp/api/index", "cpp/concurrency", "cpp/driver_manager", "cpp/index",
"cpp/quickstart", "development/contributing", "development/nightly",
"development/releasing", "driver/flight_sql", "driver/installation",
"driver/jdbc", "driver/postgresql", "driver/snowflake", "driver/sqlite",
"driver/status", "faq", "format/comparison", "format/specification",
"format/versioning", "index", "java/index", "python/api/adbc_dri [...]
\ No newline at end of file