https://github.com/timvw/arrow-flight-sql-client
Arrow Flight Sql Client
https://github.com/timvw/arrow-flight-sql-client
Last synced: about 1 month ago
JSON representation
Arrow Flight Sql Client
- Host: GitHub
- URL: https://github.com/timvw/arrow-flight-sql-client
- Owner: timvw
- License: apache-2.0
- Created: 2022-06-01T20:53:28.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2025-04-07T23:39:12.000Z (about 2 months ago)
- Last Synced: 2025-04-08T00:28:32.191Z (about 2 months ago)
- Language: Rust
- Size: 127 KB
- Stars: 2
- Watchers: 1
- Forks: 2
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Arrow Flight SQL Client
flightsqlclient is a small command line app to query a [Flight SQL server](https://arrow.apache.org/blog/2022/02/16/introducing-arrow-flight-sql/).
You can find instructions to run such a server here: [notes on running java FlightSqlExample](http://timvw.be/2022/04/28/notes-on-running-java-flightsqlexample/).
## Installation
Download a binary from our [Releases](https://github.com/timvw/arrow-flight-sql-client/releases).
Or using homebrew
```bash
brew tap timvw/tap
brew install arrow-flight-sql-client
```
Or using cargo
```bash
cargo install arrow-flight-sql-client
```
Or using docker
```bash
docker run --rm ghcr.io/timvw/arrow-flight-sql-client:v0.4.0 get-tables --hostname 192.168.1.95
```
## Usage
When you run the app without arguments, you will be greeted with it's usage:
```bash
arrow-flight-sql-client
USAGE:
client
OPTIONS:
-h, --help Print help information
-V, --version Print version information
SUBCOMMANDS:
execute
get-catalogs
get-exported-keys
get-imported-keys
get-primary-keys
get-schemas
get-table-types
get-tables
help Print this message or the help of the given subcommand(s)
```
Listing the available tables can be done as following:
```
arrow-flight-sql-client get-tables --hostname localhost --port 52358
+--------------+----------------+------------------+--------------+
| catalog_name | db_schema_name | table_name | table_type |
+--------------+----------------+------------------+--------------+
| | SYS | SYSALIASES | SYSTEM TABLE |
... (removed some lines to reduce output)
| | APP | FOREIGNTABLE | TABLE |
| | APP | INTTABLE | TABLE |
+--------------+----------------+------------------+--------------+
```
A query can be executed as following:
```
arrow-flight-sql-client execute --query "select * from app.inttable order by value desc"
+----+--------------+-------+-----------+
| ID | KEYNAME | VALUE | FOREIGNID |
+----+--------------+-------+-----------+
| 1 | one | 1 | 1 |
| 2 | zero | 0 | 1 |
| 3 | negative one | -1 | 1 |
+----+--------------+-------+-----------+
```