#datafusion #rest #odata #sql #arrow

datafusion-odata

OData protocol adapter for Apache Datafusion

9 releases (5 stable)

37.2.0 Apr 11, 2024
37.1.0 Apr 9, 2024
36.1.0 Apr 11, 2024
0.4.0 Mar 15, 2024
0.1.0 Mar 11, 2024

#118 in HTTP server

Download history 391/week @ 2024-03-11 145/week @ 2024-03-18 235/week @ 2024-03-25 174/week @ 2024-04-01 871/week @ 2024-04-08 275/week @ 2024-04-15

1,573 downloads per month

Apache-2.0

250KB
906 lines

OData Adapter For Apache Datafusion

About

This is an OData API adapter for Apache Datafusion SQL engine.

OData protocol is positioned as "The SQL of REST", but is a somewhat legacy protocol used by some older systems. We wouldn't recommend using it as an integration protocol for some new project, but this adapter is useful if you have to integrate your Datafusion app with some existing OData-focused system.

Quick Start

Start example:

RUST_LOG=debug cargo run --example simple_service

Query using xh:

Service root:

xh GET 'http://localhost:3000/'

Metadata:

xh GET 'http://localhost:3000/$metadata'

Query collection:

xh GET 'http://localhost:3000/tickers.spy/?$select=offset,from_symbol,to_symbol,close&$top=5'

Status

This code is super raw and experimental. Very far from prod-ready. Use at your own risk.

  • Only support small subset of OData 3.0
  • Only supports atom format in responses
  • Service root resource
  • $metadata resource
  • Collection resource
    • $select
    • $orderby
    • $skip
    • $top
    • $filter
    • pagination
    • real object IDs
  • Collection entry by ID (service/collection(id))
    • Numeric IDs
    • Other ID types
  • Parameters
  • Nested collections
  • Functions
  • ...

Dependencies

~37–53MB
~1M SLoC