https://github.com/apache/arrow-adbc
Database connectivity API standard and libraries for Apache Arrow
https://github.com/apache/arrow-adbc
arrow database
Last synced: 5 months ago
JSON representation
Database connectivity API standard and libraries for Apache Arrow
- Host: GitHub
- URL: https://github.com/apache/arrow-adbc
- Owner: apache
- License: apache-2.0
- Created: 2022-06-01T15:08:49.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-05-09T17:22:46.000Z (5 months ago)
- Last Synced: 2025-05-09T18:36:47.577Z (5 months ago)
- Topics: arrow, database
- Language: C#
- Homepage: https://arrow.apache.org/adbc/
- Size: 57.7 MB
- Stars: 435
- Watchers: 40
- Forks: 116
- Open Issues: 266
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# ADBC: Arrow Database Connectivity
[](https://github.com/apache/arrow-adbc/blob/master/LICENSE.txt)
ADBC is an API standard (version 1.0.0) for database access libraries ("drivers") in C, Go, and Java that uses Arrow for result sets and query parameters.
Instead of writing code to convert to and from Arrow data for each individual database, applications can build against the ADBC APIs, and link against drivers that implement the standard.
Additionally, a JDBC/ODBC-style driver manager is provided. This also implements the ADBC APIs, but dynamically loads drivers and dispatches calls to them.
Like JDBC/ODBC, the goal is to provide a generic API for multiple databases. ADBC, however, is focused on bulk columnar data retrieval and ingestion through an Arrow-based API rather than attempting to replace JDBC/ODBC in all use cases.
Hence, ADBC is complementary to those existing standards.
Like [Arrow Flight SQL][flight-sql], ADBC is an Arrow-based way to work with databases.
However, Flight SQL is a _protocol_ defining a wire format and network transport as opposed to an _API specification_. Flight SQL requires a database to specifically implement support for it, while ADBC is a client API specification for wrapping existing database protocols which could be Arrow-native or not.
Together, ADBC and Flight SQL offer a fully Arrow-native solution for clients and database vendors.
For more about ADBC, see the [introductory blog post][arrow-blog].
[arrow-blog]: https://arrow.apache.org/blog/2023/01/05/introducing-arrow-adbc/
[flight-sql]: https://arrow.apache.org/docs/format/FlightSql.html
## Status
ADBC versions the API standard and the implementing libraries separately.
The API standard (version 1.0.0) is considered stable, but enhancements may be made.
Libraries are under development.
For more details, see the [documentation](https://arrow.apache.org/adbc/main/driver/status.html), or read the [changelog](CHANGELOG.md).
## Installation
Please see the [documentation](https://arrow.apache.org/adbc/main/driver/installation.html).
## Documentation
The core API definitions can be read in `adbc.h`.
User documentation can be found at https://arrow.apache.org/adbc
## Development and Contributing
For detailed instructions on how to build the various ADBC libraries, see [CONTRIBUTING.md](CONTRIBUTING.md).