Skip to content

Commit 51113e2

Browse files
kuiliu88jovezhong
andauthored
Update enterprise-v2.7.md for v2.7.6 (#301)
* Update enterprise-v2.7.md for v2.7.6 * Update release-downloads.md * use s3 datetime for release date; remove curl cmd for 2.7.5 * add doc for mv_preferred_exec_node; past tense for changelog * reorder 2.7.6 changelog, feature first, then bugfix, also mention EMIT syntax are changed --------- Co-authored-by: Jove Zhong <jove@timeplus.io>
1 parent 2c7b051 commit 51113e2

File tree

3 files changed

+63
-1
lines changed

3 files changed

+63
-1
lines changed

docs/enterprise-v2.7.md

Lines changed: 30 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,9 +34,38 @@ Key highlights of this release:
3434
3. For Kubernetes users, please follow [the guide](/k8s-helm#v5-to-v6) carefully since a few timeplusd built-in users are removed in the new helm chart, and you can configure ingress for Appserver and Timeplusd independently.
3535

3636
## Releases
37+
### 2.7.6 {#2_7_6}
38+
Released on 04-29-2025. Installation options:
39+
* For Linux or Mac users: `curl https://install.timeplus.com/2.7 | sh` [Downloads](/release-downloads#2_7_6)
40+
* For Kubernetes users: `helm install timeplus/timeplus-enterprise --version v6.0.11 ..`
41+
* For Docker users (not recommended for production): `docker run -p 8000:8000 docker.timeplus.com/timeplus/timeplus-enterprise:2.7.6`
42+
43+
Component versions:
44+
* timeplusd 2.7.45
45+
* timeplus_web 2.2.12
46+
* timeplus_appserver 2.2.13
47+
* timeplus_connector 2.2.8
48+
* timeplus cli 1.2.12
49+
50+
#### Changelog {#changelog_2_7_6}
51+
52+
Compared to the [2.7.5](#2_7_5) release:
53+
* timeplusd 2.7.37 -> 2.7.45
54+
* added new setting [mv_preferred_exec_node](/sql-create-materialized-view#mv_preferred_exec_node) while creating materialized view
55+
* added new EMIT policy `EMIT ON UPDATE WITH DELAY`. The SQL syntax for EMIT has been refactored. [Learn more](/query-syntax#emit)
56+
* fixed global aggregation with `EMIT ON UPDATE` in multi-shard environments
57+
* fixed concurrency issues in hybrid aggregation
58+
* support incremental checkpoints for hybrid hash join
59+
* fixed grouping key issues in hybrid aggregation
60+
61+
#### Known issues {#known_issue_2_7_6}
62+
1. Pulsar external stream functionality is limited to Linux bare metal builds and Linux-based Docker images, excluding macOS bare metal builds.
63+
1. The `timeplus_connector` component may experience health issues on Ubuntu Linux with x86_64 chips, affecting Redpanda Connect functionality. This issue is specific to Ubuntu and does not affect other Linux distributions.
64+
1. Python UDF support is limited to Linux x86_64 bare metal and Linux x86_64 Docker image, excluding macOS or ARM builds.
65+
3766
### 2.7.5 {#2_7_5}
3867
Released on 04-14-2025. Installation options:
39-
* For Linux or Mac users: `curl https://install.timeplus.com/2.7 | sh` [Downloads](/release-downloads#2_7_4)
68+
* For Linux or Mac users: [Downloads](/release-downloads#2_7_4)
4069
* For Kubernetes users: `helm install timeplus/timeplus-enterprise --version v6.0.9 ..`
4170
* For Docker users (not recommended for production): `docker run -p 8000:8000 docker.timeplus.com/timeplus/timeplus-enterprise:2.7.5`
4271

docs/release-downloads.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,12 @@ Released on 03-24-2025 ([Change logs](/enterprise-v2.8#2_8_0)).
1010

1111
## 2.7 {#2_7}
1212

13+
### v2.7.6 {#2_7_6}
14+
Released on 04-29-2025 ([Change logs](/enterprise-v2.7#2_7_6)).
15+
16+
* Bare metal installation: [Linux x86_64](https://d.timeplus.com/timeplus-enterprise-v2.7.6-linux-amd64.tar.gz) | [Linux ARM64](https://d.timeplus.com/timeplus-enterprise-v2.7.6-linux-arm64.tar.gz) | [macOS x86_64](https://d.timeplus.com/timeplus-enterprise-v2.7.6-darwin-amd64.tar.gz) | [macOS ARM64](https://d.timeplus.com/timeplus-enterprise-v2.7.6-darwin-arm64.tar.gz)
17+
* All-in-one Docker image (not recommended for production): `docker run -p 8000:8000 docker.timeplus.com/timeplus/timeplus-enterprise:2.7.6`
18+
1319
### v2.7.5 {#2_7_5}
1420
Released on 04-14-2025 ([Change logs](/enterprise-v2.7#2_7_5)).
1521

docs/sql-create-materialized-view.md

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -56,3 +56,30 @@ SETTINGS <settings>
5656
```
5757
### pause_on_start
5858
By default, once the materialized view is created, the streaming query will start automatically. If you don't want to start the query immediately, you can set `pause_on_start=true`. The default value is `false`.
59+
60+
### memory_weight
61+
62+
Starting from [Timeplus Enterprise v2.3](/enterprise-v2.3), when you create a materialized view with DDL SQL, you can add an optional `memory_weight` setting for those memory-consuming materialized views, e.g.
63+
```sql
64+
CREATE MATERIALIZED VIEW my_mv
65+
SETTINGS memory_weight = 10
66+
AS SELECT ..
67+
```
68+
69+
When `memory_weight` is not set, by default the value is 0. When Timeplus Enterprise server starts, the system will list all materialized views, ordered by the memory weight and view names, and schedule them in the proper node.
70+
71+
For example, in a 3-node cluster, you define 10 materialized views with names: mv1, mv2, .., mv9, mv10. If you create the first 6 materialized views with `SETTINGS memory_weight = 10`, then node1 will run mv1 and mv4; node2 will run mv2 and mv5; node3 will run mv3 and mv6; Other materialized views(mv7 to mv10) will be randomly scheduled on any nodes.
72+
73+
It's recommended that each node in the Timeplus Enterprise cluster shares the same hardware specifications. For those resource-consuming materialized views, it's recommended to set the same `memory_weight`, such as 10, to get the expected behaviors to be dispatched to the proper nodes for load-balancing.
74+
75+
### mv_preferred_exec_node
76+
77+
Starting from [Timeplus Enterprise v2.7.6](/enterprise-v2.7#2_7_6), when you create a materialized view with DDL SQL, you can add an optional `mv_preferred_exec_node` setting to explicitly assign a node to run the materialized view.
78+
79+
```sql
80+
CREATE MATERIALIZED VIEW my_mv
81+
SETTINGS mv_preferred_exec_node=3
82+
AS SELECT ..
83+
```
84+
85+
In most cases, you don't need to specify this setting. Timeplus will automatically select an available node to run the materialized view. It's also recommended to set [memory_weight](#memory_weight) to have the system to automatically choose the appropriate node for load balancing. If you need to fine-tune the load balancing or resource utilization, you can specify this setting. As a result, load balancing or failover won't be available when this is set. You cannot change the value after the materialized view is created, even the node is having issue. In this case, please drop and re-create the materialized view with new node ID.

0 commit comments

Comments
 (0)