Pin an explicit compute-node URL, disabling Auto routing via the control plane's /nodes/recommend endpoint.
--compute-url <URL> (env: DF_COMPUTE_URL)## Overview `--compute-url` pins the CLI to a specific compute node for this invocation. When set, Auto routing is disabled, which means the CLI does not consult `/nodes/recommend` to pick a worker. Every statement is sent directly to the given URL. The built-in default is `http://localhost:3031`. When no compute URL is configured anywhere, Auto routing is on and the CLI asks the control plane for a recommended node per request. ## Behavior - Setting the flag flips two internal booleans: `compute_url_auto=false` and `compute_url_explicit=true`. These drive per-statement routing decisions. - The pinned URL is used for every SQL statement, regardless of workload hints or hot/cold tiering preferences that Auto routing would normally apply. - Slash commands inside the REPL (`/nodes`, `/use-node`) still work and can flip routing modes at runtime, but the starting state reflects the flag's presence. - Pairs cleanly with `--node <NAME>`. When both are set, `--compute-url` takes effect immediately and `--node` resolves the display name through `/list-compute-nodes` for labelling and subsequent routing. - If the pinned URL is unreachable, each statement fails independently with a network error; there is no automatic failover to another node while the flag is active. ## Compatibility Resolution order for the compute URL: `--compute-url`, `DF_COMPUTE_URL`, profile `compute_url`, built-in default `http://localhost:3031`. When any of the first three are present, Auto routing is off for the whole invocation.
# Pin every query in this invocation to a specific worker
delta-forge-cli --compute-url http://worker-01.internal:3031 query SELECT 1# Set via env var for the shell session
DF_COMPUTE_URL=http://worker-01.internal:3031 delta-forge-cli# Pin compute while keeping the profile's control URL
delta-forge-cli --profile production --compute-url http://isolated-node.internal:3031 run bench.sql# Reproduce a worker-specific bug by pinning compute and using JSON output
delta-forge-cli --compute-url http://worker-debug.internal:3031 --format json query 'SELECT * FROM issue_42_repro'