docs: split Query from Job, and fold the agent tutorial into Agentic Skills

Query and Job were one page because they share the _async convention, but they
are different things: a query returns rows and streams them, a job returns an
outcome you wait for. Two pages now, query first, each carrying a short pointer
to the other rather than the shared framing.

Agentic Skills absorbs the agent plugin tutorial, which was a separate page in
Use Cases describing the same plugin in more detail -- the two had diverged, with
the tutorial carrying the fuller install instructions. It also moves to Getting
Started: installing the plugin is something you do before writing anything, not
a concept to understand.
This commit is contained in:
Jack Ye
2026-09-25 15:40:49 -07:00
parent 70c10e4aa4
commit c9275e077b
11 changed files with 369 additions and 418 deletions
+1 -1
View File
@@ -30,7 +30,7 @@ Queries execute on the server and results come back as Arrow record batches --
nothing is converted to pandas or Python objects unless you ask. `execute_query`
hands back a reader as soon as the first batch is ready rather than when the
query finishes, so a large result set does not have to fit in memory before you
start reading it. See [Query and job](/basics/jobs#queries).
start reading it. See [Queries](/basics/query).
Served over an [Arrow Flight SQL](https://arrow.apache.org/docs/format/FlightSql.html)
endpoint, so any Flight SQL client reaches it.
+1 -1
View File
@@ -49,7 +49,7 @@ SHOW JOBS
```
Every job the server knows about — id, type, state, creation time. The SQL
counterpart of `list_jobs`; see [Query and job](/basics/jobs).
counterpart of `list_jobs`; see [Jobs](/basics/jobs).
## SHOW ERRORS {#errors}