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 9f2386370 publish documentation 9f2386370 is described below commit 9f23863700d06ea44e64215e37d4400cb2260ad5 Author: github-actions[bot] <github-actions[bot]@users.noreply.github.com> AuthorDate: Thu May 1 01:31:21 2025 +0000 publish documentation --- main/_sources/faq.rst.txt | 13 +++++-------- main/driver/flight_sql.html | 2 +- main/driver/postgresql.html | 2 +- main/faq.html | 22 +++++++++------------- main/format/related_work.html | 6 +++--- main/format/specification.html | 2 +- main/glossary.html | 2 +- main/python/api/adbc_driver_manager.html | 18 +++++++++--------- main/python/recipe/postgresql.html | 6 +++--- main/r/adbcbigquery/pkgdown.yml | 2 +- main/r/adbcdrivermanager/pkgdown.yml | 2 +- .../reference/adbc_connection_init.html | 4 ++-- .../reference/adbc_database_init.html | 2 +- .../reference/adbc_statement_init.html | 6 +++--- main/r/adbcdrivermanager/search.json | 2 +- main/r/adbcflightsql/pkgdown.yml | 2 +- main/r/adbcpostgresql/pkgdown.yml | 2 +- main/r/adbcsnowflake/pkgdown.yml | 2 +- main/r/adbcsqlite/pkgdown.yml | 2 +- main/searchindex.js | 2 +- 20 files changed, 47 insertions(+), 54 deletions(-) diff --git a/main/_sources/faq.rst.txt b/main/_sources/faq.rst.txt index 9d64c0e8c..9d1df362d 100644 --- a/main/_sources/faq.rst.txt +++ b/main/_sources/faq.rst.txt @@ -22,16 +22,13 @@ Frequently Asked Questions (FAQ) What exactly is ADBC? ===================== -ADBC is: +At a high level, ADBC is the standard for Arrow-native access to databases. At a +lower level, ADBC is two separate but related things: -- A set of abstract APIs in different languages (C/C++, Go, and Java, - with more on the way) for working with databases and Arrow data. +1. An abstract API for working with databases and Arrow data. - For example, result sets of queries in ADBC are all returned as - streams of Arrow data, not row-by-row. -- A set of implementations of that API in different languages (C/C++, - C#/.NET, Go, Java, Python, and Ruby) that target different databases - (e.g. PostgreSQL, SQLite, any database supporting Flight SQL). +2. A set of concrete implementations of that abstract API in different languages + and drivers for different databases (see :doc:`driver/status`). Why not just use JDBC/ODBC? =========================== diff --git a/main/driver/flight_sql.html b/main/driver/flight_sql.html index 804cea507..eb21c59ec 100644 --- a/main/driver/flight_sql.html +++ b/main/driver/flight_sql.html @@ -389,7 +389,7 @@ <h1>Flight SQL Driver<a class="headerlink" href="#flight-sql-driver" title="Link to this heading">¶</a></h1> <p><strong>Available for:</strong> C/C++, GLib/Ruby, Go, Java, Python, R</p> <p>The Flight SQL Driver provides access to any database implementing a -<a class="reference external" href="https://arrow.apache.org/docs/format/FlightSql.html" title="(in Apache Arrow v19.0.1)"><span>Arrow Flight SQL</span></a> compatible endpoint.</p> +<a class="reference external" href="https://arrow.apache.org/docs/format/FlightSql.html" title="(in Apache Arrow v20.0.0)"><span>Arrow Flight SQL</span></a> compatible endpoint.</p> <section id="installation"> <h2>Installation<a class="headerlink" href="#installation" title="Link to this heading">¶</a></h2> <div class="sd-tab-set docutils"> diff --git a/main/driver/postgresql.html b/main/driver/postgresql.html index 6d50797f5..630505b73 100644 --- a/main/driver/postgresql.html +++ b/main/driver/postgresql.html @@ -731,7 +731,7 @@ the case.</p> <p>Types without direct Arrow equivalents can still be returned by the driver. In this case, the Arrow type will be binary, and the contents will be the raw bytes as provided by the PostgreSQL wire protocol.</p> -<p>For Arrow implementations that support the <a class="reference external" href="https://arrow.apache.org/docs/format/CanonicalExtensions.html" title="(in Apache Arrow v19.0.1)"><span class="xref std std-doc">Opaque canonical +<p>For Arrow implementations that support the <a class="reference external" href="https://arrow.apache.org/docs/format/CanonicalExtensions.html" title="(in Apache Arrow v20.0.0)"><span class="xref std std-doc">Opaque canonical extension type</span></a>, the extension type metadata is also always present. This helps differentiate when the driver intentionally returned a binary column from when it returned a binary column as a fallback.</p> diff --git a/main/faq.html b/main/faq.html index abf8a65b5..4759e4e26 100644 --- a/main/faq.html +++ b/main/faq.html @@ -9,10 +9,10 @@ <meta property="og:type" content="website" /> <meta property="og:url" content="https://arrow.apache.org/adbc/main/faq.html" /> <meta property="og:site_name" content="ADBC" /> -<meta property="og:description" content="What exactly is ADBC?: ADBC is: A set of abstract APIs in different languages (C/C++, Go, and Java, with more on the way) for working with databases and Arrow data. For example, result sets of quer..." /> +<meta property="og:description" content="What exactly is ADBC?: At a high level, ADBC is the standard for Arrow-native access to databases. At a lower level, ADBC is two separate but related things: An abstract API for working with databa..." /> <meta property="og:image" content="https://arrow.apache.org/adbc/main/_static/banner.png" /> <meta property="og:image:alt" content="ADBC" /> -<meta name="description" content="What exactly is ADBC?: ADBC is: A set of abstract APIs in different languages (C/C++, Go, and Java, with more on the way) for working with databases and Arrow data. For example, result sets of quer..." /> +<meta name="description" content="What exactly is ADBC?: At a high level, ADBC is the standard for Arrow-native access to databases. At a lower level, ADBC is two separate but related things: An abstract API for working with databa..." /> <link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Glossary" href="glossary.html" /><link rel="prev" title="Apache Arrow ADBC" href="index.html" /> <!-- Generated with Sphinx 8.2.3 and Furo 2024.08.06 --> @@ -389,17 +389,13 @@ <h1>Frequently Asked Questions (FAQ)<a class="headerlink" href="#frequently-asked-questions-faq" title="Link to this heading">¶</a></h1> <section id="what-exactly-is-adbc"> <h2>What exactly is ADBC?<a class="headerlink" href="#what-exactly-is-adbc" title="Link to this heading">¶</a></h2> -<p>ADBC is:</p> -<ul> -<li><p>A set of abstract APIs in different languages (C/C++, Go, and Java, -with more on the way) for working with databases and Arrow data.</p> -<p>For example, result sets of queries in ADBC are all returned as -streams of Arrow data, not row-by-row.</p> -</li> -<li><p>A set of implementations of that API in different languages (C/C++, -C#/.NET, Go, Java, Python, and Ruby) that target different databases -(e.g. PostgreSQL, SQLite, any database supporting Flight SQL).</p></li> -</ul> +<p>At a high level, ADBC is the standard for Arrow-native access to databases. At a +lower level, ADBC is two separate but related things:</p> +<ol class="arabic simple"> +<li><p>An abstract API for working with databases and Arrow data.</p></li> +<li><p>A set of concrete implementations of that abstract API in different languages +and drivers for different databases (see <a class="reference internal" href="driver/status.html"><span class="doc">Driver Implementation Status</span></a>).</p></li> +</ol> </section> <section id="why-not-just-use-jdbc-odbc"> <h2>Why not just use JDBC/ODBC?<a class="headerlink" href="#why-not-just-use-jdbc-odbc" title="Link to this heading">¶</a></h2> diff --git a/main/format/related_work.html b/main/format/related_work.html index ae4acefca..80a2c5f0a 100644 --- a/main/format/related_work.html +++ b/main/format/related_work.html @@ -393,7 +393,7 @@ descriptions are only kept up-to-date on a best-effort basis.</p> <section id="preexisting-database-client-apis"> <h2>Preexisting database client APIs<a class="headerlink" href="#preexisting-database-client-apis" title="Link to this heading">¶</a></h2> <dl class="simple"> -<dt><a class="reference external" href="https://arrow.apache.org/docs/format/FlightSql.html" title="(in Apache Arrow v19.0.1)"><span class="xref std std-doc">Arrow Flight SQL</span></a></dt><dd><p>A standard building on top of Arrow Flight, defining how to use +<dt><a class="reference external" href="https://arrow.apache.org/docs/format/FlightSql.html" title="(in Apache Arrow v20.0.0)"><span class="xref std std-doc">Arrow Flight SQL</span></a></dt><dd><p>A standard building on top of Arrow Flight, defining how to use Flight to talk to databases, retrieve metadata, execute queries, and so on. Provides a single client in C++ and Java language that talks to any database servers implementing the protocol. Models its API @@ -426,11 +426,11 @@ implement.</p> <p>These are libraries which either 1) implement columnar data access for a particular system; or 2) could be used to implement such access.</p> <dl class="simple"> -<dt><a class="reference external" href="https://arrow.apache.org/docs/format/Flight.html" title="(in Apache Arrow v19.0.1)"><span class="xref std std-doc">Arrow Flight</span></a></dt><dd><p>An RPC framework optimized for transferring Arrow record batches, +<dt><a class="reference external" href="https://arrow.apache.org/docs/format/Flight.html" title="(in Apache Arrow v20.0.0)"><span class="xref std std-doc">Arrow Flight</span></a></dt><dd><p>An RPC framework optimized for transferring Arrow record batches, with application-specific extension points but without any higher level semantics.</p> </dd> -<dt><a class="reference external" href="https://arrow.apache.org/docs/java/jdbc.html" title="(in Apache Arrow v19.0.1)"><span class="xref std std-doc">Arrow JDBC</span></a></dt><dd><p>A Java submodule, part of Arrow/Java, that uses the JDBC API to +<dt><a class="reference external" href="https://arrow.apache.org/docs/java/jdbc.html" title="(in Apache Arrow v20.0.0)"><span class="xref std std-doc">Arrow JDBC</span></a></dt><dd><p>A Java submodule, part of Arrow/Java, that uses the JDBC API to produce Arrow data. Internally, it can read data only row-at-a-time.</p> </dd> <dt><a class="reference external" href="https://github.com/pacman82/arrow-odbc">arrow-odbc</a></dt><dd><p>A Rust community project that uses the ODBC API to produce Arrow diff --git a/main/format/specification.html b/main/format/specification.html index 177792d6e..3e824ad09 100644 --- a/main/format/specification.html +++ b/main/format/specification.html @@ -546,7 +546,7 @@ RecordBatchReader.</span><a class="headerlink" href="#id2" title="Link to this i <img alt="../_images/AdbcStatementPartitioned.mmd.svg" src="../_images/AdbcStatementPartitioned.mmd.svg" /> <figcaption> <p><span class="caption-text">This is similar to fetching data in Arrow Flight RPC (by design). See -<a class="reference external" href="https://arrow.apache.org/docs/format/Flight.html" title="(in Apache Arrow v19.0.1)"><span class="xref std std-doc">“Downloading Data”</span></a>.</span><a class="headerlink" href="#id5" title="Link to this image">¶</a></p> +<a class="reference external" href="https://arrow.apache.org/docs/format/Flight.html" title="(in Apache Arrow v20.0.0)"><span class="xref std std-doc">“Downloading Data”</span></a>.</span><a class="headerlink" href="#id5" title="Link to this image">¶</a></p> </figcaption> </figure> </section> diff --git a/main/glossary.html b/main/glossary.html index 93d53db28..36cc133ad 100644 --- a/main/glossary.html +++ b/main/glossary.html @@ -389,7 +389,7 @@ <h1>Glossary<a class="headerlink" href="#glossary" title="Link to this heading">¶</a></h1> <dl class="glossary"> <dt id="term-Arrow-Flight-SQL">Arrow Flight SQL<a class="headerlink" href="#term-Arrow-Flight-SQL" title="Link to this term">¶</a></dt><dd><p>A <a class="reference internal" href="#term-wire-protocol"><span class="xref std std-term">wire protocol</span></a> for data systems that uses Apache Arrow. -See the <a class="reference external" href="https://arrow.apache.org/docs/format/FlightSql.html" title="(in Apache Arrow v19.0.1)"><span class="xref std std-doc">specification</span></a>.</p> +See the <a class="reference external" href="https://arrow.apache.org/docs/format/FlightSql.html" title="(in Apache Arrow v20.0.0)"><span class="xref std std-doc">specification</span></a>.</p> </dd> <dt id="term-client-API">client API<a class="headerlink" href="#term-client-API" title="Link to this term">¶</a></dt><dd><p>The API that an application uses to interact with a database. May abstract over the underlying <a class="reference internal" href="#term-wire-protocol"><span class="xref std std-term">wire protocol</span></a> and other details. diff --git a/main/python/api/adbc_driver_manager.html b/main/python/api/adbc_driver_manager.html index 5a176d5bc..63697910b 100644 --- a/main/python/api/adbc_driver_manager.html +++ b/main/python/api/adbc_driver_manager.html @@ -1533,7 +1533,7 @@ cannot be disabled.</p> <dl class="py method"> <dt class="sig sig-object py" id="adbc_driver_manager.dbapi.Connection.adbc_get_objects"> -<span class="sig-name descname"><span class="pre">adbc_get_objects</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="keyword-only-separator o"><abbr title="Keyword-only parameters separator (PEP 3102)"><span class="pre">*</span></abbr></span></em>, <em class="sig-param"><span class="n"><span class="pre">depth</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Literal</span><span class="p">< [...] +<span class="sig-name descname"><span class="pre">adbc_get_objects</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="keyword-only-separator o"><abbr title="Keyword-only parameters separator (PEP 3102)"><span class="pre">*</span></abbr></span></em>, <em class="sig-param"><span class="n"><span class="pre">depth</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Literal</span><span class="p">< [...] <dd><p>List catalogs, schemas, tables, etc. in the database.</p> <dl class="field-list simple"> <dt class="field-odd">Parameters<span class="colon">:</span></dt> @@ -1559,7 +1559,7 @@ cannot be disabled.</p> <dl class="py method"> <dt class="sig sig-object py" id="adbc_driver_manager.dbapi.Connection.adbc_get_table_schema"> -<span class="sig-name descname"><span class="pre">adbc_get_table_schema</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">table_name</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="keyword-only-separator o"><abbr title="Keyword-only parameters separator (PEP 3102)"><span class="pre">*</span></abbr></span></em [...] +<span class="sig-name descname"><span class="pre">adbc_get_table_schema</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">table_name</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="keyword-only-separator o"><abbr title="Keyword-only parameters separator (PEP 3102)"><span class="pre">*</span></abbr></span></em [...] <dd><p>Get the Arrow schema of a table by name.</p> <dl class="field-list simple"> <dt class="field-odd">Parameters<span class="colon">:</span></dt> @@ -1737,7 +1737,7 @@ connections.</p> <dl class="py method"> <dt class="sig sig-object py" id="adbc_driver_manager.dbapi.Cursor.adbc_execute_partitions"> -<span class="sig-name descname"><span class="pre">adbc_execute_partitions</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">operation</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">parameters</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">& [...] +<span class="sig-name descname"><span class="pre">adbc_execute_partitions</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">operation</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">parameters</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">& [...] <dd><p>Execute a query and get the partitions of a distributed result set.</p> <dl class="field-list simple"> <dt class="field-odd">Returns<span class="colon">:</span></dt> @@ -1757,7 +1757,7 @@ execution is enabled and the server has not returned a schema.</p> <dl class="py method"> <dt class="sig sig-object py" id="adbc_driver_manager.dbapi.Cursor.adbc_execute_schema"> -<span class="sig-name descname"><span class="pre">adbc_execute_schema</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">operation</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">parameters</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">! [...] +<span class="sig-name descname"><span class="pre">adbc_execute_schema</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">operation</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">parameters</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">! [...] <dd><p>Get the schema of the result set of a query without executing it.</p> <dl class="field-list simple"> <dt class="field-odd">Returns<span class="colon">:</span></dt> @@ -1773,7 +1773,7 @@ execution is enabled and the server has not returned a schema.</p> <dl class="py method"> <dt class="sig sig-object py" id="adbc_driver_manager.dbapi.Cursor.adbc_ingest"> -<span class="sig-name descname"><span class="pre">adbc_ingest</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">table_name</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">data</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="r [...] +<span class="sig-name descname"><span class="pre">adbc_ingest</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">table_name</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">data</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="r [...] <dd><p>Ingest Arrow data into a database table.</p> <p>Depending on the driver, this can avoid per-row overhead that would result from a typical prepare-bind-insert loop.</p> @@ -1822,7 +1822,7 @@ provide this information.</p> <dl class="py method"> <dt class="sig sig-object py" id="adbc_driver_manager.dbapi.Cursor.adbc_prepare"> -<span class="sig-name descname"><span class="pre">adbc_prepare</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">operation</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bytes</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span></span></em><span class="sig-paren">)</span> <span class="sig [...] +<span class="sig-name descname"><span class="pre">adbc_prepare</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">operation</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bytes</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span></span></em><span class="sig-paren">)</span> <span class="sig [...] <dd><p>Prepare a query without executing it.</p> <p>To execute the query afterwards, call <a class="reference internal" href="#adbc_driver_manager.dbapi.Cursor.execute" title="adbc_driver_manager.dbapi.Cursor.execute"><code class="xref py py-meth docutils literal notranslate"><span class="pre">execute()</span></code></a> or <a class="reference internal" href="#adbc_driver_manager.dbapi.Cursor.executemany" title="adbc_driver_manager.dbapi.Cursor.executemany"><code class="xref py py-meth docutils literal notranslate"><span class="pre">executemany()</span></code></a> with the same query. This will not @@ -1951,7 +1951,7 @@ inspect the data may not be called.</p> <dl class="py method"> <dt class="sig sig-object py" id="adbc_driver_manager.dbapi.Cursor.fetch_arrow_table"> -<span class="sig-name descname"><span class="pre">fetch_arrow_table</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">→</span> <span class="sig-return-typehint"><a class="reference external" href="https://arrow.apache.org/docs/python/generated/pyarrow.Table.html#pyarrow.Table" title="(in Apache Arrow v19.0.1)"><span class="pre">Table</span></a></span></span><a class="headerlink" href="#adbc_driver_m [...] +<span class="sig-name descname"><span class="pre">fetch_arrow_table</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">→</span> <span class="sig-return-typehint"><a class="reference external" href="https://arrow.apache.org/docs/python/generated/pyarrow.Table.html#pyarrow.Table" title="(in Apache Arrow v20.0.0)"><span class="pre">Table</span></a></span></span><a class="headerlink" href="#adbc_driver_m [...] <dd><p>Fetch all rows of the result as a PyArrow Table.</p> <p>This implements a similar API as DuckDB.</p> <p class="rubric">Notes</p> @@ -1977,7 +1977,7 @@ inspect the data may not be called.</p> <dl class="py method"> <dt class="sig sig-object py" id="adbc_driver_manager.dbapi.Cursor.fetch_record_batch"> -<span class="sig-name descname"><span class="pre">fetch_record_batch</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">→</span> <span class="sig-return-typehint"><a class="reference external" href="https://arrow.apache.org/docs/python/generated/pyarrow.RecordBatchReader.html#pyarrow.RecordBatchReader" title="(in Apache Arrow v19.0.1)"><span class="pre">RecordBatchReader</span></a></span></span><a cl [...] +<span class="sig-name descname"><span class="pre">fetch_record_batch</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">→</span> <span class="sig-return-typehint"><a class="reference external" href="https://arrow.apache.org/docs/python/generated/pyarrow.RecordBatchReader.html#pyarrow.RecordBatchReader" title="(in Apache Arrow v20.0.0)"><span class="pre">RecordBatchReader</span></a></span></span><a cl [...] <dd><p>Fetch the result as a PyArrow RecordBatchReader.</p> <p>This implements a similar API as DuckDB: <a class="reference external" href="https://duckdb.org/docs/guides/python/export_arrow.html#export-as-a-recordbatchreader">https://duckdb.org/docs/guides/python/export_arrow.html#export-as-a-recordbatchreader</a></p> @@ -1993,7 +1993,7 @@ inspect the data may not be called.</p> <dl class="py method"> <dt class="sig sig-object py" id="adbc_driver_manager.dbapi.Cursor.fetchallarrow"> -<span class="sig-name descname"><span class="pre">fetchallarrow</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">→</span> <span class="sig-return-typehint"><a class="reference external" href="https://arrow.apache.org/docs/python/generated/pyarrow.Table.html#pyarrow.Table" title="(in Apache Arrow v19.0.1)"><span class="pre">Table</span></a></span></span><a class="headerlink" href="#adbc_driver_manag [...] +<span class="sig-name descname"><span class="pre">fetchallarrow</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">→</span> <span class="sig-return-typehint"><a class="reference external" href="https://arrow.apache.org/docs/python/generated/pyarrow.Table.html#pyarrow.Table" title="(in Apache Arrow v20.0.0)"><span class="pre">Table</span></a></span></span><a class="headerlink" href="#adbc_driver_manag [...] <dd><p>Fetch all rows of the result as a PyArrow Table.</p> <p>This implements a similar API as turbodbc.</p> <p class="rubric">Notes</p> diff --git a/main/python/recipe/postgresql.html b/main/python/recipe/postgresql.html index 2a478085f..1c5dd7832 100644 --- a/main/python/recipe/postgresql.html +++ b/main/python/recipe/postgresql.html @@ -508,10 +508,10 @@ to use don’t exist.</p> </section> <section id="loading-csv-files-into-postgresql"> <h3>Loading CSV Files into PostgreSQL<a class="headerlink" href="#loading-csv-files-into-postgresql" title="Link to this heading">¶</a></h3> -<p>We can directly pass a <a class="reference external" href="https://arrow.apache.org/docs/python/generated/pyarrow.RecordBatchReader.html#pyarrow.RecordBatchReader" title="(in Apache Arrow v19.0.1)"><code class="xref py py-class docutils literal notranslate"><span class="pre">pyarrow.RecordBatchReader</span></code></a> (from +<p>We can directly pass a <a class="reference external" href="https://arrow.apache.org/docs/python/generated/pyarrow.RecordBatchReader.html#pyarrow.RecordBatchReader" title="(in Apache Arrow v20.0.0)"><code class="xref py py-class docutils literal notranslate"><span class="pre">pyarrow.RecordBatchReader</span></code></a> (from <code class="docutils literal notranslate"><span class="pre">open_csv</span></code>) to <code class="docutils literal notranslate"><span class="pre">adbc_ingest</span></code>. We can also pass a -<a class="reference external" href="https://arrow.apache.org/docs/python/generated/pyarrow.dataset.Dataset.html#pyarrow.dataset.Dataset" title="(in Apache Arrow v19.0.1)"><code class="xref py py-class docutils literal notranslate"><span class="pre">pyarrow.dataset.Dataset</span></code></a>, or a -<a class="reference external" href="https://arrow.apache.org/docs/python/generated/pyarrow.dataset.Scanner.html#pyarrow.dataset.Scanner" title="(in Apache Arrow v19.0.1)"><code class="xref py py-class docutils literal notranslate"><span class="pre">pyarrow.dataset.Scanner</span></code></a>.</p> +<a class="reference external" href="https://arrow.apache.org/docs/python/generated/pyarrow.dataset.Dataset.html#pyarrow.dataset.Dataset" title="(in Apache Arrow v20.0.0)"><code class="xref py py-class docutils literal notranslate"><span class="pre">pyarrow.dataset.Dataset</span></code></a>, or a +<a class="reference external" href="https://arrow.apache.org/docs/python/generated/pyarrow.dataset.Scanner.html#pyarrow.dataset.Scanner" title="(in Apache Arrow v20.0.0)"><code class="xref py py-class docutils literal notranslate"><span class="pre">pyarrow.dataset.Scanner</span></code></a>.</p> <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="linenos">112</span><span class="k">with</span> <span class="n">conn</span><span class="o">.</span><span class="n">cursor</span><span class="p">()</span> <span class="k">as</span> <span class="n">cur</span><span class="p">:</span> <span class="linenos">113</span> <span class="n">reader</span> <span class="o">=</span> <span class="n">pyarrow</span><span class="o">.</span><span class="n">csv</span><span class="o">.</span><span class="n">open_csv</span><span class="p">(</span><span class="n">csv_file</span><span class="p">)</span> <span class="linenos">114</span> <span class="n">cur</span><span class="o">.</span><span class="n">adbc_ingest</span><span class="p">(</span><span class="s2">"csvtable"</span><span class="p">,</span> <span class="n">reader</span><span class="p">,</span> <span class="n">mode</span><span class="o">=</span><span class="s2">"create"</span><span class="p">)</span> diff --git a/main/r/adbcbigquery/pkgdown.yml b/main/r/adbcbigquery/pkgdown.yml index 5aeadc4ab..3598d9684 100644 --- a/main/r/adbcbigquery/pkgdown.yml +++ b/main/r/adbcbigquery/pkgdown.yml @@ -2,7 +2,7 @@ pandoc: 3.6.4 pkgdown: 2.1.2 pkgdown_sha: ~ articles: {} -last_built: 2025-04-30T00:09Z +last_built: 2025-05-01T01:30Z urls: reference: https://arrow.apache.org/adbc/current/r/adbcbigquery/reference article: https://arrow.apache.org/adbc/current/r/adbcbigquery/articles diff --git a/main/r/adbcdrivermanager/pkgdown.yml b/main/r/adbcdrivermanager/pkgdown.yml index 0a5318c69..72592c491 100644 --- a/main/r/adbcdrivermanager/pkgdown.yml +++ b/main/r/adbcdrivermanager/pkgdown.yml @@ -2,7 +2,7 @@ pandoc: 3.6.4 pkgdown: 2.1.2 pkgdown_sha: ~ articles: {} -last_built: 2025-04-30T00:09Z +last_built: 2025-05-01T01:30Z urls: reference: https://arrow.apache.org/adbc/current/r/adbcdrivermanager/reference article: https://arrow.apache.org/adbc/current/r/adbcdrivermanager/articles diff --git a/main/r/adbcdrivermanager/reference/adbc_connection_init.html b/main/r/adbcdrivermanager/reference/adbc_connection_init.html index c54b63bf0..ebae875c2 100644 --- a/main/r/adbcdrivermanager/reference/adbc_connection_init.html +++ b/main/r/adbcdrivermanager/reference/adbc_connection_init.html @@ -105,9 +105,9 @@ finer-grained control over behaviour at the R level.</p></dd> <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-examples"></a></h2> <div class="sourceCode"><pre class="sourceCode r"><code><span class="r-in"><span><span class="va">db</span> <span class="op"><-</span> <span class="fu"><a href="adbc_database_init.html">adbc_database_init</a></span><span class="op">(</span><span class="fu"><a href="adbc_driver_void.html">adbc_driver_void</a></span><span class="op">(</span><span class="op">)</span><span class="op">)</span></span></span> <span class="r-in"><span><span class="fu">adbc_connection_init</span><span class="op">(</span><span class="va">db</span><span class="op">)</span></span></span> -<span class="r-out co"><span class="r-pr">#></span> <adbc_connection at 0x5649e8a76760> </span> +<span class="r-out co"><span class="r-pr">#></span> <adbc_connection at 0x55c8ca799b80> </span> <span class="r-out co"><span class="r-pr">#></span> List of 1</span> -<span class="r-out co"><span class="r-pr">#></span> $ database:<adbc_database at 0x5649e8186820> </span> +<span class="r-out co"><span class="r-pr">#></span> $ database:<adbc_database at 0x55c8cae5ea30> </span> <span class="r-out co"><span class="r-pr">#></span> List of 1</span> <span class="r-out co"><span class="r-pr">#></span> ..$ driver:<adbc_driver_void> List of 2</span> <span class="r-out co"><span class="r-pr">#></span> .. ..$ driver_init_func:Class 'adbc_driver_init_func' <externalptr> </span> diff --git a/main/r/adbcdrivermanager/reference/adbc_database_init.html b/main/r/adbcdrivermanager/reference/adbc_database_init.html index 449aa3b7c..d0bff802e 100644 --- a/main/r/adbcdrivermanager/reference/adbc_database_init.html +++ b/main/r/adbcdrivermanager/reference/adbc_database_init.html @@ -104,7 +104,7 @@ finer-grained control over behaviour at the R level.</p></dd> <div class="section level2"> <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-examples"></a></h2> <div class="sourceCode"><pre class="sourceCode r"><code><span class="r-in"><span><span class="fu">adbc_database_init</span><span class="op">(</span><span class="fu"><a href="adbc_driver_void.html">adbc_driver_void</a></span><span class="op">(</span><span class="op">)</span><span class="op">)</span></span></span> -<span class="r-out co"><span class="r-pr">#></span> <adbc_database at 0x5649e4c11a40> </span> +<span class="r-out co"><span class="r-pr">#></span> <adbc_database at 0x55c8caa97a20> </span> <span class="r-out co"><span class="r-pr">#></span> List of 1</span> <span class="r-out co"><span class="r-pr">#></span> $ driver:<adbc_driver_void> List of 2</span> <span class="r-out co"><span class="r-pr">#></span> ..$ driver_init_func:Class 'adbc_driver_init_func' <externalptr> </span> diff --git a/main/r/adbcdrivermanager/reference/adbc_statement_init.html b/main/r/adbcdrivermanager/reference/adbc_statement_init.html index 3484b88fb..75140f9f6 100644 --- a/main/r/adbcdrivermanager/reference/adbc_statement_init.html +++ b/main/r/adbcdrivermanager/reference/adbc_statement_init.html @@ -106,11 +106,11 @@ finer-grained control over behaviour at the R level.</p></dd> <div class="sourceCode"><pre class="sourceCode r"><code><span class="r-in"><span><span class="va">db</span> <span class="op"><-</span> <span class="fu"><a href="adbc_database_init.html">adbc_database_init</a></span><span class="op">(</span><span class="fu"><a href="adbc_driver_void.html">adbc_driver_void</a></span><span class="op">(</span><span class="op">)</span><span class="op">)</span></span></span> <span class="r-in"><span><span class="va">con</span> <span class="op"><-</span> <span class="fu"><a href="adbc_connection_init.html">adbc_connection_init</a></span><span class="op">(</span><span class="va">db</span><span class="op">)</span></span></span> <span class="r-in"><span><span class="fu">adbc_statement_init</span><span class="op">(</span><span class="va">con</span><span class="op">)</span></span></span> -<span class="r-out co"><span class="r-pr">#></span> <adbc_statement at 0x5649e8519490> </span> +<span class="r-out co"><span class="r-pr">#></span> <adbc_statement at 0x55c8cad073d0> </span> <span class="r-out co"><span class="r-pr">#></span> List of 1</span> -<span class="r-out co"><span class="r-pr">#></span> $ connection:<adbc_connection at 0x5649e8d7f8a0> </span> +<span class="r-out co"><span class="r-pr">#></span> $ connection:<adbc_connection at 0x55c8cae22c40> </span> <span class="r-out co"><span class="r-pr">#></span> List of 1</span> -<span class="r-out co"><span class="r-pr">#></span> ..$ database:<adbc_database at 0x5649e8b54930> </span> +<span class="r-out co"><span class="r-pr">#></span> ..$ database:<adbc_database at 0x55c8cb110ed0> </span> <span class="r-out co"><span class="r-pr">#></span> List of 1</span> <span class="r-out co"><span class="r-pr">#></span> .. ..$ driver:<adbc_driver_void> List of 2</span> <span class="r-out co"><span class="r-pr">#></span> .. .. ..$ driver_init_func:Class 'adbc_driver_init_func' <externalptr> </span> diff --git a/main/r/adbcdrivermanager/search.json b/main/r/adbcdrivermanager/search.json index 7fc5d9f5f..887b50af8 100644 --- a/main/r/adbcdrivermanager/search.json +++ b/main/r/adbcdrivermanager/search.json @@ -1 +1 @@ -[{"path":"https://arrow.apache.org/adbc/current/r/adbcdrivermanager/LICENSE.html","id":null,"dir":"","previous_headings":"","what":"Apache License","title":"Apache License","text":"Version 2.0, January 2004 <http://www.apache.org/licenses/>","code":""},{"path":[]},{"path":"https://arrow.apache.org/adbc/current/r/adbcdrivermanager/LICENSE.html","id":"id_1-definitions","dir":"","previous_headings":"Terms and Conditions for use, reproduction, and distribution","what":"1. Definitions","title [...] +[{"path":"https://arrow.apache.org/adbc/current/r/adbcdrivermanager/LICENSE.html","id":null,"dir":"","previous_headings":"","what":"Apache License","title":"Apache License","text":"Version 2.0, January 2004 <http://www.apache.org/licenses/>","code":""},{"path":[]},{"path":"https://arrow.apache.org/adbc/current/r/adbcdrivermanager/LICENSE.html","id":"id_1-definitions","dir":"","previous_headings":"Terms and Conditions for use, reproduction, and distribution","what":"1. Definitions","title [...] diff --git a/main/r/adbcflightsql/pkgdown.yml b/main/r/adbcflightsql/pkgdown.yml index 188c5df06..50fdd6f2a 100644 --- a/main/r/adbcflightsql/pkgdown.yml +++ b/main/r/adbcflightsql/pkgdown.yml @@ -2,7 +2,7 @@ pandoc: 3.6.4 pkgdown: 2.1.2 pkgdown_sha: ~ articles: {} -last_built: 2025-04-30T00:09Z +last_built: 2025-05-01T01:30Z urls: reference: https://arrow.apache.org/adbc/current/r/adbcflightsql/reference article: https://arrow.apache.org/adbc/current/r/adbcflightsql/articles diff --git a/main/r/adbcpostgresql/pkgdown.yml b/main/r/adbcpostgresql/pkgdown.yml index b25262063..974cdc95d 100644 --- a/main/r/adbcpostgresql/pkgdown.yml +++ b/main/r/adbcpostgresql/pkgdown.yml @@ -2,7 +2,7 @@ pandoc: 3.6.4 pkgdown: 2.1.2 pkgdown_sha: ~ articles: {} -last_built: 2025-04-30T00:09Z +last_built: 2025-05-01T01:30Z urls: reference: https://arrow.apache.org/adbc/current/r/adbcpostgresql/reference article: https://arrow.apache.org/adbc/current/r/adbcpostgresql/articles diff --git a/main/r/adbcsnowflake/pkgdown.yml b/main/r/adbcsnowflake/pkgdown.yml index 84943eb25..f5ab6cc3d 100644 --- a/main/r/adbcsnowflake/pkgdown.yml +++ b/main/r/adbcsnowflake/pkgdown.yml @@ -2,7 +2,7 @@ pandoc: 3.6.4 pkgdown: 2.1.2 pkgdown_sha: ~ articles: {} -last_built: 2025-04-30T00:09Z +last_built: 2025-05-01T01:30Z urls: reference: https://arrow.apache.org/adbc/current/r/adbcsnowflake/reference article: https://arrow.apache.org/adbc/current/r/adbcsnowflake/articles diff --git a/main/r/adbcsqlite/pkgdown.yml b/main/r/adbcsqlite/pkgdown.yml index d877cd551..c6fa02337 100644 --- a/main/r/adbcsqlite/pkgdown.yml +++ b/main/r/adbcsqlite/pkgdown.yml @@ -2,7 +2,7 @@ pandoc: 3.6.4 pkgdown: 2.1.2 pkgdown_sha: ~ articles: {} -last_built: 2025-04-30T00:09Z +last_built: 2025-05-01T01:30Z urls: reference: https://arrow.apache.org/adbc/current/r/adbcsqlite/reference article: https://arrow.apache.org/adbc/current/r/adbcsqlite/articles diff --git a/main/searchindex.js b/main/searchindex.js index 3181d7b8d..7f8bb7b20 100644 --- a/main/searchindex.js +++ b/main/searchindex.js @@ -1 +1 @@ -Search.setIndex({"alltitles":{"ADBC API Standard":[[24,null]],"API Reference":[[3,"api-reference"],[29,"api-reference"],[37,"api-reference"]],"And then what is the \u201cADBC JDBC driver\u201d?":[[20,"and-then-what-is-the-adbc-jdbc-driver"]],"Apache Arrow ADBC":[[27,null]],"Arrow type to PostgreSQL type mapping":[[16,"id5"]],"Authenticate with a username and password":[[43,"authenticate-with-a-username-and-password"]],"Authentication":[[13,"authentication"],[17,"authentication"]],"Autoco [...] \ No newline at end of file +Search.setIndex({"alltitles":{"ADBC API Standard":[[24,null]],"API Reference":[[3,"api-reference"],[29,"api-reference"],[37,"api-reference"]],"And then what is the \u201cADBC JDBC driver\u201d?":[[20,"and-then-what-is-the-adbc-jdbc-driver"]],"Apache Arrow ADBC":[[27,null]],"Arrow type to PostgreSQL type mapping":[[16,"id5"]],"Authenticate with a username and password":[[43,"authenticate-with-a-username-and-password"]],"Authentication":[[13,"authentication"],[17,"authentication"]],"Autoco [...] \ No newline at end of file