docs: leave a deployment's materialized view refresh mode to its version

Sophon main now refreshes an eligible materialized view incrementally,
appending what an append-only source added since the last refresh, a day
after the change that made every refresh a full rebuild. So the
materialized view page and the REFRESH reference no longer say recent
versions rebuild in full: they say recent versions run views as SQL jobs,
need no stable row ids and take no refresh options, and that a full or
incremental refresh depends on the version and the view's query. COPY is
described with the same "recent versions" wording.
This commit is contained in:
Brendan Clement
2026-10-08 21:42:20 -07:00
parent 34bfd03f4c
commit eedde82253
4 changed files with 16 additions and 14 deletions
+1 -1
View File
@@ -7,7 +7,7 @@ keywords: ["copy", "export", "parquet", "sql"]
---
<Warning>
Newer deployment versions refuse `COPY` over the SQL endpoint with "COPY is not
Recent deployment versions refuse `COPY` over the SQL endpoint with "COPY is not
supported". On those, export a result by reading it through a Flight SQL client
or an SDK and writing the files from your application.
</Warning>
+4 -3
View File
@@ -71,13 +71,14 @@ REFRESH MATERIALIZED VIEW chunks WITH (full = true)
On earlier deployment versions, `full = true` asks for every row to be
recomputed, and without it a refresh can reconcile only what changed in the
source. Newer versions rebuild the whole view on every refresh, as every local
SDK refresh does, and refuse `WITH` options.
source. Recent versions refuse `WITH` options; whether their refresh rebuilds
the whole view, as every local SDK refresh does, or adds only what changed
depends on the version and on the view's query.
<Warning>
`CASCADE` asks for the views this one is built on to be refreshed first, in
dependency order. Whether a deployment carries it out depends on its version,
and newer versions refuse it; where it is refused, refresh each view yourself,
and recent versions refuse it; where it is refused, refresh each view yourself,
its sources first.
</Warning>