Google Git
Sign in
apache / arrow-adbc / refs/heads/main
commit71072e06c880cd9ab0929e9eec902b9ddbc98211[log] [tgz]
authorCurt Hagenlocher <curt@hagenlocher.org>Thu Apr 25 15:00:56 2024 -0700
committerGitHub <noreply@github.com>Thu Apr 25 15:00:56 2024 -0700
treefcf15ea6f493636a93eb255745bad522d8a6b6a1
parent8bd0e9bd308a4a1d8222d4c8317e98fd39e8d5ee [diff]
feat(csharp): Implement remaining functions in 1.0 spec (#1773)

Implements the remaining functions in the 1.0 specification in the C
interop layer.

Closes #1221
5 files changed
tree: fcf15ea6f493636a93eb255745bad522d8a6b6a1
  1. .github/
  2. c/
  3. ci/
  4. csharp/
  5. dev/
  6. docs/
  7. glib/
  8. go/
  9. java/
  10. python/
  11. r/
  12. ruby/
  13. rust/
  14. testing
  15. .asf.yaml
  16. .clang-format
  17. .clang-tidy
  18. .cmake-format
  19. .env
  20. .flake8
  21. .gitattributes
  22. .gitignore
  23. .gitmodules
  24. .isort.cfg
  25. .pre-commit-config.yaml
  26. adbc.h
  27. CHANGELOG.md
  28. CONTRIBUTING.md
  29. docker-compose.yml
  30. license.tpl
  31. LICENSE.txt
  32. NOTICE.txt
  33. pyrightconfig.json
  34. 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, or read the changelog.

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.