Skip to content

Commit 6d508f7

Browse files
authored
on-fly mutations → on-the-fly mutations
1 parent 8ed5225 commit 6d508f7

File tree

1 file changed

+11
-11
lines changed

1 file changed

+11
-11
lines changed

docs/guides/developer/lightweight-update.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
11
---
22
slug: /guides/developer/lightweight-update
3-
sidebar_label: 'On-fly Mutation'
4-
title: 'On-fly Mutations'
5-
keywords: ['On-fly mutation']
6-
description: 'Provides a description of on-fly mutations'
3+
sidebar_label: 'On-the-fly mutation'
4+
title: 'On-the-fly Mutations'
5+
keywords: ['On-the-fly mutation']
6+
description: 'Provides a description of on-the-fly mutations'
77
---
88

9-
## On-fly mutation {#lightweight-update}
9+
## On-the-fly mutations {#lightweight-update}
1010

11-
When on-fly mutations are enabled, updated rows are marked as updated immediately and subsequent `SELECT` queries will automatically return with the changed values. When on-fly mutations are not enabled, you may have to wait for your mutations to be applied via a background process to see the changed values.
11+
When on-the-fly mutations are enabled, updated rows are marked as updated immediately and subsequent `SELECT` queries will automatically return with the changed values. When on-the-fly mutations are not enabled, you may have to wait for your mutations to be applied via a background process to see the changed values.
1212

13-
On-fly mutations can be enabled for `MergeTree`-family tables by enabling the query-level setting `apply_mutations_on_fly`.
13+
On-the-fly mutations can be enabled for `MergeTree`-family tables by enabling the query-level setting `apply_mutations_on_fly`.
1414

1515
```sql
1616
SET apply_mutations_on_fly = 1;
@@ -56,10 +56,10 @@ Note that the values of the rows have not yet been updated when we query the new
5656
└────┴───┘
5757
```
5858

59-
Let's now see what happens when we enable on-fly mutations:
59+
Let's now see what happens when we enable on-the-fly mutations:
6060

6161
```sql
62-
-- Enable on-fly mutations
62+
-- Enable on-the-fly mutations
6363
SET apply_mutations_on_fly = 1;
6464

6565
SELECT id, v FROM test_on_fly_mutations ORDER BY id;
@@ -75,15 +75,15 @@ The `SELECT` query now returns the correct result immediately, without having to
7575

7676
## Performance impact {#performance-impact}
7777

78-
When on-fly mutations are enabled, mutations are not materialized immediately but will only be applied during `SELECT` queries. However, please note that mutations are still being materialized asynchronously in the background, which is a heavy process.
78+
When on-the-fly mutations are enabled, mutations are not materialized immediately but will only be applied during `SELECT` queries. However, please note that mutations are still being materialized asynchronously in the background, which is a heavy process.
7979

8080
If the number of submitted mutations constantly exceeds the number of mutations that are processed in the background over some time interval, the queue of unmaterialized mutations that have to be applied will continue to grow. This will result in the eventual degradation of `SELECT` query performance.
8181

8282
We suggest enabling the setting `apply_mutations_on_fly` together with other `MergeTree`-level settings such as `number_of_mutations_to_throw` and `number_of_mutations_to_delay` to restrict the infinite growth of unmaterialized mutations.
8383

8484
## Support for subqueries and non-deterministic functions {#support-for-subqueries-and-non-deterministic-functions}
8585

86-
On-fly mutations have limited support with subqueries and non-deterministic functions. Only scalar subqueries with a result that have a reasonable size (controlled by the setting `mutations_max_literal_size_to_replace`) are supported. Only constant non-deterministic functions are supported (e.g. the function `now()`).
86+
On-the-fly mutations have limited support with subqueries and non-deterministic functions. Only scalar subqueries with a result that have a reasonable size (controlled by the setting `mutations_max_literal_size_to_replace`) are supported. Only constant non-deterministic functions are supported (e.g. the function `now()`).
8787

8888
These behaviours are controlled by the following settings:
8989

0 commit comments

Comments
 (0)