mirror of
https://github.com/lancedb/lancedb.git
synced 2026-10-13 15:22:30 +00:00
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:
@@ -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>
|
||||
|
||||
@@ -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>
|
||||
|
||||
|
||||
Reference in New Issue
Block a user