catalog serve-unbound

Resolve a catalog entry, unbind a node, and serve it via Flight.

The catalog-aware counterpart to the top-level xorq serve-unbound: instead of pointing at a build directory, you reference an entry by name or alias and Xorq resolves it from the active catalog. Clients stream record batches to the endpoint to drive the computation.

Usage

xorq catalog serve-unbound ENTRY [OPTIONS]

Arguments

  • ENTRY—Catalog entry name or alias to serve.

Options

Option Default Description
--to-unbind-hash inferred Hash of the node to unbind.
--to-unbind-tag inferred Tag of the node to unbind (alternative to –to-unbind-hash).
--typ none Type of the node to unbind.
--host localhost Host to bind the Flight server.
--port random Port to bind the Flight server.
--prometheus-port off Port to expose Prometheus metrics.
-c, --code none Inline Ibis code expression applied to source.
--fuse / --no-fuse --fuse Enable catalog source fusion.
--rename-params none Rename a parameter on a specific entry: entry,old_name,new_name (repeatable).
-p, --params none Override an expression parameter as key=value (repeatable, for example –params threshold=0.5).
--cache-dir $XORQ_CACHE_DIR or ~/.cache/xorq Directory for parquet cache files.

Examples

# Serve an aliased entry, unbinding by tag
xorq catalog serve-unbound flights-model --to-unbind-tag source_input --host 0.0.0.0 --port 8001
# Bind a runtime parameter
xorq catalog serve-unbound scorer --params threshold=0.5

See also