Skip to content

Commit dee7e30

Browse files
authored
Refresh CAGG page (#4415)
1 parent 09b459c commit dee7e30

File tree

4 files changed

+24
-28
lines changed

4 files changed

+24
-28
lines changed

_partials/_caggs-function-support.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,19 @@
11

22
The following table summarizes the aggregate functions supported in continuous aggregates:
33

4-
|Function, clause, or feature|TimescaleDB 2.6 and earlier|TimescaleDB 2.7, 2.8, and 2.9|TimescaleDB 2.10 and later|
5-
|-|-|-|-|
6-
|Parallelizable aggregate functions||||
7-
|[non-parallelizable SQL aggregates][postgres-parallel-agg]||||
8-
|`ORDER BY`||||
9-
|Ordered-set aggregates||||
10-
|Hypothetical-set aggregates||||
11-
|`DISTINCT` in aggregate functions||||
12-
|`FILTER` in aggregate functions||||
13-
|`FROM` clause supports `JOINS`||||
4+
| Function, clause, or feature |TimescaleDB 2.6 and earlier|TimescaleDB 2.7, 2.8, and 2.9|TimescaleDB 2.10 and later|
5+
|------------------------------------------------------------|-|-|-|
6+
| Parallelizable aggregate functions ||||
7+
| [Non-parallelizable SQL aggregates][postgres-parallel-agg] ||||
8+
| `ORDER BY` ||||
9+
| Ordered-set aggregates ||||
10+
| Hypothetical-set aggregates ||||
11+
| `DISTINCT` in aggregate functions ||||
12+
| `FILTER` in aggregate functions ||||
13+
| `FROM` clause supports `JOINS` ||||
1414

1515

16-
DISTINCT works in aggregate functions not in the query definition. For example, for the table:
16+
DISTINCT works in aggregate functions, not in the query definition. For example, for the table:
1717

1818
```sql
1919
CREATE TABLE public.candle(

_partials/_caggs-intro.md

Lines changed: 8 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,30 +1,26 @@
11
import RealTimeAgg from 'versionContent/_partials/_real-time-aggregates.mdx';
22

33
In modern applications, data usually grows very quickly. This means that aggregating
4-
it into useful summaries can become very slow. Continuous aggregates in $TIMESCALE_DB make
5-
aggregating data lightning fast, accurate, and easy.
6-
7-
If you are collecting data very frequently, you might want to aggregate your
8-
data into minutes or hours instead. For example, if an IoT device takes
4+
it into useful summaries can become very slow. If you are collecting data very frequently, you might want to aggregate your
5+
data into minutes or hours instead. For example, if an IoT device takes
96
temperature readings every second, you might want to find the average temperature
107
for each hour. Every time you run this query, the database needs to scan the
11-
entire table and recalculate the average.
8+
entire table and recalculate the average. $TIMESCALE_DB makes aggregating data lightning fast, accurate, and easy.
9+
10+
![Reduced data calls with $CAGGs](https://assets.timescale.com/docs/images/continuous-aggregate.png)
1211

13-
Continuous aggregates are a kind of hypertable that is refreshed automatically
12+
Continuous aggregates in $TIMESCALE_DB are a kind of hypertable that is refreshed automatically
1413
in the background as new data is added, or old data is modified. Changes to your
1514
dataset are tracked, and the hypertable behind the continuous aggregate is
1615
automatically updated in the background.
1716

18-
You don't need to manually refresh your continuous aggregates, they are
19-
continuously and incrementally updated in the background. Continuous aggregates
20-
also have a much lower maintenance burden than regular $PG materialized
17+
Continuous aggregates have a much lower maintenance burden than regular $PG materialized
2118
views, because the whole view is not created from scratch on each refresh. This
2219
means that you can get on with working your data instead of maintaining your
2320
database.
2421

25-
2622
Because continuous aggregates are based on hypertables, you can query them in exactly the same way as your other tables. This includes continuous aggregates in the rowstore, compressed into the [columnstore][hypercore],
27-
or [tiered to object storage][data-tiering]. You can even create [continuous aggregates on top of your continuous aggregates][hierarchical-caggs] - for an even more fine-tuned aggregation.
23+
or [tiered to object storage][data-tiering]. You can even create [continuous aggregates on top of your continuous aggregates][hierarchical-caggs], for an even more fine-tuned aggregation.
2824

2925
[Real-time aggregation][real-time-aggregation] enables you to combine pre-aggregated data from the materialized view with the most recent raw data. This gives you up-to-date results on every query. <RealTimeAgg />
3026

getting-started/try-key-features-timescale-products.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -219,7 +219,7 @@ $CAGG_CAPs are a kind of $HYPERTABLE that is refreshed automatically in
219219
the background as new data is added, or old data is modified. Changes to your dataset are tracked,
220220
and the $HYPERTABLE behind the $CAGG is automatically updated in the background.
221221

222-
![Reduced data calls with $CAGGs](https://assets.timescale.com/docs/images/continuous-aggregate.png )
222+
![Reduced data calls with $CAGGs](https://assets.timescale.com/docs/images/continuous-aggregate.png)
223223

224224
You create $CAGGs on uncompressed data in high-performance storage. They continue to work
225225
on [data in the $COLUMNSTORE][test-drive-enable-compression]

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

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ JOINS in TimescaleDB must meet the following conditions:
5252
* You can use an `INNER`, `LEFT`, and `LATERAL` joins; no other join type is supported.
5353
* Joins on the materialized hypertable of a continuous aggregate are not supported.
5454
* Hierarchical continuous aggregates can be created on top of a continuous
55-
aggregate with a `JOIN` clause, but cannot themselves have a `JOIN` clauses.
55+
aggregate with a `JOIN` clause, but cannot themselves have a `JOIN` clause.
5656

5757
### JOIN examples
5858

@@ -141,7 +141,7 @@ See the following `JOIN` examples on continuous aggregates:
141141
```
142142
TimescaleDB v2.16.x and higher.
143143

144-
- `INNER JOIN` between an hypertable and multiple $PG tables:
144+
- `INNER JOIN` between a hypertable and multiple $PG tables:
145145

146146
```sql
147147
CREATE MATERIALIZED VIEW conditions_by_day WITH (timescaledb.continuous) AS
@@ -154,7 +154,7 @@ See the following `JOIN` examples on continuous aggregates:
154154
```
155155
TimescaleDB v2.16.x and higher.
156156

157-
- `LEFT JOIN` between an hypertable and a $PG table:
157+
- `LEFT JOIN` between a hypertable and a $PG table:
158158

159159
```sql
160160
CREATE MATERIALIZED VIEW conditions_by_day WITH (timescaledb.continuous) AS
@@ -166,7 +166,7 @@ See the following `JOIN` examples on continuous aggregates:
166166
```
167167
TimescaleDB v2.16.x and higher.
168168

169-
- `LATERAL JOIN` between an hypertable and a sub-query:
169+
- `LATERAL JOIN` between a hypertable and a subquery:
170170

171171
```sql
172172
CREATE MATERIALIZED VIEW conditions_by_day WITH (timescaledb.continuous) AS

0 commit comments

Comments
 (0)