Skip to content

Commit 0123437

Browse files
fabriziomellobilly-the-fish
authored andcommitted
fix: Remove deprecated old-format CAggs information (#3989)
1 parent 0ab0e8c commit 0123437

File tree

3 files changed

+8
-31
lines changed

3 files changed

+8
-31
lines changed

use-timescale/continuous-aggregates/about-continuous-aggregates.md

Lines changed: 7 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -212,30 +212,22 @@ Continuous aggregates consist of:
212212
### Materialization hypertable
213213

214214
Continuous aggregates take raw data from the original hypertable, aggregate it,
215-
and store the intermediate state in a materialization hypertable. When you query
216-
the continuous aggregate view, the state is returned to you as needed.
215+
and store the aggregated data in a materialization hypertable. When you query
216+
the continuous aggregate view, the aggregated data is returned to you as needed.
217217

218218
Using the same temperature example, the materialization table looks like this:
219219

220-
|day|location|chunk|avg temperature partial|
220+
|day|location|chunk|avg temperature|
221221
|-|-|-|-|
222-
|2021/01/01|New York|1|{3, 219}|
223-
|2021/01/01|Stockholm|1|{4, 280}|
222+
|2021/01/01|New York|1|73|
223+
|2021/01/01|Stockholm|1|70|
224224
|2021/01/02|New York|2||
225-
|2021/01/02|Stockholm|2|{5, 345}|
225+
|2021/01/02|Stockholm|2|69|
226226

227227
The materialization table is stored as a Timescale hypertable, to take
228228
advantage of the scaling and query optimizations that hypertables offer.
229229
Materialization tables contain a column for each group-by clause in the query,
230-
a `chunk` column identifying which chunk in the raw data this entry came from,
231-
and a `partial aggregate` column for each aggregate in the query.
232-
233-
The partial column is used internally to calculate the output. In this example,
234-
because the query looks for an average, the partial column contains the number
235-
of rows seen, and the sum of all their values. The most important thing to know
236-
about partials is that they can be combined to create new partials spanning all
237-
of the old partials' rows. This is important if you combine groups that span
238-
multiple chunks.
230+
and an `aggregate` column for each aggregate in the query.
239231

240232
For more information, see [materialization hypertables][cagg-mat-hypertables].
241233

@@ -248,13 +240,6 @@ unblocks other transactions, and materializes the aggregates. The first
248240
transaction is very quick, and most of the work happens during the second
249241
transaction, to ensure that the work does not interfere with other operations.
250242

251-
When you query the continuous aggregate view, the materialization engine
252-
combines the aggregate partials into a single partial for each time range, and
253-
calculates the value that is returned. For example, to compute an average, each
254-
partial sum is added up to a total sum, and each partial count is added up to a
255-
total count, then the average is computed as the total sum divided by the total
256-
count.
257-
258243
### Invalidation engine
259244

260245
Any change to the data in a hypertable could potentially invalidate some

use-timescale/continuous-aggregates/create-a-continuous-aggregate.md

Lines changed: 0 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -75,14 +75,6 @@ the hypertable. The time bucket allows you to define a time interval, instead of
7575
having to use specific timestamps. For example, you can define a time bucket as
7676
five minutes, or one day.
7777

78-
When the continuous aggregate is materialized, the materialization table stores
79-
partials, which are then used to calculate the result of the query. This means a
80-
certain amount of processing capacity is required for any query, and the amount
81-
required becomes greater as the interval gets smaller. Because of this, if you
82-
have very small intervals, it can be more efficient to run the aggregate query
83-
on the raw data in the hypertable. You should test both methods to determine
84-
what is best for your dataset and desired bucket interval.
85-
8678
You can't use [time_bucket_gapfill][api-time-bucket-gapfill] directly in a
8779
continuous aggregate. This is because you need access to previous data to
8880
determine the gapfill content, which isn't yet available when you create the

use-timescale/continuous-aggregates/materialized-hypertables.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ tags: [materialized views]
99
# Materialized hypertables
1010

1111
Continuous aggregates take raw data from the original hypertable, aggregate it,
12-
and store the intermediate state in a materialization hypertable. You can modify
12+
and store the aggregated data in a materialization hypertable. You can modify
1313
this materialized hypertable in the same way as any other hypertable.
1414

1515
## Discover the name of a materialized hypertable

0 commit comments

Comments
 (0)