v0.1.1
Wrapper fixes from a real chproxy-fronted production debugging session, plus docs for the proxy/fleet realities it surfaced. No methodology changes.
Fixed
chq.shpassed settings in the POST body, parsed as raw SQL →Code: 62 ... Syntax error at position 29 (&). Settings now ride in the URL viacurl -G.readonly=1was sent unconditionally, rejected by read-only accounts →Code: 164 ... Cannot modify 'readonly' setting in readonly mode. Now opt-in viaCH_READONLY.result_overflow_mode=breakcollided with the query cache →Code: 731. Wrapper now always sendsuse_query_cache=0.- Arg parsing assumed a TTY (
[ -t 0 ]), ignoring the SQL arg under the Bash tool →Code: 62 ... Empty query. Now prefers$1/-f, falls back to stdin.
Added
- Heavy-read override path +
clusterAllReplicas()fan-out caution (Code: 307). - "Single node vs. proxy-fronted fleet" guidance (
clusterAllReplicas()+hostName()). - Metric-name discovery via
__name__regex instead of dumping the label catalog.
Full changelog: https://github.com/Kryst4lskyxx/clickhouse-debug-skills/blob/main/CHANGELOG.md