Google Git
Sign in
apache / arrow-adbc / refs/tags/apache-arrow-adbc-0.3.0-rc0
tag8f39f6c1e25755d35b9060da0e170533708096ee
taggerDavid Li <li.davidm96@gmail.com>Thu Mar 16 15:18:49 2023 -0400
objectfdd13ae36f747f27fd3bd894400ec4250b6df0f8 
ADBC Libraries 0.3.0 RC 0
commitfdd13ae36f747f27fd3bd894400ec4250b6df0f8[log] [tgz]
authorDavid Li <li.davidm96@gmail.com>Thu Mar 16 15:18:49 2023 -0400
committerDavid Li <li.davidm96@gmail.com>Thu Mar 16 15:18:49 2023 -0400
treeca1989a7fab1a839941c6ee1e52b660f63aef8a5
parent56aaf0301cf7b146264124fd15d03ba719b20ff7 [diff]
chore: update versions for 0.3.0
16 files changed
tree: ca1989a7fab1a839941c6ee1e52b660f63aef8a5
  1. .github/
  2. c/
  3. ci/
  4. dev/
  5. docs/
  6. glib/
  7. go/
  8. java/
  9. python/
  10. r/
  11. ruby/
  12. .asf.yaml
  13. .clang-format
  14. .cmake-format
  15. .env
  16. .flake8
  17. .gitattributes
  18. .gitignore
  19. .isort.cfg
  20. .pre-commit-config.yaml
  21. adbc.h
  22. CHANGELOG.md
  23. CONTRIBUTING.md
  24. docker-compose.yml
  25. LICENSE.txt
  26. NOTICE.txt
  27. README.md
README.md

ADBC: Arrow Database Connectivity

License

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, 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.

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.

Installation

Please see the documentation.

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.