Make cayenne-flightsql tool (spiceai#10356)

* make cayenne-flightsql tool

* Fix cayenne-flightsql lint and review feedback

---------

Co-authored-by: claudespice <claude@spice.ai>

Author: Jeadie

Cargo.lock

@@ -65,6 +65,7 @@ members = [
     "tools/flightpublisher/",
     "tools/flightsubscriber/",
     "tools/flight-cookie-server/",
+    "tools/cayenne-flightsql/",
     "tools/otelpublisher/",
     "tools/spicepodschema/",
     "tools/spiceschema",

Cargo.toml

@@ -44,6 +44,14 @@ build-spidapter-dev:
 build-spidapter:
 	cargo build --release -p spidapter --all-features
 
+.PHONY: build-cayenne-flightsql-dev
+build-cayenne-flightsql-dev:
+	cargo build -p cayenne-flightsql --all-features
+
+.PHONY: build-cayenne-flightsql
+build-cayenne-flightsql:
+	cargo build --release -p cayenne-flightsql --all-features
+
 .PHONY: ci
 ci:
 	make -C bin/spice
@@ -335,6 +343,16 @@ install-spidapter: build-spidapter
 	mkdir -p ~/.spice/bin
 	install -m 755 target/release/spidapter ~/.spice/bin/spidapter
 
+.PHONY: install-cayenne-flightsql-dev
+install-cayenne-flightsql-dev: build-cayenne-flightsql-dev
+	mkdir -p ~/.spice/bin
+	install -m 755 target/debug/cayenne-flightsql ~/.spice/bin/cayenne-flightsql
+
+.PHONY: install-cayenne-flightsql
+install-cayenne-flightsql: build-cayenne-flightsql
+	mkdir -p ~/.spice/bin
+	install -m 755 target/release/cayenne-flightsql ~/.spice/bin/cayenne-flightsql
+
 .PHONY: install-cli
 install-cli: build-cli
 	mkdir -p ~/.spice/bin

Makefile

@@ -0,0 +1,22 @@
+[package]
+description = "Standalone Flight SQL server with a single Cayenne catalog"
+edition.workspace = true
+homepage.workspace = true
+license.workspace = true
+name = "cayenne-flightsql"
+repository.workspace = true
+rust-version.workspace = true
+version.workspace = true
+
+[dependencies]
+cayenne = { path = "../../crates/cayenne" }
+clap = { workspace = true, features = ["derive", "env"] }
+data_components = { path = "../../crates/data_components" }
+datafusion = { workspace = true }
+datafusion-flightsql = { path = "../../crates/datafusion-flightsql" }
+snafu = { workspace = true }
+tokio = { workspace = true }
+tonic = { workspace = true }
+tracing = { workspace = true }
+tracing-subscriber = { workspace = true, features = ["env-filter"] }
+util = { path = "../../crates/util" }

tools/cayenne-flightsql/Cargo.toml

@@ -0,0 +1,33 @@
+# cayenne-flightsql
+
+A standalone Arrow Flight SQL server backed by a single Cayenne catalog.
+
+## Run
+
+```bash
+cargo run -p cayenne-flightsql -- \
+  --addr 127.0.0.1:50051 \
+  --catalog cayenne \
+  --default-schema public
+```
+
+## Key options
+
+- `--addr` (`FLIGHTSQL_ADDR`) - listen address.
+- `--catalog` (`FLIGHTSQL_CATALOG`) - catalog name registered in DataFusion.
+- `--default-schema` (`FLIGHTSQL_DEFAULT_SCHEMA`) - schema used for unqualified table names.
+- `--spice-data-base-path` (`CAYENNE_SPICE_DATA_BASE_PATH`) - base path used when explicit Cayenne data/metadata directories are omitted.
+- `--cayenne-data-dir` / `--cayenne-metadata-dir` - explicit data + metadata directories.
+- `--refresh-interval-secs` (`CAYENNE_REFRESH_INTERVAL_SECS`) - optional periodic catalog refresh.
+
+## Querying
+
+By default, unqualified names resolve to `<catalog>.<default-schema>.<table>`.
+
+On startup, if the configured `--default-schema` does not exist in Cayenne, it is created automatically.
+
+If your table is in a different Cayenne namespace/schema, query with fully-qualified names:
+
+```sql
+SELECT * FROM cayenne.analytics.events;
+```