Skip to content

Commit

Permalink
MINOR: [Docs] Update alignment to center for ADBC documentation (apac…
Browse files Browse the repository at this point in the history
…he#43081)

### Rationale for this change

Update alignment to center in specification for ADBC

### What changes are included in this PR?

Update alignment to some content.

### Are these changes tested?

Yes. I have verified the changes by building the documentation.

### Are there any user-facing changes?

Yes. the updated documentation will be visible to users.

Authored-by: Hyunseok Seo <[email protected]>
Signed-off-by: David Li <[email protected]>
  • Loading branch information
llama90 authored Jun 28, 2024
1 parent 8909163 commit a42df4b
Showing 1 changed file with 19 additions and 19 deletions.
38 changes: 19 additions & 19 deletions docs/source/format/ADBC.rst
Original file line number Diff line number Diff line change
Expand Up @@ -188,25 +188,25 @@ bypass this wrapper.

.. figure:: ./ADBCQuadrants.svg

ADBC, JDBC, and ODBC are database-agnostic. They define the
API that the application uses, but not how that API is implemented,
instead deferring to drivers to fulfill requests using the protocol
of their choice. JDBC and (generally) ODBC offer results in a
row-oriented format, while ADBC offers columnar Arrow data.

Protocols/libraries like libpq (Postgres) and TDS (SQL Server) are
database-specific and row-oriented. Multiple databases may
implement the same protocol to try to reuse each other's work,
e.g. several databases implement the Postgres wire protocol to
benefit from its driver implementations. But the protocol itself
was not designed with multiple databases in mind, nor are the
protocols generally meant to be used directly by applications.

Some database-specific protocols are Arrow-native, like those of
BigQuery and ClickHouse. Flight SQL additionally is meant to be
database-agnostic, but it defines both the client-facing API and
the underlying protocol, so it's hard for applications to use it as
the API for databases that don't already implement Flight SQL.
ADBC, JDBC, and ODBC are database-agnostic. They define the
API that the application uses, but not how that API is implemented,
instead deferring to drivers to fulfill requests using the protocol
of their choice. JDBC and (generally) ODBC offer results in a
row-oriented format, while ADBC offers columnar Arrow data.

Protocols/libraries like libpq (Postgres) and TDS (SQL Server) are
database-specific and row-oriented. Multiple databases may
implement the same protocol to try to reuse each other's work,
e.g. several databases implement the Postgres wire protocol to
benefit from its driver implementations. But the protocol itself
was not designed with multiple databases in mind, nor are the
protocols generally meant to be used directly by applications.

Some database-specific protocols are Arrow-native, like those of
BigQuery and ClickHouse. Flight SQL additionally is meant to be
database-agnostic, but it defines both the client-facing API and
the underlying protocol, so it's hard for applications to use it as
the API for databases that don't already implement Flight SQL.

Existing database client APIs
-----------------------------
Expand Down

0 comments on commit a42df4b

Please sign in to comment.