dune skill: document the matview command group#11
Conversation
Documents the new `dune matview` (alias `mv`) CLI commands in the dune skill: - New references/matview-management.md covering create/get/list/update/refresh/delete, the bare-vs-fully-qualified name distinction, refresh-schedule semantics, the read-modify-write update behavior, and a full lifecycle workflow. - SKILL.md: added matview to the description/triggers, the command overview table, the write-command confirmation list (noting create/update/refresh consume credits and delete is irreversible), and the reference-documents table. Follows the duneapi-client-go v0.5.0 matview methods and the CLI matview command group (duneanalytics/cli#61).
PR SummaryLow Risk Overview
Reviewed by Cursor Bugbot for commit 151f871. Configure here. |
|
bugbot run |
![cursor[bot]](https://avatars.githubusercontent.com/in/1210556?s=60&v=4){kind=small}
There was a problem hiding this comment.
✅ Bugbot reviewed your changes and found no new issues!
Comment @cursor review or bugbot run to trigger another review on this PR
Reviewed by Cursor Bugbot for commit 151f871. Configure here.
| ### Output | ||
|
|
||
| - **text**: `Refreshing materialized view <fully-qualified-name>` + the execution ID and a results hint. | ||
| - **json**: `{"sql_id": "<fully-qualified-name>", "execution_id": "<id>"}` |
There was a problem hiding this comment.
Note: the JSON key is sql_id here, not name as in create/update — use .sql_id when capturing the name for subsequent calls
| ### Tips | ||
|
|
||
| - `create` is **create-or-replace**: if a matview with this name already exists for the same query it is re-run. To change settings on an existing matview, use `dune matview update`. | ||
| - Matviews are public by default; `--private` requires a supporting plan. |
There was a problem hiding this comment.
nit: Duplicates the --private flag description above — remove this line.
|
|
||
| ### Tips | ||
|
|
||
| - `create` is **create-or-replace**: if a matview with this name already exists for the same query it is re-run. To change settings on an existing matview, use `dune matview update`. |
There was a problem hiding this comment.
What happens if the name exists but with a different --query-id? "for the same query" implies different behavior in that case but it's not documented — either clarify or drop the qualifier.
3 participants
Documents the new
dune matview(aliasmv) CLI commands in the dune skill.Changes
skills/dune/references/matview-management.md— reference doc forcreate,get,list,update,refresh,delete, matching the style of the existing reference docs. Covers the bare-vs-fully-qualified name distinction, refresh-schedule semantics (cron min 15 min), the read-modify-writeupdatebehavior (schedule preserved unless changed), create-or-replace semantics, and a full lifecycle workflow.SKILL.md— added matview to the frontmatter description/triggers, the command overview table, the write-command confirmation list (noting create/update/refresh consume credits and delete is irreversible), and the reference-documents table.Context
Follows the matview rollout: duneapi REST endpoints (merged), duneapi-client-go v0.5.0 (matview client methods), and the CLI
dune matviewcommand group (duneanalytics/cli#61).