https://github.com/amoeba/arrow-flight-playground
Various examples related to Apache Arrow Flight.
https://github.com/amoeba/arrow-flight-playground
apache-arrow arrow-flight cpp
Last synced: 8 months ago
JSON representation
Various examples related to Apache Arrow Flight.
- Host: GitHub
- URL: https://github.com/amoeba/arrow-flight-playground
- Owner: amoeba
- License: mit
- Created: 2023-02-14T02:41:04.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-06-07T22:14:56.000Z (over 2 years ago)
- Last Synced: 2025-02-15T08:12:39.396Z (8 months ago)
- Topics: apache-arrow, arrow-flight, cpp
- Language: C++
- Homepage:
- Size: 438 KB
- Stars: 1
- Watchers: 4
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# arrow-flight-playground
Various examples related to [Apache Arrow Flight](https://arrow.apache.org/docs/format/Flight.html).
## Included Examples
- [basic_doput](./basic_doput/): Basic example of the `DoPut` call
- [headers_call_options](./headers_call_options/): Example of using FlightCallOptions to pass context between a Flight Server and Flight Client
- [headers_middleware](./headers_middleware/): Example of using Flight Middleware to pass context between a Flight Server and Flight Client
- [test_flight_stress](./test_flight_stress/): Example of various combinations of Arrow versions and Flight Clients to stress test Flight
- [distributed_with_opentelemetry](./distributed_with_opentelemetry/): Example of a distributed (multi-server) Flight server with end-to-end OpenTelemetry tracing
## Building & Running
Each example should have its own `CMakeLists.txt` and assumes you have a version of Arrow C++ configured and build elsewhere on your system.
Some of the examples may container Dockerfiles which will also build the example for you as an alternative to building it yourself.
### Arrow C++
Note: This can be simplified if you're able to install a binary distribution of Apache Arrow system-wide (i.e., `brew install apache-arrow`).
Steps:
1. Set `ARROW_HOME` to a suitable location to install Arrow C++ to
2. Download or checkout a version of the Apache Arrow source
3. Make an out-of-source build directory inside the directory from (2) `cpp/build` and `cd` into it
4. Configure:
```sh
cmake .. \
-GNinja \
-DCMAKE_INSTALL_PREFIX="$ARROW_HOME" \
-DARROW_BUILD_INTEGRATION="OFF" \
-DARROW_BUILD_STATIC="OFF" \
-DARROW_BUILD_TESTS="OFF" \
-DARROW_EXTRA_ERROR_CONTEXT="ON" \
-DARROW_WITH_RE2="OFF" \
-DARROW_WITH_UTF8PROC="OFF" \
-DCMAKE_BUILD_TYPE="Debug" \
-DARROW_FLIGHT="ON" \
-DARROW_FILESYSTEM="ON" \
-DARROW_PARQUET=ON
```
5. `ninja install`
### Each Example
Steps:
1. Set `ARROW_HOME` to where you've installed Arrow C++
2. Make an out-of-source build directory in `./build` and `cd` into it
```sh
cmake .. \
-GNinja \
-DCMAKE_MODULE_PATH="$ARROW_HOME/lib/cmake/arrow"
```
3. `ninja`
4. Run `./client` and/or `./server` as appropriate