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

Reply via email to