Skip to content

Commit 8e69f1f

Browse files
committed
docs(skills): document query truncation auto-follow and 429 retry
1 parent 6d31620 commit 8e69f1f

1 file changed

Lines changed: 2 additions & 0 deletions

File tree

skills/hotdata/SKILL.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -323,6 +323,8 @@ hotdata query status <query_run_id> [--output table|json|csv]
323323
- Use `hotdata tables list` for discovery — not `information_schema` via `query`.
324324
- **PostgreSQL dialect.** Quote non-lowercase columns with double quotes.
325325
- Async runs return `query_run_id` → poll with `query status` (do not re-run the same heavy SQL).
326+
- **Large results are complete, not a preview.** The server returns inline rows only up to a bounded cap and persists the full set out-of-band; `hotdata query` transparently fetches the full result, so the printed rows and row count are the complete set. (If the full result can't be retrieved, the CLI prints the preview and a `warning:` to stderr.)
327+
- **Backpressure is handled.** Under heavy concurrent load the server may shed a query with HTTP 429 (`OVERLOADED`); the CLI auto-retries (honoring `Retry-After`) before surfacing an error — no manual retry needed.
326328
- **OLAP** (aggregations, history, Chain, sorted indexes): **`hotdata-analytics`** skill.
327329
- **Search** (BM25, vector): **`hotdata-search`** skill.
328330

0 commit comments

Comments
 (0)