serve-unbound

The xorq serve-unbound command serves a built expression as an Arrow Flight service after replacing a selected node with an unbound table. This lets clients stream record batches to the server to drive the computation.

Usage

xorq serve-unbound <build_path> [options]

Arguments

  • build_path: Path to the build directory produced by xorq build/uv-build.

Options

  • –to_unbind_hash: Hash of the node to replace with an unbound source.
  • –to_unbind_tag: Tag of the node to replace (alternative to hash).
  • –typ: Type of the node to unbind.
  • –host: Host to bind Flight Server (default: localhost).
  • –port: Port to bind Flight Server (default: random available port).
  • –prometheus-port: Port to expose Prometheus metrics (if metrics packages installed).
  • –cache-dir: Directory for parquet cache files.

Notes

  • If neither --to_unbind_hash nor --to_unbind_tag is provided, the command will attempt to infer the target based on graph analysis; providing one is recommended for determinism.

Examples

# Serve with explicit node hash
xorq serve-unbound builds/7061dd65ff3c --host 0.0.0.0 --port 8001 \
  --cache-dir cache --to_unbind_hash b2370a29c19df8e1e639c63252dacd0e

# Serve selecting by tag
xorq serve-unbound builds/7061dd65ff3c --to_unbind_tag source_input