serve-flight-udxf

Serve an expression’s UDXF nodes as an Arrow Flight endpoint.

Loads the built expression, detects its UDXF (user-defined exchange function) nodes, and hosts them with FlightServer.from_udxf. Clients connect with xo.flight.connect, fetch the exchange by its command name with con.get_exchange, and stream data through it.

Usage

xorq serve-flight-udxf BUILD_PATH [OPTIONS]

Arguments

  • BUILD_PATH—Path to the build directory produced by xorq build.

Options

Option Default Description
--host localhost Host to bind the Flight server.
--port random Port to bind the Flight server.
--prometheus-port off Port to expose Prometheus metrics.
--duckdb-path <build_path>/xorq_serve.db Path to the DuckDB database file used by the server.
--cache-dir $XORQ_CACHE_DIR or ~/.cache/xorq Directory for parquet cache files.

Examples

# Serve a built UDXF expression
xorq serve-flight-udxf builds/f02d28198715 --host 0.0.0.0 --port 8080

See also

  • serve-unbound—serve an unbound expression instead of UDXF nodes